FinancialsWidgetUtil - 범위 지정됨

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

기본적으로 다음 위젯을 사용할 수 프로젝트 작업 공간전략 계획 작업 공간 있습니다.

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

FinancialsWidgetUtil 스크립트 포함을 사용하여 지정된 기간 또는 경비 유형에 대한 값을 표시하는 하위 위젯을 추가할 수 있습니다.

그림 1. 의 재무 섹션 프로젝트 작업 공간

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

이 스크립트 포함을 사용하려면 사용 가능한 재무 위젯 중 하나를 상위로 하는 하위 위젯을 만듭니다 . 하위 위젯 기록의 스크립트 필드에 이 스크립트 포함의 메서드를 사용합니다.

FinancialsWidgetUtil 스크립트 포함에는 애플리케이션(sn_apw_advanced) 또는 프로젝트 작업 공간 애플리케이션(sn_pw)뿐만 아니라 Financials Core 애플리케이션(sn_invst_pln)이 전략 계획 필요합니다. 이 스크립트 포함은 sn_invst_pln 네임스페이스 내에서 제공됩니다.

FinancialsWidgetUtil - FinancialsWidgetUtil(GlideRecord investmentGr, 객체 timeScope, 문자열 expenseType)

FinancialsWidgetUtil 개체를 인스턴스화합니다.

이 객체는 투자에 대한 예산 및 계획된 비용과 같은 집계 값을 가져오는 데 사용됩니다.

표 1. 매개변수

이름	유형	설명
투자GR	GlideRecord	집계 값을 얻기 위한 투자입니다. 투자 [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)와 같이 집계에 포함할 경비 유형입니다. 유효한 값은 다음과 같습니다. 자본 지출 Opex

이 예시에서는 경비 유형이 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()

투자에 연결된 계획 수립 항목 및 작업 항목에 대한 실제 비용을 반환합니다.

이 메서드를 사용하려면 다음을 사용하여 하위 위젯을 만듭니다 . 현재까지 실제 비용 위젯을 부모로 사용합니다. 하위 위젯 기록의 스크립트 필드에서 이 메서드를 사용합니다.

실제 비용 이 메서드에서 반환되는 X는 FinancialsWidgetUtil 개체를 인스턴스화할 때 지정된 기간 및 경비 유형에 대한 것입니다.

표 2. 매개변수

이름	유형	설명
없음

표 3. 반환

유형	설명
객체	실제 비용에 대한 표시 값과 값을 포함하는 객체입니다. { "displayValue": "String", "value": Number }
<Object>.displayValue	실제 비용의 표시 값(예: $1.00,00,00)입니다. 데이터 유형: 문자열
<Object>.값	실제 비용의 값입니다(예: 1,000). 데이터 유형: 숫자

이 예에서는 현재까지 실제 비용 위젯에 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()

투자에 연결된 계획 수립 항목 및 작업 항목에 대한 예산을 반환합니다.

이 메서드를 사용하려면 다음을 사용하여 하위 위젯을 만듭니다 . 예산 위젯을 부모로 사용합니다. 하위 위젯 기록의 스크립트 필드에서 이 메서드를 사용합니다.

예산 이 메서드에서 반환되는 X는 FinancialsWidgetUtil 개체를 인스턴스화할 때 지정된 기간 및 경비 유형에 대한 것입니다.

표 4. 매개변수

이름	유형	설명
없음

표 5. 반환

유형	설명
객체	표시 값과 예산 값을 포함하는 객체입니다. { "displayValue": "String", "value": Number }
<Object>.displayValue	예산의 표시 값(예: $2.50,000)입니다. 데이터 유형: 문자열
<Object>.값	예산 값(예: 2,500)입니다. 데이터 유형: 숫자

이 예에서는 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()

투자에 연결된 계획 수립 항목 및 작업 항목에 대한 EAC(완료시점 예상치) 값을 반환합니다.

이 메서드를 사용하려면 다음을 사용하여 하위 위젯을 만듭니다 . 완료시점 예상치 위젯을 부모로 사용합니다. 하위 위젯 기록의 스크립트 필드에서 이 메서드를 사용합니다.

EAC 값 이 메서드에서 반환되는 X는 FinancialsWidgetUtil 개체를 인스턴스화할 때 지정된 기간 및 경비 유형에 대한 것입니다.

표 6. 매개변수

이름	유형	설명
없음

표 7. 반환

유형	설명
객체	EAC의 표시 값과 값을 포함하는 개체입니다. { "displayValue": "String", "value": Number }
<Object>.displayValue	EAC의 표시 값(예: $2.38K)입니다. 데이터 유형: 문자열
<Object>.값	EAC의 값입니다(예: 2380). 데이터 유형: 숫자

이 예제에서는 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()

투자에 연결된 계획 수립 항목 및 작업 항목에 대해 계획된 비용을 반환합니다.

이 메서드를 사용하려면 다음을 사용하여 하위 위젯을 만듭니다 . 계획된 비용 위젯을 부모로 사용합니다. 하위 위젯 기록의 스크립트 필드에서 이 메서드를 사용합니다.

계획된 비용 이 메서드에서 반환되는 X는 FinancialsWidgetUtil 개체를 인스턴스화할 때 지정된 기간 및 경비 유형에 대한 것입니다.

표 8. 매개변수

이름	유형	설명
없음

표 9. 반환

유형	설명
객체	계획된 비용의 표시 값과 값을 포함하는 객체입니다. { "displayValue": "String", "value": Number }
<Object>.displayValue	계획된 비용의 표시 값(예: $4.05,000)입니다. 데이터 유형: 문자열
<Object>.값	계획된 비용의 값입니다(예: 4,050). 데이터 유형: 숫자

이 예에서는 계획된 비용 위젯에 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
      };
   }
})();