---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://www.servicenow.com/docs/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# FinancialsWidgetUtil - スコープ指定

# FinancialsWidgetUtil - スコープ指定 {#ariaid-title1}

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

FinancialsWidgetUtil スクリプトインクルードは、プロジェクトワークスペース and 戦略的計画 ワークスペース の \[財務\] セクションのウィジェットをカスタマイズするためのメソッドを提供します。  
次のウィジェットは、デフォルトで プロジェクトワークスペース と 戦略的計画 ワークスペース で使用できます。

* 予算
* 完了時の推定 (EAC)
* 計画コスト
* 現在までの実績コスト

{#FinancialsWidgetUtilScopedAPI__ul_hdz_bxw_21c}FinancialsWidgetUtil スクリプトインクルードを使用して、指定した期間または経費タイプの値を表示する子ウィジェットを追加できます。  
図 : 1. の \[財務\] セクション プロジェクトワークスペース

この プロジェクトワークスペース の例では、計画コストウィジェットには投資と経費の値を表示する子ウィジェットがありますが、予算ウィジェットには子ウィジェットがありません。

このスクリプトインクルードを使用するには、使用可能な財務ウィジェットの 1 つを親として子 [ウィジェットを作成します](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=xanadu&pubname=xanadu-it-business-management&ft:locale=en-US) 。このスクリプトインクルードのメソッドを、子ウィジェットレコードの \[スクリプト \] フィールドで使用します。

FinancialsWidgetUtil スクリプトインクルードには、Financials Core アプリケーション (sn_invst_pln)、戦略的計画 アプリケーション (sn_apw_advanced) または プロジェクトワークスペース アプリケーション (sn_pw) が必要です。このスクリプトインクルードは、 `sn_invst_pln` 名前空間内で提供されます。

## FinancialsWidgetUtil - FinancialsWidgetUtil(GlideRecord investmentGr, オブジェクト timeScope, 文字列 expenseType) {#ariaid-title2}

FinancialsWidgetUtil オブジェクトをインスタンス化します。
このオブジェクトは、投資の予算や計画コストなどの集計値を取得するために使用されます。
{#FinWU-FinancialsWidgetUtil_O_O_S__table_f1z_33y_yzb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| InvestmentGr | [GlideRecord](https://www.servicenow.com/docs/DKnkjnu3r0c8j~e5s2NNhg#c_GlideRecordScopedAPI "スコープ付き GlideRecord API はデータベース操作に使用されます。") | 集計値を取得する投資。投資 \[sn_invst_pln_invst_investment\] テーブルにあります。 |
| timeScope | オブジェクト | 集計の開始日と終了日として使用する会計期間を含むオブジェクト。 { "startFiscalPeriodSysId": "String", "endFiscalPeriodSysId": "String" } |
| timeScope.startFiscalPeriodSysId | 文字列 | 集計の開始日として使用する会計期間のSys_id。会計期間 \[fiscal_period\] テーブルにあります。 |
| timeScope.endFiscalPeriodSysId | 文字列 | 集計の終了日として使用する会計期間のSys_id。会計期間 \[fiscal_period\] テーブルにあります。 |
| 経費タイプ | 文字列 | オプション。資本的支出 (CapEx) や運用コスト (OpEx) など、集計に含める経費のタイプ。 有効な値： * 投資 * 経費 {#FinWU-FinancialsWidgetUtil_O_O_S__ul_cbz_s3z_yzb} |
[表 : 1. パラメーター]

{#FinWU-FinancialsWidgetUtil_O_O_S__table_f1z_33y_yzb}  
この例では、経費タイプが CapEx で期間が `context.timeScope` である投資の集計値を返すために使用できる FinancialsWidgetUtil オブジェクトをインスタンス化します。

    var context = JSON.parse(context);
    var investment = context.investment;
    (function initializeFWU() {
       var invGr = new GlideRecord('sn_invst_pln_invst_investment');
       if (invGr.get(investment.sys_id)) {
          var capexCost = new sn_invst_pln.FinancialsWidgetUtil(invGr, context.timeScope, 'capex');
       }
    })();

## FinancialsWidgetUtil - getActuals() {#ariaid-title3}

投資にリンクされている計画立案アイテムと作業アイテムの実績コストを返します。
この方法を使用するには、 [Configure a widget for project financial metrics](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=xanadu&pubname=xanadu-it-business-management&ft:locale=en-US) 現在までの実績コスト ウィジェットを親として使用します。このメソッドを子ウィジェット レコードの \[スクリプト \] フィールドで使用します。

実績コスト このメソッドによって返される X は、FinancialsWidgetUtil オブジェクトをインスタンス化するときに指定された期間と経費タイプに対するものです。
{#FinancialsWidgetUtil-getActuals__table_blj_t3y_yzb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 2. パラメーター]

{#FinancialsWidgetUtil-getActuals__table_blj_t3y_yzb} {#FinancialsWidgetUtil-getActuals__table_xwh_m3y_yzb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | 表示値と実績コストの値を含むオブジェクト。 { "displayValue": "String", "value": Number } |
| \<Object\>.displayValue | 実績コストの表示値 ( `$1.00 K` など)。 データタイプ：文字列 |
| \<Object\>。価値 | 実績コストの値 ( `1000` など)。 データタイプ：数値 |
[表 : 3. 返される内容]

{#FinancialsWidgetUtil-getActuals__table_xwh_m3y_yzb}  
この例では、経費の実績コストのみを表示する \[現在までの実績コスト\] ウィジェットに子ウィジェットを追加します。

    var context = JSON.parse(context);
    var investment = context.investment;
    (function getCost() {
       var invGr = new GlideRecord('sn_invst_pln_invst_investment');
       if (invGr.get(investment.sys_id)) {
          var opexCost = new sn_invst_pln.FinancialsWidgetUtil(invGr, context.timeScope, 'opex').getActuals();
          return {
             displayValue: PPMCurrencyHelper.getFormattedAmountWithCurrency(opexCost.value),
             value: opexCost.value
          };
       }
    })();

## FinancialsWidgetUtil - getBudget() {#ariaid-title4}

投資にリンクされている計画立案アイテムと作業アイテムの予算を返します。
この方法を使用するには、 [Configure a widget for project financial metrics](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=xanadu&pubname=xanadu-it-business-management&ft:locale=en-US) 予算 ウィジェットを親として使用します。このメソッドを子ウィジェット レコードの \[スクリプト \] フィールドで使用します。

予算 このメソッドによって返される X は、FinancialsWidgetUtil オブジェクトをインスタンス化するときに指定された期間と経費タイプに対するものです。
{#FinancialsWidgetUtil-getBudget__table_wwh_m3y_yzb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 4. パラメーター]

{#FinancialsWidgetUtil-getBudget__table_wwh_m3y_yzb} {#FinancialsWidgetUtil-getBudget__table_xwh_m3y_yzb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | 予算の表示値と値を含むオブジェクト。 { "displayValue": "String", "value": Number } |
| \<Object\>.displayValue | 予算の表示値 ( `$2.50 K` など)。 データタイプ：文字列 |
| \<Object\>。価値 | 予算の値 ( `2500` など)。 データタイプ：数値 |
[表 : 5. 返される内容]

{#FinancialsWidgetUtil-getBudget__table_xwh_m3y_yzb}  
この例では、経費の予算のみを表示する子ウィジェットを予算ウィジェットに追加します。

    var context = JSON.parse(context);
    var investment = context.investment;
    (function getCost() {
       var invGr = new GlideRecord('sn_invst_pln_invst_investment');
       if (invGr.get(investment.sys_id)) {
          var opexCost = new sn_invst_pln.FinancialsWidgetUtil(invGr, context.timeScope, 'opex').getBudget();
          return {
             displayValue: PPMCurrencyHelper.getFormattedAmountWithCurrency(opexCost.value),
             value: opexCost.value
          };
       }
    })();

## FinancialsWidgetUtil - getEAC() {#ariaid-title5}

投資にリンクされている計画立案アイテムおよび作業アイテムの完了時推定 (EAC) 値を返します。
この方法を使用するには、 [Configure a widget for project financial metrics](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=xanadu&pubname=xanadu-it-business-management&ft:locale=en-US) EAC ウィジェットを親として使用します。このメソッドを子ウィジェット レコードの \[スクリプト \] フィールドで使用します。

EAC 値 このメソッドによって返される X は、FinancialsWidgetUtil オブジェクトをインスタンス化するときに指定された期間と経費タイプに対するものです。
{#FinancialsWidgetUtil-getEAC__table_gbs_43y_yzb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 6. パラメーター]

{#FinancialsWidgetUtil-getEAC__table_gbs_43y_yzb} {#FinancialsWidgetUtil-getEAC__table_xwh_m3y_yzb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | EAC の表示値と値を含むオブジェクト。 { "displayValue": "String", "value": Number } |
| \<Object\>.displayValue | EAC の表示値 ( `$2.38 K` など)。 データタイプ：文字列 |
| \<Object\>。価値 | EAC の値 ( `2380` など)。 データタイプ：数値 |
[表 : 7. 返される内容]

{#FinancialsWidgetUtil-getEAC__table_xwh_m3y_yzb}  
この例では、経費の EAC のみを表示する \[完了時の推定 (EAC)\] ウィジェットに子ウィジェットを追加します。

    var context = JSON.parse(context);
    var investment = context.investment;
    (function getCost() {
       var invGr = new GlideRecord('sn_invst_pln_invst_investment');
       if (invGr.get(investment.sys_id)) {
          var opexCost = new sn_invst_pln.FinancialsWidgetUtil(invGr, context.timeScope, 'opex').getEAC();
          return {
             displayValue: PPMCurrencyHelper.getFormattedAmountWithCurrency(opexCost.value),
             value: opexCost.value
          };
       }
    })();

## FinancialsWidgetUtil - getPlannedCost() {#ariaid-title6}

投資にリンクされている計画立案アイテムと作業アイテムの計画コストを返します。
この方法を使用するには、 [Configure a widget for project financial metrics](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=xanadu&pubname=xanadu-it-business-management&ft:locale=en-US) 計画コスト ウィジェットを親として使用します。このメソッドを子ウィジェット レコードの \[スクリプト \] フィールドで使用します。

計画コスト このメソッドによって返される X は、FinancialsWidgetUtil オブジェクトをインスタンス化するときに指定された期間と経費タイプに対するものです。
{#FinancialsWidgetUtil-getPlannedCost__table_jzp_q3y_yzb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 8. パラメーター]

{#FinancialsWidgetUtil-getPlannedCost__table_jzp_q3y_yzb} {#FinancialsWidgetUtil-getPlannedCost__table_xwh_m3y_yzb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | 表示値と計画コストの値を含むオブジェクト。 { "displayValue": "String", "value": Number } |
| \<Object\>.displayValue | 計画コストの表示値 ( `$4.05 K` など)。 データタイプ：文字列 |
| \<Object\>。価値 | 計画コストの値 ( `4050` など)。 データタイプ：数値 |
[表 : 9. 返される内容]

{#FinancialsWidgetUtil-getPlannedCost__table_xwh_m3y_yzb}  
この例では、経費の計画コストのみを表示する計画コストウィジェットに子ウィジェットを追加します。

    var context = JSON.parse(context);
    var investment = context.investment;
    (function getCost() {
       var invGr = new GlideRecord('sn_invst_pln_invst_investment');
       if (invGr.get(investment.sys_id)) {
          var opexCost = new sn_invst_pln.FinancialsWidgetUtil(invGr, context.timeScope, 'opex').getPlannedCost();
          return {
             displayValue: PPMCurrencyHelper.getFormattedAmountWithCurrency(opexCost.value),
             value: opexCost.value
          };
       }
    })();