• 製品
  • 使用を開始する
  • 関連ドキュメント
  • リソース

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

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

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

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

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

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

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

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

プレースホルダーの構造

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

構文

${Name of placeholder}

または

${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 の Insight にデータをインポートする際に使用できます。インポート時のプレースホルダーの使用方法に関する詳細

プレースホルダー名

Data locator

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

プレースホルダーは、IQL の一部として使用されます。 

自動化

Jira Service Management の Insight に関する詳細。

プレースホルダー名

説明

属性名

属性値

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

Attribute Name.id

格納された属性値

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

ラベル

オブジェクトのラベル

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

objectType

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

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

objectTypeId

オブジェクト タイプ ID

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

objectId

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

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

鍵 (キー)

オブジェクトのキー

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

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

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

 

プレースホルダー名

説明

属性名

属性値

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

Attribute Name.id

格納された属性値

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

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

この設定方法を示すビデオをご覧ください: オブジェクトの作成時にプレースホルダーを使用する

Insight オブジェクト フィールドの設定画面にあるフィルター スコープ (IQL) フィールドでは、プレースホルダーを使用できません。

 

最終更新日 2021年09月29日)
次でキャッシュ 9:00 AM on Oct 20, 2021 |

その他のヘルプ