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

Insight オブジェクト フィールドを設定する

Jira 課題を Insight オブジェクトに接続するには、Jira 管理者としてスキーマにアクセスして編集する権限を持っている必要があります。権限の詳細をご確認ください

Insight オブジェクト フィールドを使用すると、Jira Service Management で Insight オブジェクトを表示できます。Insight オブジェクト フィールドに表示するオブジェクトを選択するには、次の 3 つの方法でフィールドを構成できます。

  • オブジェクト スキーマを使用して、オブジェクト スキーマでオブジェクトをフィルタリングする

  • 範囲の絞り込み (IQL) を使用して、Insight からの情報に基づいてオブジェクトをフィルタリングする

  • 課題範囲の絞り込み (IQL) を使用して、現在の課題の情報に基づきオブジェクトをフィルタリングする

オブジェクト スキーマ フィールドを使用する

オブジェクト スキーマ フィールドを使用して、この Insight オブジェクト フィールドにリンクされているオブジェクト スキーマを選択します。このフィールドは必須項目です。

範囲の絞り込み (IQL) フィールドで別のオブジェクト スキーマからオブジェクトを選択した場合は、このオブジェクト スキーマのみが表示されます。

範囲の絞り込み (IQL) フィールドを使用する

Insight からの情報に基づいて Insight オブジェクトをフィルタリングするには、[範囲の絞り込み (IQL)] フィールドを使用します。

このフィールドはオプションです。このフィールドではプレースホルダーを使用できません。

たとえば、特定の製造元に基づいて、特定のモデルのラップトップのみを表示する Insight オブジェクト フィールドを作成する場合は、IQL クエリ「objectType = “Laptop” AND Manufacturer = “Apple”」と入力するとこれらのオブジェクトのみを表示できます。

課題範囲の絞り込み (IQL) フィールドを使用する

課題範囲の絞り込み (IQL) フィールドを使用して、課題内の情報によってデータをフィルタリングします。これは、課題に関する情報を含む、他の Insight オブジェクト フィールドまたは Jira システム フィールドに基づきます。

このフィールドはオプションです。このフィールドではプレースホルダーを使用できますプレースホルダーの詳細をご確認ください

課題内のオブジェクト フィールドを使用してフィルタリングする

課題範囲の絞り込み (IQL) フィールドを使用して、課題内から Insight オブジェクト フィールドを参照できます。これは、2 つ以上の Insight オブジェクト フィールドをリンクして、カスケード リストを作成する際に使用できます。

たとえば、別のカスタム フィールドで選択した製造元に基づいて、特定のモデルのラップトップのみを表示する Insight オブジェクト フィールドを作成する場合は、2 つの個別の Insight オブジェクト フィールドを作成します。

1 つ目の Insight オブジェクト フィールドを作成して、“Manufacturer (製造元)” という名前を付けます。範囲の絞り込み (IQL)objectType = “Manufacturer” に設定して、Insight から取得した “Manufacturer (製造元)” オブジェクトのみを表示するようにフィールドを構成します。

次に、2 つ目の Insight オブジェクト フィールドを作成して、“Model (モデル)” という名前を付けます。「objectType = “Laptop” AND Manufacturer = ${customfield_xxxxx.label}」と入力して、課題にある製造元フィールドのラップトップ モデルのみを表示するようにフィルター課題スコープ (IQL) を構成します。なお、ここでの「xxxxx」とは、“Manufacturer (製造元)” カスタム フィールドのカスタム フィールド ID を指します。

これで、“Model (モデル)” フィールドには、その製造元に対応するラップトップのみが表示されます。

フィルター課題スコープ (IQL) フィールドを使用する場合、カスタム フィールドを識別するためには、“Manufacturer (製造元)” といったカスタム フィールド名ではなくカスタム フィールド ID (“customfield_xxxxx”) を使用する必要があります。

課題内のシステム フィールドを使用してフィルタリングする

課題範囲の絞り込み (IQL) フィールドを使用して、課題内の “Assignee (担当者)” や “Project (プロジェクト)” などのシステム フィールドを参照できます。

たとえば、現在の担当者が所有するラップトップのリストだけを表示する場合は、「objectType = “Laptop” AND "Owner" LIKE ${assignee.label}」と入力して課題範囲の絞り込み (IQL) フィールドを構成できます。この場合、各ラップトップは Jira 担当者の名前に対応する “Owner” (所有者) 属性を持っています。

Jira フィールドの中には、複数の値を保持できるものもあれば単一値しか保持できないものもあります。フィールド値ラベルまたは ID を使用して Jira フィールドを参照します。

課題キー

ラベル/説明

複数

タイプ

${key.id}

${key.label}

assignee

担当者

false

ApplicationUser

ユーザー キー

表示名

dueDate

期限

false

日付

dueDate

dueDate

修正バージョン

修正バージョン

true

文字列/カスタム Insight オブジェクト

ID

名前

issuetype

課題タイプ

false

文字列/カスタム Insight オブジェクト

ID

名前

コンポーネント

コンポーネント

true

文字列/カスタム Insight オブジェクト

ID

名前

priority

優先度

false

文字列/カスタム Insight オブジェクト

ID

名前

pid

Project

false

文字列/カスタム Insight オブジェクト

ID

名前

reporter

報告者

false

ApplicationUser

ユーザー キー

表示名

resolution

ソリューション

false

文字列/カスタム Insight オブジェクト

ID

名前

summary

要約

false

文字列

summary

summary

Jira Service Management の Insight には、Jira Service Management DC の Insight に含まれるシステム フィールド タイプは含まれません。

これらのシステム フィールド タイプで検索する場合は、これらのフィールドをモデル化した Insight オブジェクトを作成する必要があります (つまり独自の ProjectComponent Insight オブジェクトを作成する必要がある)。その後、それらを別のカスタム フィールドの値として設定するか、フィールド ラベルや ID も使用できます。

複数の値を持つプレースホルダーを使用する

上記の例では、プレースホルダーを使用して製造元フィールド $ {customfield_xxxxx.label} (「xxxxx」は “Manufacturer (製造元)” カスタム フィールドのカスタム フィールド ID) の値を参照しています。プレースホルダーは、クエリを実行する際にクエリ内のテキストを他のテキストに置き換えます。

プレースホルダーは、${customfield_xxxxx.label} などの単一値を返せます。

フィールドに複数の値が含まれている場合、プレースホルダーはインデックス (${{customfield_xxxxx${{1}}}}) を使用して単一値を返します。また、Manufacturer IN (${{customfield_xxxxx${{0}}}}) のようなクエリを使用して一度にすべての値を返せます。

プレースホルダーの使用は、自動化フロー内ではサポートされていません。

 

最終更新日 2021年07月 7日)
次でキャッシュ 7:04 PM on Oct 25, 2021 |

その他のヘルプ