• 使用を開始する
  • 関連ドキュメント

プレースホルダを使用して、コンテキストに応じて情報を置き換える

Jira Service Managementアセットでは、さまざまなプレースホルダーをサポートしています。これによって、コンテキストに応じて、特定のプレースホルダーを課題フィールド値、アセット オブジェクト属性値、またはその他のアセット関連情報から動的に置き換えられます。

プレースホルダーを使用するタイミングとその理由

次は、プレースホルダーが役立つ場合を示すいくつかのユースケースです。 

ライセンスの有効期限が近づいたときに、その特定のライセンスの名前終了日を記載したメールを受信します。

課題が特定のステータスに移動したときに、課題フィールドのでオブジェクト属性を設定/更新します。

これら 2 つのユースケースで共通しているのは、「値がどこにあるか」を知ることであり、構成を設定する時点でその特定の値が何になるかではありません。これが、必要な時に「必要な値を探す」プレースホルダーを使用するタイミングと理由です。  

プレースホルダーは、アクションを設定するときに使用するものであり、必要な値はランタイムのコンテキストに依存します。つまり、アクションをトリガーするオブジェクトがわからなければ、値はわかりません。 

プレースホルダーの構造

プレースホルダーは次のように構成されます。

構文

${Name of placeholder}

or

${Name of placeholder${Number}}

これらの複数の構造は、さまざまな構成が可能です。次の表では、これらの構造の使用方法について説明します。

プレースホルダー

動作

プレースホルダーの例

値に置き換える

${Name of placeholder}

${Name of placeholder} のコンテンツをプレースホルダーの名前と一致する値に置き換えます。

${Name}

1 つのオブジェクト

${email}

myemail@fakse.se,anotheremail@fakse.se

${Name of placeholder${0}}

${Name of placeholder${0}} のコンテンツを、プレースホルダーの名前と一致するすべての値と置き換えます。これは、複数のカーディナリティを持つ属性を設定するとき場合など、複数の値を一致させるために使用され、すべての値はその属性の 1 つのインスタンスになります。テキストとして置き換えた場合は上記の例に似ていて、複数の値のコンテキストで置き換えた場合はこの表記法によって複数の値がレンダリングされますが、上記の場合は 1 つの値をカンマ区切り文字列としてレンダリングします。

${Price${0}}

12

${Email${0}}

myemail@fakse.se,anotheremail@fakse.se

${Name of placeholder${1}}

${Name of placeholder${1}} のコンテンツをプレースホルダーの名前と一致する最初の値に置き換えます。これは、最初の値のみが必要な場合に使用されます

${Price${1}}

12

${Email${1}}

myemail@fake.se

${Name of placeholder${n}}

${Name of placeholder${n}} のコンテンツを、プレースホルダーの名前と一致する n: 番目の値に置き換えます。これは、n: 番目の値のみが必要な場合に使用されます

${Price${2}}

<空の値>

${Email${2}}

anotheremail@fakse.se

${Email${4}}

<空の値>

プレースホルダーのコンテキスト

プレースホルダーは複数の値を指定できる場合があります。その場合は、プレースホルダー ${Name of placeholder${i}} を使用できます。

最も一般的な構成は ${Name of placeholder${0}} であり、次のように、プレースホルダーで指定するすべての値をカンマ区切りリストでレンダリングします。

Attribute IN ( ${Name of placeholder${0}} )

また、${Name of placeholder${1}} を使用して、最初の値のみを取得できます。

 

インポート

また、Jira Service Managementアセットにデータをインポートする際に、プレースホルダーを使用できます。インポート時におけるプレースホルダーの使用方法に関する詳細についてご確認ください。

プレースホルダー名

Data locator

データ ロケーターからの外部データ ソースで見つかった値

プレースホルダーは AQL (アセット クエリ言語) の一部として使用されます。

自動化

Jira Service Management にあるアセットの自動化に関する詳細を確認してください。

プレースホルダー名

説明

属性名

属性値

プレースホルダーと同じ名前の属性の値。これによって、人間が読み取れる形式で属性がレンダリングされます。

Attribute Name.id

格納された属性値

プレースホルダーと同じ名前の属性の値。これによって、格納された形式で属性がレンダリングされます。たとえば、属性がオブジェクト参照の場合は、参照されたオブジェクト ID がレンダリングされます。これは、提示された値とは別の値で格納された属性でのみ機能します。

ラベル

オブジェクトのラベル

値は、オブジェクトに設定されたラベルに置き換えられます。

objectType

オブジェクトのオブジェクト タイプ名

値はオブジェクト タイプ名で置き換えられます。

objectTypeId

オブジェクト タイプ ID

値は、現在のオブジェクトのオブジェクト タイプ ID に置き換えられます。

objectId

オブジェクト ID (キー以外)

このオブジェクトを識別する整数。

鍵 (キー)

オブジェクトのキー

現在のオブジェクトのキー値。

オブジェクトを作成/編集する

オブジェクト参照属性によってオブジェクトを作成するか編集する際は、オブジェクトの選択を制限するための AQL を指定できます。利用可能なプレースホルダーは、作成/編集ダイアログで使用できるすべての属性です。 

プレースホルダー名

説明

属性名

属性値

プレースホルダーと同じ名前の属性の値。これによって、人間が読める形式で属性がレンダリングされます

Attribute Name.id

格納された属性値

プレースホルダーと同じ名前の属性の値。これによって、格納された形式で属性がレンダリングされます。たとえば、属性がオブジェクト参照の場合、これは参照されるオブジェクトの ID になります。

AQL で使用されるプレースホルダーは常に構成の右側にある値であり、そのプレースホルダーは現在のオブジェクトの値で置き換えられますが、AQL はターゲット オブジェクト タイプから属性を参照していま