式でアナリティクスメソッドを取得

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：5分

    • アナリティクスハブの計算値を式に挿入するには、式でメソッドを使用します。

    始める前に

    必要なロール:pa_power_user、admin

    このタスクについて

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

    アナリティクスハブから値を取得するには、PAFormulaUtils() のメソッドを式に挿入します。これらのメソッドのいずれかを呼び出すには、 パフォーマンスアナリティクス 変数 pa を使用します。たとえば、 PAFormulaUtils.getScore メソッドを使用するには、 pa.getScore を呼び出します。詳細については、「PAFormulaUtils API」を参照してください。

    手順

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

      [メソッドを式に追加] ダイアログボックスのメソッドの説明ラベルのリスト。[指定されたインジケーターのグローバルターゲットギャップを取得] がハイライト表示されています。
    4. メソッドを選択します。
      メソッドを選択すると、メソッドの名前やパラメーターフィールドを含む説明が開きます。

      [メソッドを式に追加] ダイアログには、選択された指定されたインジケーターのグローバル ターゲット ギャップを取得するメソッドと、収集された最後のスコアとして指定された日付が表示されます
      日付フィールドは次の値を取ることができます。
      • 2018-12-21 などの YYYY-MM-DD 形式の絶対日付。
      • 変数 score_start または score_end。これらの変数は、参照されるインジケーターに対して計算される収集期間の最初と最後の秒を表します。時間は、ユーザのタイムゾーンとデータベース・サーバのタイムゾーン (GMT) の差から計算されます。詳細については、「ユーザーのタイムゾーンが異なるため、score_start/終了への変更」を参照してください。
      • GlideDate または GlideDateTime API を使用して自分でコーディングした日付パラメーター。
    5. 任意のパラメーターを入力し、[ 選択] をクリックします。
      ダイアログが閉じ、インジケーター フォームの式フィールドにメソッドが表示されます。
    6. メソッドでインジケーターを指定する必要がある場合は、カーソルで インジケーター パラメーターを選択し、 インジケーターの [参照] をクリックします。
      インジケーター選択ダイアログが開きます。
      式のメソッド内からインジケーター選択ダイアログを開く
    7. インジケーターを選択します。
    8. オプション: ブレークダウンまたは要素と時系列集計を選択します。
    9. [メソッドで使用] を選択し、[送信] をクリックします。
      インジケーターが選択された状態でメソッドが完了しました。インジケーターの前にドル記号 $ が付いていることに注意してください。このドル記号は、インジケータースコアではなくインジケーターの アナリティクスハブ 値が返されることを意味します。[メソッドで使用] チェックボックスをオンにすると、スコアの代わりにアナリティクスハブ値が選択されます。
      [インジケーター]、[ブレークダウン]、[要素]、および [メソッドで使用] チェックボックスがオンになっている

    インデックスインジケーター

    インデックスインジケーターは、複数のインジケーターを表す単一のスコアを生成する式インジケーターのユースケースです。次の例では、次のインジケーターのスコアとグローバルターゲットの間のギャップを集計する単一のインデックスが必要です。
    • 期限切れのインシデントの割合。
    • オープンインシデントの前回の更新の平均経過時間。
    • オープンインシデントの合計数。
    この単一のインデックスを取得するには、[ 方向] を [最大化] に設定して式インジケーターを作成します。すべてのインデックスインジケーターを最大化する必要があります。次に、 メソッドの参照 関数と インジケーターの参照 関数を使用して、次の式を作成します。
    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;

    変更自体にターゲットを設定する

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

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

    ブレークダウンと要素に基づいてスコアを除外する

    優先度 = 1 - 重大のインシデントのスコアを除外したいと考えています。
    1. 優先度ブレークダウンと 1 - 重大要素の一意のレコード識別子を取得します。ブレークダウンレコードはブレークダウンテーブルにあります。要素レコードの場所はさまざまですが、ブレークダウンのブレークダウンソースで識別されます。この場合、要素は選択肢 [sys_choice] レコードです。一意のレコード識別子を取得する方法については、「 一意のレコード識別子 (sys_id)」を参照してください。

      一意のレコード識別子は、優先度ブレークダウンが baec0752bf130100b96dac808c0739ed で、1 - 重要な要素が 8a4dde73c6112278017a6a4baf547aa7 です。

    2. 次の式でインジケーターを作成します。
      var res = [[Number of open incidents]];
if(pa.getCurrentBreakdownID() == 'baec0752bf130100b96dac808c0739ed' && pa.getCurrentElementID() == '8a4dde73c6112278017a6a4baf547aa7')
{
res = 0;
}
res;