AQL でサービスオブジェクトを使用する

サービスに表示される名前 (たとえば、 Software Registry や Tier など) は、 アセットクエリ言語 (AQL) で使用する名前とは異なります。サービススキーマと属性では a_ プレフィックスを使用します。そのため、Software Registry は a_software_registry になり、Tier は a_tier になります。この記事の表を使用して、必要な AQL 名を調べてください。

Jira Service Management の Standard、Premium、および Enterprise プランでご利用いただけます。

はじめる前に

AQL でサービスオブジェクトを使用するには、次が必要です。

サービスを含むプラン: Standard、Premium、または Enterprise。Free では利用できません。
AQL クエリを実行する権限: アセットオブジェクトに対して AQL クエリを実行するために必要な権限と同じです。

AQL を初めて使用する場合は、まずアセットクエリ言語 (AQL) を確認してから、ここに戻ってサービスフィールド名を確認してください。

サービスフィールド名に `a_` プレフィックスを使用する理由

サービススキーマと標準の属性は、AQL では a_ プレフィックスが付いて表示されます。たとえば、a_software_registry は Software Registry スキーマの AQL 名であり、a_tier は Tier 属性の AQL 名です。

a_ プレフィックスは永続的です。適用対象:

2 つの新しいサービススキーマ (ソフトウェアレジストリおよびビジネスポートフォリオ)
それらのスキーマ内のすぐに使える属性 (この記事に記載)

以下には適用されません:

サービススキーマに追加するカスタム属性 - これらはプレフィックスなしで、指定した名前がそのまま保持されます。
作成したカスタムオブジェクトタイプ - プレフィックスなし
アセットですでに使用している既存のスキーマ - 既存の AQL クエリは記述された通りに引き続き機能します

新しいサービススキーマより前にアセットを使用していた場合は、既存のクエリをそのまま維持できます。a_ プレフィックスは、新しいサービススキーマおよび今後のスキーマにのみ適用されます。既存のクエリをリファクタリングする必要はありません。a_ プレフィックスは永続的であるため、今日 a_* フィールドに対して作成したクエリは無期限に機能します。

サービススキーマ名

新しいサービススキーマが 2 つあります。特定のスキーマにクエリをスコープする場合は、これらの AQL 名を使用してください。

a_software_registry と a_business_portfolio はオブジェクトタイプではなく、スキーマです。スキーマ内のすべてをクエリするには、objectSchema = "<schema name>" でクエリをスコープします。スキーマ内の特定のオブジェクトタイプをクエリするには、代わりにそのオブジェクトタイプの名前を使用します。

表示名	AQL 名
ソフトウェアレジストリ	`a_software_registry`
ビジネスポートフォリオ	`a_business_portfolio`
技術サービス	`a_technical_services`
デジタル製品	`a_digital_products`
ソフトウェアサービス	`a_software_services`
アプリケーション	`a_applications`
機能	`a_capabilities`
デプロイされたサービス	`a_deployed_services`
ビジネスサービス	`a_business_services`

サービス属性名

これらは、すべてのサービスオブジェクトのすぐに使える属性です。以下の AQL 名を使用して、フィルター、結果の取得、または並べ替えを行います。

表示名	AQL 名
ステータス	`a_status`
Tier階層	`a_tier`
サービス ID	`a_service_id`
説明	`a_description`
Owner team	`a_owner_team`
対応者	`a_responders`
承認者の変更	`a_change_approvers`
変更管理に接続されたスペース	`a_change_management_connected_space`
Tags	`a_tags`
ソフトウェアレジストリリファレンス	`a_software_registry_references`
ビジネスポートフォリオリファレンス	`a_business_portfolio_references`

クエリの例

objectSchema を使用して、クエリを特定のサービススキーマにスコープします。上の表の属性名を使用して、結果をフィルター、取得、または並べ替えます。AQL の構文と演算子の完全なリファレンスについては、アセットクエリ言語 (AQL) をご覧ください。

ソフトウェアレジストリスキーマ内のすべての Tier 1 サービスを検索:

objectSchema = "a_software_registry" AND a_tier = "Tier 1"

特定のチームが所有するすべてのサービスを検索:

a_owner_team = "Platform Team"

サービス ID がないすべてのサービスを検索:

a_service_id is EMPTY

ビジネスポートフォリオスキーマで "customer-facing" とタグ付けされたすべてのサービスを検索:

objectSchema = "a_business_portfolio" AND a_tags = "customer-facing"

この内容はお役に立ちましたか?

正確ではなかった明確ではなかった関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問

AQL でサービス オブジェクトを使用する