FinancialsWidgetUtil : dans le champ d’application

L’include de script FinancialsWidgetUtil fournit des méthodes pour personnaliser les widgets dans la section Finances de Espace de travail du projet et Planification stratégique Espace de travail.

Les widgets suivants sont disponibles dans Espace de travail du projet et Planification stratégique Espace de travail par défaut.

• Budget
• Estimation à l'achèvement
• Coût planifié
• Coût réel à ce jour

Vous pouvez utiliser l’include de script FinancialsWidgetUtil pour ajouter des widgets enfants qui affichent les valeurs pour une période ou un type de dépenses spécifié.

Figure 1. Section Finances dans Espace de travail du projet

Dans cet exemple de Espace de travail du projet, le widget Coût planifié comporte des widgets enfants qui affichent les valeurs CapEx et OpEx, tandis que le widget Budget n’en a pas.

Pour utiliser cet include de script, créez un widget enfant avec l’un des widgets financiers disponibles en tant que parent. Utilisez les méthodes de cet include de script dans le champ Script de l’enregistrement de widget enfant.

L’include de script FinancialsWidgetUtil nécessite l’application Financials Core (sn_invst_pln), ainsi que l’application (sn_apw_advanced) ou Espace de travail du projet l’application Planification stratégique (sn_pw). Cet include de script est fourni dans l’espace de noms sn_invst_pln .

FinancialsWidgetUtil : FinancialsWidgetUtil(GlideRecord investmentGr, Object timeScope, String expenseType)

Instancie un objet FinancialsWidgetUtil .

Cet objet est utilisé pour obtenir des valeurs agrégées telles que le budget et le coût planifié d’un investissement.

Tableau 1. Paramètres

Nom	Type	Description
investmentGr	GlideRecord	Investissement pour obtenir des valeurs agrégées pour. Tableau : Investissement [sn_invst_pln_invst_investment]
timeScope	Objet	Liste des périodes fiscales à utiliser comme dates de début et de fin pour l’agrégation. { "startFiscalPeriodSysId": "String", "endFiscalPeriodSysId": "String" }
timeScope.startFiscalPeriodSysId	Chaîne	Sys_id de la période fiscale à utiliser comme date de début de l’agrégation. Tableau : Période fiscale [fiscal_period]
timeScope.endFiscalPeriodSysId	Chaîne	Sys_id de la période fiscale à utiliser comme date de fin de l’agrégation. Tableau : Période fiscale [fiscal_period]
expenseType	Chaîne	Facultatif. Type de dépense à inclure dans l’agrégation, comme les dépenses d’investissement (CapEx) ou les charges d’exploitation (OpEx). Valeurs valides : Capex Dépense d’exploitation

Cet exemple instancie un objet FinancialsWidgetUtil qui peut être utilisé pour renvoyer des valeurs agrégées pour un investissement où le type de dépense est CapEx et la période est 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()

Renvoie le coût réel de tous les éléments de planification et de travail liés à un investissement.

Pour utiliser cette méthode, créez un widget enfant avec le bouton Coût réel à ce jour widget en tant que parent Utilisez cette méthode dans le champ Script de l’enregistrement de widget enfant.

Le coût réel renvoyé par cette méthode correspond à la période et au type de dépenses spécifiés lors de l’instanciation de l’objet FinancialsWidgetUtil .

Tableau 2. Paramètres

Nom	Type	Description
Aucun

Tableau 3. Renvoie

Type	Description
Objet	Objet contenant la valeur d’affichage et la valeur du coût réel. { "displayValue": "String", "value": Number }
<Object>.displayValue	Valeur d’affichage du coût réel, par exemple 1,00 K$. Type de données : chaîne
<Object>.valeur	Valeur du coût réel, par exemple 1 000. Type de données : nombre

Cet exemple ajoute un widget enfant au widget Coût réel à ce jour qui affiche le coût réel pour Opex uniquement.

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

Renvoie le budget pour tous les éléments de planification et les éléments de travail liés à un investissement.

Pour utiliser cette méthode, créez un widget enfant avec le bouton Budget widget en tant que parent Utilisez cette méthode dans le champ Script de l’enregistrement de widget enfant.

Le budget renvoyé par cette méthode correspond à la période et au type de dépenses spécifiés lors de l’instanciation de l’objet FinancialsWidgetUtil .

Tableau 4. Paramètres

Nom	Type	Description
Aucun

Tableau 5. Renvoie

Type	Description
Objet	Objet contenant la valeur d’affichage et la valeur du budget. { "displayValue": "String", "value": Number }
<Object>.displayValue	Valeur d’affichage du budget, par exemple 2,50 K$. Type de données : chaîne
<Object>.valeur	Valeur du budget, par exemple 2 500. Type de données : nombre

Cet exemple ajoute un widget enfant au widget Budget qui affiche le budget pour OpEx uniquement.

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

Renvoie la valeur d’estimation à l’achèvement (CAE) pour tous les éléments de planification et les éléments de travail liés à un investissement.

Pour utiliser cette méthode, créez un widget enfant avec le bouton Estimation à l’achèvement widget en tant que parent Utilisez cette méthode dans le champ Script de l’enregistrement de widget enfant.

Valeur CAE renvoyé par cette méthode correspond à la période et au type de dépenses spécifiés lors de l’instanciation de l’objet FinancialsWidgetUtil .

Tableau 6. Paramètres

Nom	Type	Description
Aucun

Tableau 7. Renvoie

Type	Description
Objet	Objet contenant la valeur d’affichage et la valeur de CAE. { "displayValue": "String", "value": Number }
<Object>.displayValue	Valeur d’affichage de l’EAC, telle que 2,38 K$. Type de données : chaîne
<Object>.valeur	Valeur de l’EAC, par exemple 2380. Type de données : nombre

Cet exemple ajoute un widget enfant au widget Estimation à l’achèvement qui affiche le CAE pour Opex uniquement.

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

Renvoie le coût planifié pour tous les éléments de planification et les éléments de travail liés à un investissement.

Pour utiliser cette méthode, créez un widget enfant avec le bouton Coût planifié widget en tant que parent Utilisez cette méthode dans le champ Script de l’enregistrement de widget enfant.

Le coût planifié renvoyé par cette méthode correspond à la période et au type de dépenses spécifiés lors de l’instanciation de l’objet FinancialsWidgetUtil .

Tableau 8. Paramètres

Nom	Type	Description
Aucun

Tableau 9. Renvoie

Type	Description
Objet	Objet contenant la valeur d’affichage et la valeur du coût planifié. { "displayValue": "String", "value": Number }
<Object>.displayValue	Valeur d’affichage du coût planifié, par exemple 4,05 K$. Type de données : chaîne
<Object>.valeur	Valeur du coût planifié, par exemple 4 050. Type de données : nombre

Cet exemple ajoute un widget enfant au widget Coût planifié qui affiche uniquement le coût planifié pour 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
      };
   }
})();