---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# FinancialsWidgetUtil - 범위 지정됨

# FinancialsWidgetUtil - 범위 지정됨 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 9분

FinancialsWidgetUtil 스크립트 포함은 및 의 전략 계획 작업 공간재무 섹션 프로젝트 작업 공간 에서 위젯을 사용자 지정하는 메서드를 제공합니다.  
에서 기본적으로 다음 위젯을 사용할 수 프로젝트 작업 공간전략 계획 작업 공간 있습니다.

* 예산
* 완료시점 예상치
* 계획된 비용
* 현재까지 실제 비용

{#FinancialsWidgetUtilScopedAPI__ul_hdz_bxw_21c}FinancialsWidgetUtil 스크립트 포함을 사용하여 지정된 기간 또는 경비 유형에 대한 값을 표시하는 하위 위젯을 추가할 수 있습니다.  
그림 1. 프로젝트 작업 공간의 재무 섹션

의 프로젝트 작업 공간이 예에서 계획된 비용 위젯에는 CapEx 및 OpEx 값을 표시하는 하위 위젯이 있지만 예산 위젯에는 하위 위젯이 없습니다.

이 스크립트 포함을 사용하려면 사용 가능한 재무 위젯 중 하나를 상위로 하여 [하위 위젯을 생성합니다](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=australia&pubname=australia-it-business-management&ft:locale=en-US) . 하위 위젯 기록의 스크립트 필드에 이 스크립트 포함의 메서드를 사용합니다.

FinancialsWidgetUtil 스크립트 포함에는 애플리케이션(sn_apw_advanced) 또는 프로젝트 작업 공간 애플리케이션(sn_pw)뿐만 아니라 전략 계획 재무 코어 애플리케이션(sn_invst_pln)이 필요합니다. 이 스크립트 포함은 `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://servicenow-prod.fluidtopics.net/PdjBDkljzRHVS4qRn2BIdw#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\] |
| expenseType | 문자열 | 옵션입니다. 자본 지출(CapEx) 또는 운영 경비(OpEx)와 같이 집계에 포함할 경비 유형입니다. 유효한 값은 다음과 같습니다. * 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}

투자에 연결된 모든 계획 수립 항목 및 작업 항목에 대한 실제 비용을 반환합니다.
이 메서드를 사용하려면 다음을 사용하여 [하위 위젯을 생성합니다](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=australia&pubname=australia-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.00K`)을 표시합니다. 데이터 유형: 문자열 |
| \<Object\>.value | 실제 비용의 값( `예: 1000`)입니다. 데이터 유형: 숫자 |
[표 3. 반환]

{#FinancialsWidgetUtil-getActuals__table_xwh_m3y_yzb}  
이 예에서는 현재까지 실제 비용 위젯에 OpEx에 대한 실제 비용만 표시하는 하위 위젯을 추가합니다.

    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}

투자에 연결된 계획 수립 항목 및 작업 항목에 대한 예산을 반환합니다.
이 메서드를 사용하려면 다음을 사용하여 [하위 위젯을 생성합니다](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=australia&pubname=australia-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.50K`)을 표시합니다. 데이터 유형: 문자열 |
| \<Object\>.value | 예산의 값( `예: 2,500`)입니다. 데이터 유형: 숫자 |
[표 5. 반환]

{#FinancialsWidgetUtil-getBudget__table_xwh_m3y_yzb}  
이 예에서는 OpEx 예산만 표시하는 하위 위젯을 예산 위젯에 추가합니다.

    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(완료시 예상치) 값을 반환합니다.
이 메서드를 사용하려면 다음을 사용하여 [하위 위젯을 생성합니다](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=australia&pubname=australia-it-business-management&ft:locale=en-US) . 완료시점 예상치 위젯을 상위로 사용합니다. 하위 위젯 기록의 스크립트 필드에서 이 방법을 사용합니다.

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.38K`)입니다. 데이터 유형: 문자열 |
| \<Object\>.value | EAC의 값( `예: 2380`)입니다. 데이터 유형: 숫자 |
[표 7. 반환]

{#FinancialsWidgetUtil-getEAC__table_xwh_m3y_yzb}  
이 예제에서는 OpEx에 대한 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}

투자에 연결된 계획 수립 항목 및 작업 항목에 대해 계획된 비용을 반환합니다.
이 메서드를 사용하려면 다음을 사용하여 [하위 위젯을 생성합니다](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=australia&pubname=australia-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.05K`)을 표시합니다. 데이터 유형: 문자열 |
| \<Object\>.value | 계획된 비용의 값( `예: 4,050`)입니다. 데이터 유형: 숫자 |
[표 9. 반환]

{#FinancialsWidgetUtil-getPlannedCost__table_xwh_m3y_yzb}  
이 예에서는 OpEx에 대한 계획된 비용만 표시하는 하위 위젯을 계획된 비용 위젯에 추가합니다.

    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
          };
       }
    })();