式インジケーターの作成

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：11分

    • 式インジケーターを作成して、1 つ以上の他のインジケーターから新しい計算済みスコアを生成します。インジケータースコアに加えて、インジケータースコアとインジケーターターゲットの間のギャップなどの計算を式に含めることができます。

    始める前に

    必要なロール：pa_power_user、pa_admin、または admin

    このタスクについて

    多くの場合、式は以下の目的で使用されます。
    • 比率とパーセンテージを計算する。
    • 異なるアプリケーションのデータを結合する。
    • 履歴パフォーマンスに基づいて予測インジケーターを構築する。

    式インジケーターのフィールドは、自動インジケーターのフィールドに似ています。ただし、ソース、追加条件、およびコレクションプロパティの代わりに、式ステートメントが定義されています。式は、他のインジケーター、定数、変数、時系列、またはこれらの要素の任意の組み合わせで構成できます。

    注:
    • インジケーターを作成するには、 パフォーマンスアナリティクス のサブスクリプションが必要です。
    • ドメインセパレーションを使用している場合、インジケーターは現在存在するドメインに作成されます。

    手順

    1. 次のいずれかのナビゲーションパスを使用します。
      • プラットフォームアナリティクス に移行されていないアップグレード済みインスタンスを使用している場合は、 すべて > パフォーマンスアナリティクス > インジケーター > インジケーター (計算) をクリックし、[ 新規] を選択します。
      • 新しいインスタンスを使用している場合、または プラットフォームアナリティクスに移行した場合は、次の場所に移動します すべて > プラットフォームアナリティクス管理 > インジケーター > インジケーター (計算) をクリックし、[ 新規] を選択します。
    2. [ 名前 ] フィールドで、「オープンインシデントの平均期間」などのわかりやすい名前をインジケーターに付けます。
    3. [ カレンダー] フィールドで、標準カレンダー、ビジネスカレンダーまたは会計カレンダーグループのいずれかを選択します。
    4. ビジネスカレンダーまたは会計カレンダーを選択した場合は、カレンダー頻度を選択します。
      式内の少なくとも 1 つのインジケーターが、指定されたカレンダー頻度と一致する必要があります。カレンダー頻度の選択は、ビジネスカレンダーエントリまたは会計カレンダースケジュールの設定によって異なります。
      たとえば、グレゴリオ暦には四半期、月、週、および年の頻度があります。グレゴリオ暦を使用している場合は、これらの頻度のいずれかを選択する必要があります。
      グレゴリオ暦のカレンダー頻度オプション
    5. このインジケーターのスコアが時間の経過とともに増減することを希望する場合は、[方向] フィールドで [最大化] または [最小化] を選択します。
      分析ツールとグラフィック ディスプレイがこのインジケーターの [方向] に使用されています。
      ヒント:
      可能な限り方向を設定してください。すべての主要なインジケーターを [最大化] または [最小化] に設定する必要があります。
      値ユースケース
      最大化 このインジケーター スコアの増加が求められている場合に選択します。例えば、収益を表示するインジケーターには [最大化] を選択することを考慮します。分析ツールとグラフィック要素は、このインジケータースコアの増加が良いことであり、減少することが悪いことであることを反映しています。
      最小化 このインジケーター スコアの減少が求められている場合に選択します。例えば、収益を表示するインジケーターには [最小化] を選択することを考慮します。分析ツールとグラフィック要素は、このインジケータースコアの減少は良いことであり、増加することは悪いことであることを反映しています。
      なし このスコアの変更の方向が、ビジネスにとって重要でない場合に選択します。
    6. このインジケーターの式を定義します。
      1. 計算値を式で使用するには、 メソッドの [参照 (繰り返し可能)] をクリックします。
        PAFormulaUtils() のメソッドを式に挿入するためのダイアログが開きます。この API はインジケーターの計算値を返します。この API の使用の詳細については、「 式でアナリティクスメソッドを取得する」を参照してください。
        [メソッドを式に追加] ダイアログボックス内のメソッドの説明的なラベルのリスト。[指定されたインジケーターのグローバルターゲットギャップを取得] が強調表示されています。
      2. インジケーターのスコアを式に入れるには、[ インジケーターを参照 ] リンクをクリックし、ダイアログに入力します (繰り返し可能)。
        表 : 1. インジケーター選択ダイアログ
        フィールド 説明
        インジケーター 貢献インジケーターとして式に挿入するインジケーター。

        このインジケーターにビジネスカレンダーまたは会計カレンダーを使用する場合、式内の少なくとも 1 つのインジケーターで、一致するカレンダーとカレンダー頻度を使用する必要があります。
        ブレークダウン、要素、第 2 レベルのブレークダウン、第 2 レベルの要素 インジケーターのスコアをフィルタリングするための最大 2 レベルのブレークダウンと要素。ブレークダウンを指定する場合は、そのブレークダウンの要素を指定する必要があります。これらのブレークダウンと要素は、この貢献インジケーターにのみ適用され、式インジケーター全体には適用されません。
        時系列 インジケーターの生のスコアを表示する代わりにインジケーターに適用する、7 日間の実行平均などの事前定義された分析関数。 この時系列は、この貢献インジケーターにのみ適用され、式インジケーター全体には適用されません。
        ブレークダウンを許可 式内の個々のインジケーターではなく、式インジケーター全体に適用されるブレークダウンを適用して、この貢献インジケーターに適用します。デフォルトで有効になっています。詳細については、「式の貢献インジケーターがブレークダウンを追跡できないようにする」を参照してください。

        ブレークダウンは、インジケーターの保存後に使用可能な [ブレークダウンを管理 (Manage breakdowns)] ダイアログから式全体に追加されます。ステップ 11 を参照してください。
        メソッドで使用します。 このインジケーターのスコアの代わりに一意の識別子を返します。式のメソッドにインジケーターを指定する場合は、このボックスを選択します。これらのメソッドは、 アナリティクスハブからインジケーターの計算値を取得します。これらのメソッドの使用の詳細については、「 式でアナリティクスメソッドを取得する」を参照してください。

        インジケーターは手動で追加できます。ただし、 インジケーターの参照 機能を使用すると、インジケーターと ブレークダウン要素の適切な表記が確実になります。

        式インジケーターを保存すると、式内のインジケーターが [ 貢献インジケーター ] 関連リストに表示されます。式インジケーターを含めた場合は、それらに寄与するインジケーターも一覧表示されます。
      3. 必要に応じて、 数 式に数学演算子と記号を追加します。

        式に含める演算子や数値を入力します。+、-、/、％、>、< などの有効な演算子記号を使用します。式にインジケーターをさらに追加することもできます。たとえば、オープンインシデントの合計経過時間とオープンインシデントの数に基づいてオープンインシデントの平均経過時間を計算するには、次の式を使用します 。[[オープンインシデントの合計経過時間]] / [[オープンインシデント]] / 24

        式でデータ収集期間を指定するには、変数 score_start と score_end を使用して、それぞれデータ収集期間の開始と終了を参照できます。ただし、 ユーザーのタイムゾーンが異なるため、score_start/終了が変更されましたの注意点を参照してください。
        警告:
        パフォーマンスアナリティクス スクリプトまたは式インジケーターで GlideRecords または GlideAggregates を使用しないでください。必要なものを取得するためにこれらの操作を使用する必要がある場合もありますが、これらはコストがかかり、数十万回実行する可能性があります。使用する前に、代替が存在しないことを確認してください。
    7. [ アクセス制御 ] タブで、このインジケーターをライブラリに保存するかどうか、およびインジケーターの表示をユーザー、グループ、またはロール別に制限するかどうかを設定します。
    8. [ その他 ] タブで、その他のプロパティを設定します。
      これらのプロパティは、式インジケーター全体に適用されます。
      表 : 2. [その他] タブのフィールド
      フィールド 説明
      デフォルトの時系列 7 日間の実行平均などの事前定義された分析関数。[ 時系列を結果に適用] が設定されているかどうかに応じて、この時系列は、結果が計算される前の各コンポーネントインジケーターに適用することも、結果に適用することもできます。
      ライブグループプロファイル

      ライブフィードグループのライブグループプロファイル [live_group_profile] レコード。グループプロファイルを指定すると、そのグループがこのインジケーターに関する通知を受け取ることができます。

      ServiceNow AI Platform上のこのソーシャルアプリケーションの詳細については、「ライブフィード」を参照してください。
      順序

      インジケーターが アナリティクスハブに表示される順序を示す番号。値が最も小さいインジケーターがリストの一番上に表示されます。[ 順序] フィールドに値が指定されていない場合、インジケーターは [名前 ] フィールドを使用して a から z まで表示されます。[順番] フィールドを使用するには、すべてのインジケーターの順番の番号を入力する必要があります。いくつかのインジケーターのみに数値を入力すると、インジケーターが表示される順序が a から z に戻ります。

      プラットフォームアナリティクスエクスペリエンスでは使用されません。
      実線のレンダリング

      選択すると、特定の日付のデータがない場合でも、 アナリティクスハブ と KPI 詳細 にこのインジケーターのデータ行が途切れることなく表示されます。この動作は、開始日が異なるデータセットを表示する場合や、在庫情報など定期的に更新されないデータの場合に便利です。

      インジケーター、 アナリティクスハブ 、 KPI 詳細に時系列が設定されている場合、連続線はレンダリングされません。
      時系列を結果に適用 結果が計算される前に、各コンポーネントインジケーターではなく、式の計算結果に時系列アグリゲーションを適用します。このオプションは、ウィジェットまたは アナリティクスハブのインジケーターに対して選択された時系列に適用されます。インジケーターにデフォルトの時系列が指定されている場合、このオプションはその時系列にも適用されます。詳細については、「結果または貢献インジケーターへの時系列の適用」を参照してください。
      計算式コンポーネントが NULL となることを許可する null スコアが含まれている場合でも計算式があります。トラブルシューティングに役立ちます。詳細については、「式にスコアのないインジケーターを検出する」を参照してください。
      複数のブレークダウン要素のスコアのアグリゲーションを許可 ウィジェットでこのインジケーターの複数のブレークダウン要素の合計スコアを表示できるようにします。このフィールドが選択されている場合、このインジケーターを使用するブレークダウンダッシュボードのフォームで集計値または分離値のいずれかを選択できます。加算、減算、または乗算に基づく式は、一般に集計を可能にするための優れた候補です。パーセンテージの合計が 100% であれば、パーセンテージもサポートされます。一方、平均で要素を集計した結果、または関連していないパーセンテージの結果は、通常意味がありません。
      警告:
      これらの集計では、数学的妥当性はチェックされません。
    9. オプション: [予測] タブで、予測方法、予測するデータ収集期間、予測の基礎となる履歴データの量、予測値の上限と下限を設定します。
      詳細については、「パフォーマンスアナリティクススコア予測」を参照してください。
    10. コンテキストメニューを展開し、[ 保存] をクリックします。

      コンテキストメニューの [保存] オプション
    11. 式インジケーター全体にブレークダウンを適用するには、ページの上部にある [ ブレークダウンを管理] をクリックします。
      デフォルトでは、式のすべての貢献インジケーターに対して構成されたブレークダウンのみを適用できます。
      注:
      この動作を制御するシステムプロパティ com.snc.pa.formula_indicator_valid_breakdown 。デフォルトでは true です。これを false に変更すると、少なくとも 1 つの貢献インジケーターがブレークダウンを使用する場合に、そのブレークダウンを式インジケーターに適用できます。ウィジェット、 アナリティクスハブ、または KPI 詳細 でサポートされていないブレークダウンのスコアを表示しようとすると、値ではなく警告メッセージが表示されます。

      式インジケーターレコードのブレークダウン要素を選択することはできません。ブレークダウンを選択できます ブレークダウンは、インタラクティブでのみ使用できます。つまり、 アナリティクスハブ、 KPI 詳細、適切に構成されたウィジェット、およびブレークダウンダッシュボードでのみ使用できます。[ブレークダウンを管理] ツールの使用方法の詳細については、「ブレークダウンのアサインとマップ」を参照してください。

    インシデントバックログの増加

    インシデントマネージャーは、インシデント解決の効率を向上させたいと考えています。新規インシデントと解決済みインシデントは、[新規インシデントの数] インジケーターおよび [解決済みインシデント数] インジケーターとして既に追跡されています。ただし、これらのインジケーターは、インシデント解決を改善するという目標を達成しているかどうかを示すものではありません。

    未処理のインシデントのボリュームを測定するには、新しいバックログの増加 KPI が必要です。この KPI を実装するには、次の式を使用して「インシデントバックログの増加」という名前の式インジケーターを作成します。 
    [[Number of new incident]] - [[Number of resolved incidents]]

    インシデントバックログの増加インジケーターレコード。
    [ ライブラリに表示] をオンにすると、インジケーターが KPI 詳細に表示されます。KPI 詳細の情報パネルには、インジケーターで使用されている式が表示されます。
    のインシデントバックログの増加インジケーター KPI 詳細