WidgetUtil financeiro - Com escopo

. WidgetUtil financeiro a inclusão de script fornece métodos para personalizar widgets no Finanças seção de Espaço de projetos e. Planejamento estratégico Espaço.

Os widgets a seguir estão disponíveis em Espaço de projetos e. Planejamento estratégico Espaço por padrão.

• Orçamento
• Estimativa na Conclusão
• Custo planejado
• Custo real até o momento

Você pode usar WidgetUtil financeiro inclusão de script para adicionar widgets secundários que mostram valores para um período de tempo especificado ou tipo de despesa.

Figura 1. Seção Finanças em Espaço de projetos

Neste exemplo de Espaço de projetos, O widget Custo planejado tem widgets secundários que mostram valores de Capex e Opex, enquanto o widget Orçamento não tem widgets secundários.

Para usar esta inclusão de script, crie um widget secundário com um dos widgets financeiros disponíveis como primário. Use os métodos desta inclusão de script no Script campo do registro do widget secundário.

. WidgetUtil financeiro A inclusão de script requer a aplicação Financials Core (sn_invst_pln), bem como Planejamento estratégico aplicação (sn_apw_advanced) ou Espaço de projetos aplicação (sn_pw). Esta inclusão de script é fornecida em sn_invst_pln namespace.

FinancialsWidgetUtil - FinancialsWidgetUtil(GlideRecord investmentGr, Object timeScope, cadeia de caracteres ExpenseType)

Instancia um WidgetUtil financeiro objeto.

Este objeto é usado para obter valores agregados, como orçamento e custo planejado para um investimento.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
InvestmentGr	GlideRecord	Investimento para o qual obter valores agregados. Tabela: Investimento [sn_invst_pln_invst_investment]
timeScope	Objeto	Lista de períodos fiscais a serem usados como datas de início e término da agregação. { "startFiscalPeriodSysId": "String", "endFiscalPeriodSysId": "String" }
TimeScope.startFiscalPeriodSysId	Cadeia de caracteres	Sys_id do período fiscal a ser usado como data de início da agregação. Tabela: Período fiscal [fiscal_period]
TimeScope.endFiscalPeriodSysId	Cadeia de caracteres	Sys_id do período fiscal a ser usado como data de término da agregação. Tabela: Período fiscal [fiscal_period]
ExpenseType	Cadeia de caracteres	Opcional. Tipo de despesa a ser incluída na agregação, como despesa de capital (Capex) ou despesa operacional (Opex). Valores válidos: capex opex

Este exemplo instancia um WidgetUtil financeiro Objeto que pode ser usado para retornar valores agregados para um investimento em que o tipo de despesa é Capex e o período de tempo é Context.timeScope .

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

Retorna o custo real de todos os itens de planejamento e itens de trabalho vinculados a um investimento.

Para usar este método, crie um widget secundário com Custo real até o momento widget como primário. Use este método no Script campo do registro do widget secundário.

O custo real retornado por este método é para o período de tempo e o tipo de despesa especificados ao instanciar o. WidgetUtil financeiro objeto.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 3. Retorna

Tipo	Descrição
Objeto	Objeto que contém o valor de exibição e o valor do custo real. { "displayValue": "String", "value": Number }
<Object>.DisplayValue	Valor de exibição do custo real, como $1,00 K. . Tipo de dados: Cadeia de caracteres
<Object>.valor	Valor do custo real, como 1000 . Tipo de dados: Número

Este exemplo adiciona um widget secundário ao widget Custo real até a data que mostra o custo real somente para 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()

Retorna o orçamento para todos os itens de planejamento e itens de trabalho vinculados a um investimento.

Para usar este método, crie um widget secundário com Orçamento widget como primário. Use este método no Script campo do registro do widget secundário.

O orçamento retornado por este método é para o período de tempo e o tipo de despesa especificados ao instanciar o. WidgetUtil financeiro objeto.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 5. Retorna

Tipo	Descrição
Objeto	Objeto que contém o valor de exibição e o valor do orçamento. { "displayValue": "String", "value": Number }
<Object>.DisplayValue	Valor de exibição do orçamento, como $2,50 K. . Tipo de dados: Cadeia de caracteres
<Object>.valor	Valor do orçamento, como 2500 . Tipo de dados: Número

Este exemplo adiciona um widget secundário ao widget Orçamento que mostra o orçamento somente para 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()

Retorna o valor de estimativa na conclusão (EAC) para todos os itens de planejamento e itens de trabalho vinculados a um investimento.

Para usar este método, crie um widget secundário com Estimativa na conclusão widget como primário. Use este método no Script campo do registro do widget secundário.

O valor de EAC retornado por este método é para o período de tempo e o tipo de despesa especificados ao instanciar o. WidgetUtil financeiro objeto.

Tabela 6. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 7. Retorna

Tipo	Descrição
Objeto	Objeto que contém o valor de exibição e o valor do EAC. { "displayValue": "String", "value": Number }
<Object>.DisplayValue	Valor de exibição do EAC, como $2,38 K. . Tipo de dados: Cadeia de caracteres
<Object>.valor	Valor do EAC, como 2380 . Tipo de dados: Número

Este exemplo adiciona um widget secundário ao widget Estimativa na conclusão que mostra o EAC somente para 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').getEAC();
      return {
         displayValue: PPMCurrencyHelper.getFormattedAmountWithCurrency(opexCost.value),
         value: opexCost.value
      };
   }
})();

FinancialsWidgetUtil - getPlannedCost()

Retorna o custo planejado para todos os itens de planejamento e itens de trabalho vinculados a um investimento.

Para usar este método, crie um widget secundário com Custo planejado widget como primário. Use este método no Script campo do registro do widget secundário.

O custo planejado retornado por este método é para o período de tempo e o tipo de despesa especificados ao instanciar o. WidgetUtil financeiro objeto.

Tabela 8. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 9. Retorna

Tipo	Descrição
Objeto	Objeto que contém o valor de exibição e o valor do custo planejado. { "displayValue": "String", "value": Number }
<Object>.DisplayValue	Valor de exibição do custo planejado, como $4,05 K. . Tipo de dados: Cadeia de caracteres
<Object>.valor	Valor do custo planejado, como 4050 . Tipo de dados: Número

Este exemplo adiciona um widget secundário ao widget Custo planejado que mostra o custo planejado somente para 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
      };
   }
})();