Jira Service Management の管理者向けの利用開始ガイド
最初に、Jira Service Management の使用を開始する方法を確認します。
アセット オブジェクト カスタム フィールドを設定する
Jira Service Management の アセット は、Premium と Enterprise のみの機能です。アセットの詳細についてご確認ください。
アセット オブジェクトのカスタム フィールドを表示または編集する際は、特別な権限がユーザーに適用されます。
アセット オブジェクトのカスタム フィールドがポータルのエンドユーザーによってアクセスできるリクエスト タイプに追加されると、すべてのユーザー (Jira Service Management またはアトラシアン製品のライセンスを取得していないユーザーも含む) に対して一時的な「ユーザー」ロールが付与されます。これによって、ユーザーはアセット オブジェクトのフィールドとその値を表示できます。
Jira Software、Jira Service Management、および Jira Work Management の各ユーザーに対して、一時的な「オブジェクト スキーマ ユーザー」ロールが適用されます。これによって、アセット オブジェクトのカスタム フィールドのコンテンツをユーザーが既存の編集権限をすでに持っている課題内で表示して編集できるようになります。
これらのロールは、ご利用のライセンスでの合計ユーザー数に計上されません。
アセット オブジェクトのカスタム フィールドを使用すると、Jira Service Management でアセット オブジェクトを表示できます。アセット オブジェクト フィールドに表示するオブジェクトを選択するには、次の 3 つの方法でフィールドを設定できます。
オブジェクト スキーマを使用して、オブジェクト スキーマでオブジェクトをフィルタリングする
フィルター スコープ (AQL) を使用し、アセットの情報に基づいてオブジェクトをフィルタリングする
フィルター課題スコープ (AQL) を使用し、現在の課題の情報に基づいてオブジェクトをフィルタリングする
オブジェクト スキーマ フィールドを使用する
オブジェクト スキーマ フィールドを使用して、このアセット オブジェクト フィールドにリンクされているオブジェクト スキーマを選択します。このフィールドは必須項目です。
[フィルター スコープ] (AQL) フィールドで別のオブジェクト スキーマからオブジェクトを選択した場合は、そのオブジェクト スキーマのオブジェクトのみが表示されます。
フィルター スコープ (AQL) フィールドを使用する
[フィルター スコープ] (AQL) フィールドを使用し、アセットの情報に基づいてアセット オブジェクトをフィルタリングします。
このフィールドはオプションです。このフィールドではプレースホルダーを使用できません。
たとえば、特定の製造元に基づいて特定モデルのラップトップのみを表示するアセット オブジェクト フィールドを作成する場合は、AQL クエリ objectType = “Laptop” AND Manufacturer = “Apple” を入力すると、これらのオブジェクトのみを表示できます。
フィルター課題スコープ (AQL) フィールドを使用する
[フィルター課題スコープ] (AQL) フィールドを使用して、課題自体内の情報によってデータをフィルタリングします。これは、課題に関する情報を含む他のアセット オブジェクト フィールドまたは Jira システム フィールドに基づきます。
このフィールドでは検証が行われます。正しい AQL 構文には マークが付けられ、間違った AQL ステートメントには マークが付けられます。
このフィールドはオプションです。[このフィールドがカスタマー ポータルに表示されたらデフォルト オブジェクトを表示する] を有効にすると、このフィールドにオブジェクトが自動で表示されます。
このフィールドではプレースホルダーを使用できます。プレースホルダーの詳細をご確認ください。
課題内のオブジェクト フィールドを使用してフィルタリングする
[フィルター課題スコープ] (AQL) フィールドを使用して、課題内からアセット オブジェクト フィールドを参照できます。これは、2 つ以上のアセット オブジェクト フィールドをリンクして、カスケード リストを作成する際に使用できます。
たとえば、別のカスタム フィールドで選択した製造元に基づいて、特定モデルのラップトップのみを表示するアセット オブジェクト フィールドを作成する場合は、2 つの個別のアセット オブジェクト フィールドを作成します。
1 つ目のアセット オブジェクト フィールドを作成して「Manufacturer (製造元)」という名前を付けます。[フィルター スコープ] (AQL) を「objectType = “Manufacturer”」に設定することで、アセットから取得した「Manufacturer (製造元)」オブジェクトのみを表示するようにフィールドを設定します。
次に、2 つ目のアセット オブジェクト フィールドを作成して「Model (モデル)」という名前を付けます。「objectType = “Laptop” AND Manufacturer = ${customfield_xxxxx.label}」と入力することで、課題にある製造元フィールドのラップトップ モデルのみを表示するように [フィルター課題スコープ] (AQL) を設定します。なお、ここの「xxxxx」とは「Manufacturer (製造元)」カスタム フィールドのカスタム フィールド ID を指します。
これで、“Model (モデル)” フィールドには、その製造元に対応するラップトップのみが表示されます。
[フィルター課題スコープ] (AQL) フィールドを使用する際に、カスタム フィールドを識別するためには、カスタム フィールド名 (「Manufacturer (製造元)」) ではなくカスタム フィールド ID (「customfield_xxxxx」) を使用する必要があります。
[アセット] オブジェクト フィールド内で [フィルター スコープ] または [フィルター課題スコープ] を使用すると、ORDER BY は無視されます。
課題内のシステム フィールドを使用してフィルタリングする
[フィルター課題スコープ] (AQL) フィールドを使用して、課題内の「Assignee (担当者)」や「Project (プロジェクト)」などのシステム フィールドを参照できます。
たとえば、現在の担当者が所有するラップトップのリストだけを表示する場合は「objectType = “Laptop” AND "Owner" LIKE ${assignee.label}」と入力して [フィルター課題スコープ] (AQL) フィールドを設定できます。この場合、各ラップトップは Jira の担当者名に対応する「Owner (所有者)」属性を持っています。
Jira フィールドの中には、複数の値を保持できるものもあれば単一値しか保持できないものもあります。フィールド値ラベルまたは ID を使用して Jira フィールドを参照します。
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 |
Jira Service Management のアセットには、Jira Service Management Data Center のアセットのアセットに含まれるシステム フィールド タイプは含まれません。
これらのシステム フィールド タイプで検索する場合は、これらのフィールドをモデル化したアセット オブジェクトを作成する必要があります (つまり、独自のプロジェクト コンポーネント アセット オブジェクトを作成する必要がある)。その後、それらを別のカスタム フィールドの値として設定するか、フィールド ラベルや ID を使用できます。
複数の値を持つプレースホルダーを使用する
フィールドに複数の値が含まれている場合、プレースホルダーはインデックス ${customfield_xxxxx.id${1}} を使用して単一の値を返すことも、objectId IN (${customfield_xxxxx.id${0}}) のようなクエリ、または Label In (${customfield_xxxxx.label${0}}) のようなクエリを使用してすべての値を一度に返すこともできます (「xxxxx」は「Manufacturer」カスタム フィールドのカスタム フィールド ID です)。
プレースホルダーの使用は、自動化フロー内ではサポートされていません。
テキストのカスタム フィールド タイプはプレースホルダーと併用できません。プレースホルダーは設定済みの値だからです。
この内容はお役に立ちましたか?
さらにヘルプが必要ですか?
アトラシアン コミュニティをご利用ください。