数式で分析メソッドを取得する

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む5読むのに数分

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

    始める前に

    必要なロール:pa_power_user、admin

    このタスクについて

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

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

    手順

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

      [メソッドを式に追加 (Add a method to the formula)] ダイアログボックス内のメソッドの説明ラベルのリスト。[指定したインジケーターのグローバルターゲットギャップを取得 (Get global target gap of the specified indicator)] が強調表示されています。
    4. メソッドを選択します。
      メソッドを選択すると、メソッドの名前とパラメーターフィールドを含む説明が開きます。

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

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

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