EAP でのスクリプト化済み拡張ポイントの実装作成

リリースバージョン: Australia

更新日 2026年03月12日

所要時間：4分

デフォルトのスクリプト化済み拡張ポイントを更新するか、デフォルトの拡張ポイントをテンプレートとして使用してスクリプト化済み拡張ポイントを作成して、EAP ダッシュボードに表示されるデータをフィルタリングします。

始める前に

EAP の読み取り専用ロールとダッシュボードの関連付けに展開したカスタムモバイルアプリケーションを使用して管理しました。

必要なロール：sn_apw_advanced.eap_admin

このタスクについて

スクリプト化済み拡張ポイントを使用すると、さまざまなデータソースからの情報をフィルタリングするカスタムクエリを作成できます。デフォルトでは、各 EAP 構成は拡張ポイントに関連付けられています。各拡張ポイントは、関連付けられているすべてのチームタイプを処理します。新しい EAP 構成を作成するたびに、スクリプト化済み拡張ポイントの実装を作成する必要があります。

重要:

このタスクは、カスタム構成の場合、またはデフォルトのダッシュボードをカスタマイズする場合にのみ実行します。デフォルト構成を使用している場合、このタスクは必要ありません。

手順

移動先すべて > スクリプト化済みの拡張点.
EAPDashboardsEncodedQueryProvider (sn_apw_advanced.EAPDashboardsEncodedQueryProvider) スクリプト化済み拡張ポイントを検索して開きます。
[実装を作成] 関連リンクを選択して、このスクリプト化済み拡張ポイントの実装を作成します。
新しい実装レコードフォームが表示されます。
新しく作成した実装の [名前] フィールドを任意のカスタム名で更新します。
名前にスペースを含めないようにしてください。たとえば、実装の名前を MyConfigEAPDashboardsEncodedQueryProvider に変更します。
[更新] を選択します。
EAPDashboardsEncodedQueryProvider (sn_apw_advanced.EAPDashboardsEncodedQueryProvider) スクリプト化済み拡張ポイントを開きます。
[実装] 関連リストから、新しく作成した実装レコードのクラスをクリックして開きます。

[スクリプト] フィールドを次のように更新します。

getConfigId 関数で、EAP 構成の sys_id を入力します。

fetchEncodedQueries 関数で、反復 ID、チームタイプ、チーム ID など、EAP 構成の各レベルの情報をフィルター処理するクエリを入力します。

以下は、デフォルトの大規模なソリューション構成のスクリプト例です。

fetchEncodedQueries: function(teamType, teamId, iterationId) {
        switch (teamType) {
            case "sn_apw_advanced_agile_team":
                return {
                    rm_story: `iteration=${iterationId}`,
                    sn_apw_advanced_eap_iteration: `sys_id=${iterationId}`,
                    sn_gf_goal_m2m_relationship: `table_name=sn_apw_advanced_eap_iteration^entity_id=${iterationId}`,
                    sn_apw_advanced_eap_iteration_db_view: `iter_eap_team=${teamId}`
                };
            case "sn_apw_advanced_agile_release_train":
                return {
                    sn_align_core_feature: `iteration=${iterationId}`,
                    sn_apw_advanced_eap_iteration: `sys_id=${iterationId}`,
                    sn_gf_goal_m2m_relationship: `table_name=sn_apw_advanced_eap_iteration^entity_id=${iterationId}`,
                    sn_apw_advanced_eap_iteration_db_view: `iter_parent=${iterationId}`
                };
            case "sn_apw_advanced_solution_train":
                return {
                    sn_apw_advanced_eap_iteration: `eap_team.parent=${teamId}`,
                    sn_align_core_capability: `eap_team=${teamId}^OReap_team.parent=${teamId}`
                };
            default:
                return {
                    sn_align_core_eap_planning_item: `iteration=${iterationId}`,
                };
        }
    },

    getConfigId: function() {
        return "e4e11e0977243110740fefc0aa5a99f9";
    },

[更新] を選択します。

タスクの結果

EAP チームの [ホーム] タブを次回リロードすると、実装に加えた更新に従ってフィルタリングされたデータがダッシュボードに表示されます。