アセット オブジェクト カスタム フィールドを設定する
ユーザーがアセット オブジェクト カスタム フィールドを作成または編集するには、Jira ライセンスが必要です。
Display name is currently restricted to customers enrolled in the Beta trial of the Assets common data model. Some details may change before general availability.
アセット オブジェクト フィールド構成して、次の 3 つの方法で特定のオブジェクトを表示できます。
AQL used in Filter scope and Filter work scope resolves against the entity Name, not the Display name.
オブジェクト スキーマ: スキーマでオブジェクトをフィルタリングします。
フィルター スコープ (AQL): アセットの情報に基づいてオブジェクトをフィルタリングします。
作業スコープのフィルタリング (AQL): 現在の作業項目に基づいてオブジェクトをフィルタリングします。
オブジェクト スキーマ フィールド
オブジェクト スキーマ フィールドを使用して、このオブジェクト フィールドにリンクされているスキーマを選択します (必須)。フィルター スコープ (AQL) フィールドで別のスキーマのオブジェクトを選択した場合は、そのスキーマのオブジェクトのみが表示されます。
フィルター スコープ (AQL) フィールド
フィルター スコープ (AQL) フィールドを使用し、アセットの情報に基づいてアセット オブジェクトをフィルタリングします。このフィールドはオプションです。プレースホルダーは使用できません。
たとえば、製造元とノートパソコンのモデルを特定して表示するには、AQL クエリとして次を入力します。
objectType = "Laptop" AND Manufacturer = "Apple"
フィルター作業スコープ (AQL) フィールド
作業スコープのフィルタリング (AQL) (旧名称は課題スコープのフィルタリング) フィールドを使用して、アセット オブジェクト フィールドや Jira システム フィールドなどの作業項目自体の情報を使用してデータをフィルターします。
このフィールドでは検証が行われます。正しい AQL 構文にはチェック マークが付けられ、間違ったステートメントにはバツ マークが付けられます。
このフィールドはオプションです。カスタマー ポータルで [Display a default object (デフォルト オブジェクトを表示する)] を有効にすると、このフィールドにオブジェクトが自動で表示されます。
このフィールドではプレースホルダーを使用できます。プレースホルダーの詳細をご確認ください。
別のアセット オブジェクト フィールドを使用してフィルタリングする
作業スコープのフィルタリング (AQL) フィールドを使用して、作業項目内の別のオブジェクト フィールドを参照できます。これにより、あるリストのオプションが別のリストでの選択内容に依存するカスケード リストを作成できます。
たとえば、別のフィールドで選択した製造元に基づいてノートパソコン モデルを表示するには、次の手順に従います。
「製造元」という名前のアセット オブジェクト フィールドを作成し、フィルター スコープ (AQL) を次のように設定します。
objectType = “Manufacturer”「モデル」という名前の 2 つ目のアセット オブジェクト フィールドを作成し、フィルター作業スコープ (AQL) を次のように設定します。
objectType = “Laptop” AND Manufacturer = ${customfield_xxxxx.label}
ここで「xxxxx」は「製造元」フィールドのカスタム フィールド ID です。
「モデル」フィールドには、選択した製造元に対応するノートパソコンのみが表示されます。
フィルター作業スコープ (AQL) フィールドを使用するときは、カスタム フィールド名 (「製造元」など) ではなく、カスタム フィールド ID (例: customfield_xxxxx) を使用する必要があります。
なお、アセット オブジェクト フィールド内でフィルター スコープまたはフィルター作業スコープを使用すると、ORDER BY は無視されます。
システム フィールドを使用してフィルタリングする
作業スコープのフィルタリング (AQL) フィールドを使用して、担当者やプロジェクトなど、作業項目内からシステム フィールドを参照できます。
たとえば、現在の担当者が所有しているノートパソコンのリストを表示するには、フィルター作業スコープ (AQL) フィールドを次のように構成します。objectType = “Laptop” AND "Owner" LIKE ${assignee.label}
この場合、各ノートパソコン オブジェクトには、Jira 内の担当者の名前と一致する「所有者」の属性があります。
Jira フィールドは、複数の値または単一の値を保持できます。これらの値は、フィールドのラベルまたは ID を使用して参照できます。
たとえば、カスタム フィールドに「パン」、「クマ」、「じゃがいも」という 3 つの値がある場合、次のようになります。
(${customfield_1223.id${1}})は「パン」を返します。(${customfield_1223.id${3}})は「じゃがいも」を返します。(${customfield_1223.id${0}})は「パン」、「クマ」、および「じゃがいも」を返します。
Jira システム フィールドでは大文字と小文字が区別されるため、次の表に示されているとおり正確に入力する必要があります。
作業キー | ラベル/説明 | 複数 | タイプ | ${key.id} | ${key.label} |
|---|---|---|---|---|---|
assignee | 担当者 | false | ApplicationUser | ユーザー キー | 表示名 |
dueDate | 期限 | false | 日付 | dueDate | dueDate |
修正バージョン | 修正バージョン | true | 文字列/カスタム アセット オブジェクト | ID | 名前 |
issueType | 作業タイプ | false | 文字列/カスタム アセット オブジェクト | ID | 名前 |
コンポーネント | コンポーネント | true | 文字列/カスタム アセット オブジェクト | ID | 名前 |
priority | 優先度 | false | 文字列/カスタム アセット オブジェクト | ID | 名前 |
project | Project | false | 文字列/カスタム アセット オブジェクト | ID | 名前 |
reporter | 報告者 | false | ApplicationUser | ユーザー キー | 表示名 |
resolution | ソリューション | false | 文字列/カスタム アセット オブジェクト | ID | 名前 |
summary | 要約 | false | 文字列 | summary | summary |
アセットには、Data Center のアセットで利用できるシステム フィールド タイプは含まれていません。
システム フィールドを検索するには、次のいずれかを行う必要があります。
アセット オブジェクトを作成してこれらのフィールドをモデル化し (プロジェクト コンポーネントのアセット オブジェクト作成など)、それらを別のカスタム フィールドの値として設定します。
フィールド ラベルおよび/または ID を直接使用します。
複数の値を持つプレースホルダーを使用する
フィールドに複数の値が含まれている場合、プレースホルダーは単一値を返すか、一度にすべての値を返すことができます。
単一値を返すには、次のインデックスを使用します。
${customfield_xxxxx.id${1}}
すべての値を返すには、次のようなクエリを使用します。
objectId IN (${customfield_xxxxx.id${0}})または
Label IN (${customfield_xxxxx.label${0}})
この例で、「xxxxx」はカスタム フィールド ID を表します (例: 「製造元」カスタム フィールド)。
プレースホルダーは自動化フロー内ではサポートされていません。
さらに、テキストのカスタム フィールド タイプはプレースホルダーと併用できません。プレースホルダーは設定済みの値であり、動的に参照できないためです。
この内容はお役に立ちましたか?