--- 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 --- # PAFormulaUtils API # PAFormulaUtils API {#ariaid-title1} * リリースバージョン: Xanadu * * 更新日 2024年08月01日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：1分 PAFormulaUtils API を使用すると、 アナリティクスハブ で計算された値を取得し、その値を式の入力として使用できます。 PAFormulaUtils API を使用するには、次の要件を満たす必要があります。 * パフォーマンスアナリティクス を有効にする必要があります。 * この API を使用する式インジケーターを作成するユーザーには、pa_power_user、pa_admin、または admin ロールが必要です。 {#PAFormulaUtils__ul_rxq_nnk_ffb} この例の \[オープンインシデントの数\] インジケーターのように、 PAFormulaUtils パラメーターのインジケーター名の前にドル記号 $ が付きます (例: `pa.getGap($[[Number of open incidents]], score_end);`。このドル記号は、インジケータースコアの代わりにインジケーターの アナリティクスハブ 計算値が返されることを意味します。 PAFormulaUtils メソッドの日付パラメータは、次のいずれかの形式を取ります。 * 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 を使用して自分でコーディングした日付パラメーター。 {#PAFormulaUtils__ul_jsg_gzx_tfb} 警告: PAFormulaUtils API は式インジケーターでのみ使用でき、スクリプトでは使用できません。 PAFormulaUtils API には、次のメソッドが含まれています。 * **[getChange(文字列インジケーター, オブジェクト fromDate, オブジェクト toDate)](https://servicenow-prod.fluidtopics.net/rbGM3f_79mPyWANOqHQfgg)** 指定された 2 つの日付間のインジケーターのスコアの変化を返します。 * **[getChangePercentage(文字列インジケーター, オブジェクト fromDate, オブジェクト toDate)](https://servicenow-prod.fluidtopics.net/xBVyJt6NJaAj3g7cC6sg1w)** 指定された 2 つの日付間のインジケーターのスコアの変化率を返します。 * **[getCurrentAggregateID()](https://servicenow-prod.fluidtopics.net/Mzl9lu_PqiMTGFDPnvoeYQ)** 現在の式のインジケーターから時系列集計識別子 (sys_id) を返します。 アナリティクスハブ の選択が変更されると、sys_idが動的に返されます。 * **[getCurrentBreakdownID()](https://servicenow-prod.fluidtopics.net/OGjPYpEnxqvUB4LxZAMskg)** 現在の式のインジケーターからレベル 1 ブレークダウン識別子 (sys_id) を返します。 アナリティクスハブ の選択が変更されると、sys_idが動的に返されます。 * **[getCurrentBreakdownLevel2ID()](https://servicenow-prod.fluidtopics.net/ZQlee94AIYb7ZeiqHytjvQ)** 現在の式のインジケーターからレベル 2 ブレークダウン識別子 (sys_id) を返します。 アナリティクスハブ の選択が変更されると、sys_idが動的に返されます。 * **[getCurrentElementID()](https://servicenow-prod.fluidtopics.net/Kv4H0r8qUeJqLA72tr9Q1g)** 現在の式のインジケーターからレベル 1 ブレークダウン要素識別子 (sys_id) を返します。 アナリティクスハブ の選択が変更されると、sys_idが動的に返されます。 * **[getCurrentElementLevel2ID()](https://servicenow-prod.fluidtopics.net/35Gm8ARypTmhwcSVDI1TJQ)** 現在の式のインジケーターからレベル 2 ブレークダウン要素識別子 (sys_id) を返します。 アナリティクスハブ の選択が変更されると、sys_idが動的に返されます。 * **[getGap(文字列インジケーター, オブジェクト onDate)](https://servicenow-prod.fluidtopics.net/_OFi7__Bbg8DKmBb7vtP~g)** 指定された日付の指定されたインジケーターのグローバル ターゲット ギャップを返します。 * **[getGlobalTarget(文字列インジケーター, オブジェクト onDate)](https://servicenow-prod.fluidtopics.net/gywA2uW1FtBeXj2ipqA4CQ)** 指定された日付の指定されたインジケーターに関連付けられたグローバル ターゲットを返します。 * **[getPersonalTarget(文字列インジケーター, オブジェクト onDate)](https://servicenow-prod.fluidtopics.net/mZ1qFQeWBnTU6KvQHgcohw)** 指定された日付の指定されたインジケーターに関連付けられた個人ターゲットを返します。 * **[getScore(文字列インジケーター, オブジェクト onDate)](https://servicenow-prod.fluidtopics.net/tWaJz91eUpjM6FnEYRXDvQ)** 指定された日付の指定されたインジケーターのスコアを返します。