FinancialsWidgetUtil - 범위 지정

FinancialsWidgetUtil API는 및 의 재무 섹션에서 프로젝트 작업 공간 위젯을 사용자 지정하는 데 사용할 수 있습니다Strategic Planning 작업 공간.

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

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

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

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

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

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

FinancialsWidgetUtil API에는 Financials Core 애플리케이션(sn_invst_pln)과 애플리케이션(sn_apw_advanced) 또는 프로젝트 작업 공간 애플리케이션(sn_pw)이 Strategic Planning 필요합니다. 이 API는 sn_invst_pln 네임스페이스 내에서 제공됩니다.

FinancialsWidgetUtil - FinancialsWidgetUtil(GlideRecord, investmentGr, 객체 timeScope, 문자열 경비 유형)

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] 테이블에 있습니다.
경비 유형	문자열	옵션입니다. 자본 지출(CapEx) 또는 운영 경비(OpEx)와 같이 집계에 포함할 경비 유형입니다. 유효한 값은 다음과 같습니다. Capex 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()

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

이 메서드를 사용하려면 Configure a widget for project financial metrics 현재까지의 실제 비용 위젯을 상위로 사용합니다. 하위 위젯 기록의 스크립트 필드에서 이 메서드를 사용합니다.

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

표 2. 매개변수

이름	유형	설명
없음

표 3. 반환

유형	설명
객체	실제 비용의 표시 값과 값을 포함하는 객체입니다. { "displayValue": "String", "value": Number }
<Object>.display값	실제 비용의 표시 값(예: $1.00,000)입니다. 데이터 유형: 문자열
<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()

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

이 메서드를 사용하려면 Configure a widget for project financial metrics 예산 위젯을 상위로 사용합니다. 하위 위젯 기록의 스크립트 필드에서 이 메서드를 사용합니다.

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

표 4. 매개변수

이름	유형	설명
없음

표 5. 반환

유형	설명
객체	예산의 표시 값과 값을 포함하는 객체입니다. { "displayValue": "String", "value": Number }
<Object>.display값	예산의 표시 값(예: $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) 값을 반환합니다.

이 메서드를 사용하려면 Configure a widget for project financial metrics 완료시점 예상치 위젯을 상위로 사용합니다. 하위 위젯 기록의 스크립트 필드에서 이 메서드를 사용합니다.

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

표 6. 매개변수

이름	유형	설명
없음

표 7. 반환

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

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

이 메서드를 사용하려면 Configure a widget for project financial metrics 계획된 비용 위젯을 상위로 사용합니다. 하위 위젯 기록의 스크립트 필드에서 이 메서드를 사용합니다.

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

표 8. 매개변수

이름	유형	설명
없음

표 9. 반환

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

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