---
sourceDocument: Xanadu プラットフォームアナリティクス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu プラットフォームアナリティクス

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# 数式のアナリティクスメソッドを取得する

# 数式のアナリティクスメソッドを取得する {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：5分

アナリティクスハブから計算された値を数式に挿入するには、数式のメソッドを使用します。

## 始める前に

必要なロール:pa_power_user、admin

## このタスクについて

アナリティクスハブで計算された値を式の入力として使用できます。その値は、現在の式インジケーター自体を含む、任意のインジケーターから取得できます。

アナリティクスハブから値を取得するには、PAFormulaUtils() のメソッドを式に挿入します。これらのメソッドの 1 つを呼び出すには、 パフォーマンスアナリティクス 変数 `pa` を使用します。たとえば、 PAFormulaUtils.getScore メソッドを使用するには、 `pa.getScore` を呼び出します。詳細については、「[PAFormulaUtils API](https://servicenow-prod.fluidtopics.net/ruRMNhnIC9P1h5mmiSzp1A "PAFormulaUtils API を使用すると、 アナリティクスハブ で計算された値を取得し、その値を式の入力として使用できます。")」を参照してください。

## 手順

1. 式インジケーターレコードを開きます。
2. \[数式\] ボックスで、 メソッドの \[参照\] をクリックします。  
   メソッドを選択できるダイアログボックスが開きます。
3. ニーズに合った方法を参照します。  
   メソッドは、編集中の現在の式、または指定する必要がある別のインジケーターのいずれかを参照します。リストには、メソッド名の代わりに各メソッドの説明ラベルが表示されます。  

   <br />

4. メソッドを選択します。  
   メソッドを選択すると、メソッドの名前やパラメーターフィールドなどの説明が開きます。  

   <br />

   日付フィールドには、次の値を指定できます。
   * 2018-12-21 などの YYYY-MM-DD 形式の絶対日付。
   * 変数 `score_start` または `score_end`。これらの変数は、参照されるインジケーターに対して計算される収集期間の最初と最後の 1 秒を表します。時刻は、ユーザのタイムゾーンとデータベースサーバのタイムゾーン (GMT) の時差から計算されます。詳細については、「[ユーザーのタイムゾーンが異なることによるscore_start/終了の変更](https://servicenow-prod.fluidtopics.net/LGJG4OwqQdIzTuGyXrKJ~w "式インジケーターの場合、変数 score_start および score_end の値は、式を実行しているユーザーのタイムゾーンに基づいて計算されます。異なるタイムゾーンのユーザーが同じ計算式を実行すると、 score_start と score_end の値が変わります。")」を参照してください。
   * GlideDate または GlideDateTime API を使用して自分でコーディングした日付パラメーター。
   {#get-indicator-analytics__ul_pcg_2nx_tfb}
5. パラメータを入力し、「 選択」をクリックします。  
   ダイアログが閉じ、メソッドがインジケーターフォームの式フィールドに表示されます。
6. メソッドでインディケータを指定する必要がある場合は、カーソルで `インディケータ` パラメータを選択し、 インディケータの参照をクリックします。  
   インジケーター選択ダイアログが開きます。  

7. インジケーターを選択します。
8. **オプション:** ブレークダウンまたは要素と時系列集計を選択します。
9. \[ メソッドに使用 \]を選択し、\[ 送信\]をクリックします。  
   メソッドが完了し、インジケーターが選択されます。インジケーターの前にはドル記号 $ が付いていることに注意してください。このドル記号は、インジケータースコアではなくインジケーターの アナリティクスハブ 値が返されることを意味します。\[メソッドで使用\] チェック ボックスをオンにすると、スコアの代わりにアナリティクスハブ値が選択されます。  

## インデックスインジケーター {#get-indicator-analytics__example_bdg_v2h_rsb}

インデックスインジケーターは、複数のインジケーターを表す単一のスコアを生成するための式インジケーターのユースケースです。次の例では、次のインジケーターのスコアとグローバル ターゲットの間のギャップを集計する単一のインデックスが必要です。

* 期限切れのインシデントの割合。
* オープンインシデントの最終更新の平均経過時間。
* オープンインシデントの合計数。
{#get-indicator-analytics__ul_ezd_m3q_4fb}  
この単一のインデックスを取得するには、\[ 方向\] を \[ 最大化\] に設定して式インジケーターを作成します。すべてのインデックスインジケーターを最大化する必要があります。次に、 メソッドの参照 関数と インジケーターの参照 関数を使用して、次の式を作成します。

    var a = pa.getGap($[[% of open overdue incidents]], score_start) / pa.getGlobalTarget($[[% of open overdue incidents]],score_start);
    var b = pa.getGap($[[Average age of last update of open incidents]], score_start) / pa.getGlobalTarget($[[Average age of last update of open incidents]], score_start);
    var c = pa.getGap($[[Number of open incidents]], score_start) / pa.getGlobalTarget($[[Number of open incidents]], score_start);
    var res = 100 - (100 * (a + b + c) / 3);
    res;

## 変更自体にターゲットを設定する {#get-indicator-analytics__example_xcc_fmz_3wb}

インシデントバックログで前月比 10% 削減というチームの目標を設定しようとしています。次の式を使用して式インジケーターを作成し、 アナリティクスハブでこのインジケーターのターゲットを -10% に設定します。

    var lastPeriod = new GlideDateTime(score_start.getYear() + '-' + score_start.getMonth() + '-01');
    lastPeriod.addDaysUTC(-1);
    pa.getChangePercentage($[[Number of open incidents]], lastPeriod.addDaysUTC(-1), score_start);

## ブレークダウンと要素に基づいてスコアを除外する {#get-indicator-analytics__example_gfq_hlz_3wb}

優先度 = 1 - 重大のインシデントのスコアを除外するとします。

1. \[優先度\] ブレークダウンと \[1 - 重要\] 要素の一意のレコード識別子を取得します。ブレークダウンレコードはブレークダウンテーブルにあります。要素レコードの場所はさまざまですが、ブレークダウンのブレークダウンソースで識別されます。この場合、要素は選択肢 \[sys_choice\] レコードです。一意のレコード識別子を取得する方法については、「 [一意のレコード識別子 (sys_id)」](https://www.servicenow.com/docs/access?context=c_UniqueRecordIdentifier&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)を参照してください。

   一意のレコード識別子は、優先度ブレークダウンの場合は baec0752bf130100b96dac808c0739ed、1 - 最重要要素の場合は 8a4dde73c6112278017a6a4baf547aa7 です。
2. 次の式でインジケーターを作成します。

       var res = [[Number of open incidents]];
       if(pa.getCurrentBreakdownID() == 'baec0752bf130100b96dac808c0739ed' && pa.getCurrentElementID() == '8a4dde73c6112278017a6a4baf547aa7')
       {
       res = 0;
       }
       res;

{#get-indicator-analytics__ol_exr_wm5_5fb}
* **[PAFormulaUtils API](https://servicenow-prod.fluidtopics.net/ruRMNhnIC9P1h5mmiSzp1A)**   
  PAFormulaUtils API を使用すると、 アナリティクスハブ で計算された値を取得し、その値を式の入力として使用できます。

**関連概念**   

* [式内の貢献インジケーターがブレークダウンをフォローしないようにする](https://servicenow-prod.fluidtopics.net/ghljgoyczhueud4sw37msA "計算式内の貢献インジケーターを選択して、ブレークダウンしないようにすることができます。ユーザーが式インジケーターにブレークダウンを適用すると、ブレークダウンはこれらのインジケーターには適用されません。")
* [式インジケーターのブレークダウン マトリクス](https://servicenow-prod.fluidtopics.net/MINvJVmZouCNqhZbqTQWog "式インジケーターは、式内のインジケーターからブレークダウン マトリクスを継承します。")
* [結果または貢献インジケーターへの時系列の適用](https://servicenow-prod.fluidtopics.net/1JnOH7ZdC7QBAovJlKNkyQ "式インジケーターの場合、時系列集計は、式の各インジケーターに個別に適用することも、式の結果に適用することもできます。")
* [式内の複数のインジケーターのインデックス作成](https://servicenow-prod.fluidtopics.net/Zf2UolbwBzbrM3MpIoTjvQ "複数の組み合わされたインジケーターの全体的なターゲットに対するギャップを測定する式を記述できます。このような式指標は「インデックス指標」と呼ばれます。")
* [ユーザーのタイムゾーンが異なることによるscore_start/終了の変更](https://servicenow-prod.fluidtopics.net/LGJG4OwqQdIzTuGyXrKJ~w "式インジケーターの場合、変数 score_start および score_end の値は、式を実行しているユーザーのタイムゾーンに基づいて計算されます。異なるタイムゾーンのユーザーが同じ計算式を実行すると、 score_start と score_end の値が変わります。")  
**関連タスク**   

* [式インジケーターの作成](https://servicenow-prod.fluidtopics.net/l0XOOaKBzrpz6BiwIhmu3w "式インジケーターを作成して、1 つ以上の他のインジケーターから新しい計算済みスコアを生成します。式には、インジケータースコアに加えて、インジケータースコアとインジケーターターゲットの間のギャップなどの計算を含めることができます。")
* [式にスコアがないインジケーターを検出する](https://servicenow-prod.fluidtopics.net/ymSQv610Vv0c5nag_wyN2g "計算式の作成者は、スコアが null の貢献インジケーターを処理できます。まず、計算式に null スコアが含まれている場合でも計算式を計算するように式インジケーターを設定します。")