ユーザー名をアカウント ID に変換する
The following guidelines outline how to convert user smart values and JQL to user account IDs, to address recent changes to how user data are handled within Jira Cloud.
ユーザー スマート バリューを変換する
2019 年 4 月 29 日以降の変更点
次のユーザー プロパティを使用するユーザー システム フィールド (報告者、担当者やカスタム フィールド) は、壊れたり、望ましくない結果につながったりする場合があります。
デフォルト値 (ユーザー名を返す):
{{reporter}}{{issue.assignee}}{{issue.My user custom field}}ユーザーを含むその他の課題フィールド
ユーザー キー:
{{reporter.key}}{{issue.watchers.key}}{{issue.My user custom field.key}}ユーザーを含むその他の課題フィールド
ユーザー名:
{{reporter.name}}{{issue.creator.name}}{{issue.My user custom field.name}}ユーザーを含むその他の課題フィールド
For example if you had configured an Add comment action with the following comment body:
Hi {{reporter.name}}, Please respond. Cheers Atlassian現時点では、実行時にユーザー名が変換され、次のような結果が表示されます。
Hi johns, Please respond. Cheers Atlassian2019 年 4 月 29 日を過ぎると、上記は以下のように表示されます。
Hi 557058:5aedf933-2312-40bc-b328-0c21314167f0, Please respond. Cheers Atlassianスマート バリューを変換する
ユーザー スマート バリューは次のように動作します。
以下の情報はすべてのユーザー フィールドに適用されます。
タイプ | 例 | 古い値 | 新しいアカウント ID 値 (4 月 29 日以降) |
|---|---|---|---|
既定 |
|
|
|
ユーザ名 |
|
|
|
ユーザー キー |
|
|
|
アカウント ID |
|
|
|
表示名 |
|
|
|
既存のスマート バリューの変換のされ方は、使用方法によって異なります。
ユーザー名の誤った使い方
スマート バリューにはユーザー名ではなくフルネームを使用します (デフォルト値または「.name」)。
これらは以下のように変更されます。
{{reporter.name}} - INCORRECT: This returns the user's username, not full name
{{reporter.displayName}} - CORRECT: renders the user's full name: John Smith
{{reporter.displayName.split(" ").first}} - CORRECT: renders the user's first name: JohnIf you need to uniquely identify the user for an API call, for example, in JQL searches, advanced JSON under More options, or an outgoing webhook, use:
{{reporter.accountId}}Wiki マークアップ中のメンション
Wiki マークアップでのメンションも以下のとおり変換します。
Hi [~{{assignee}}] - INCORRECT
Hi [~accountid:{{assignee.accountId}}] - CORRECT高度なフィールド値 (JSON)
ユーザー フィールド (報告者、担当者など) の参照には、「name」を使用するのではなく、ユーザーのアカウント ID とプロパティ「id」の設定が必要となりました。
上記の値は以下のとおり変換します。
// INCORRECT: This will stop working since {{initiator.name}} will no longer
return usernames
{
"fields": {
"assignee": { "name": "{{initiator.name}}" }
}
}// CORRECT:
{
"fields": {
"assignee": { "id": "{{initiator.accountId}}" }
}
}JQL の変換
2019 年 4 月 29 日以降の変更点
現在、ユーザー名を含む JQL を検索できます。以下はその一例です。
reporter = johns and assignee in (fred, barney)2019 年 4 月 29 日以降、これらの JQL 検索は機能しなくなるため、有効な結果を返しません。ユーザー名はすべて、対応するアカウント ID に置き換える必要があります。
JQL の変換
自動変換 JQL
保存済みの JQL 検索は、新規アカウント ID に基づくフォーマットに自動変換されます。
それに伴い、上記の例は次のようになります。
reporter = 557058:5aedf933-2312-40bc-b328-0c21314167f0 and
assignee in (5c00beb62434bf3a1a91d5d6, 123123adfafcadfd6)今後は、JQL 文字列からユーザーを特定することはできません。また、このようなクエリの入力は手間がかかります。
この問題には、JQL クエリの入力および読み取り時に、以下の操作を行うことで対応できます。
アカウント ID を挿入する
既存 JQL でユーザーを解決する
この内容はお役に立ちましたか?