FinancialsWidgetUtil – Umfang

Die FinancialsWidgetUtil Die Skripteinbindung bietet Methoden zum Anpassen von Widgets in Finanzen Abschnitt von Projektarbeitsbereich Und Strategische Planung Arbeitsbereich.

Die folgenden Widgets sind in verfügbar Projektarbeitsbereich Und Strategische Planung Arbeitsbereich Standardmäßig.

• Budget
• Erwartete Gesamtkosten bei Fertigstellung
• Geplante Kosten
• Ist-Kosten bis heute

Sie können verwenden FinancialsWidgetUtil Skripteinbindung zum Hinzufügen untergeordneter Widgets, die Werte für einen bestimmten Zeitraum oder Ausgabentyp anzeigen.

Abbildung : 1. Abschnitt „Finanzen“ in Projektarbeitsbereich

In diesem Beispiel von Projektarbeitsbereich, Das Widget „geplante Kosten“ hat untergeordnete Widgets, die Investitionsaufwand- und Betriebsausgaben-Werte anzeigen, während das Widget „Budget“ keine untergeordneten Widgets hat.

So verwenden Sie diese Skripteinbindung: Erstellen Sie ein untergeordnetes Widget Mit einem der verfügbaren Finanz-Widgets als übergeordnetes Element. Verwenden Sie die Methoden aus dieser Skripteinbindung in Skript Feld des untergeordneten Widget-Datensatzes.

Die FinancialsWidgetUtil Die Skripteinbindung erfordert die Anwendung Financials Core (sn_invst_pln) sowie die Strategische Planung Anwendung (sn_apw_Advanced) oder Projektarbeitsbereich Anwendung (sn_pw). Diese Skripteinbindung wird in bereitgestellt sn_invst_pln Namespace.

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

Instanziiert einen FinancialsWidgetUtil Objekt.

Dieses Objekt wird verwendet, um Aggregatwerte wie Budget und geplante Kosten für eine Investition abzurufen.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
InvestitionGr	GlideRecord	Investition, für die Aggregatwerte abgerufen werden sollen. Tabelle: Investition [sn_invst_pln_invst_Investment]
timeScope	Objekt	Liste der Geschäftsperioden, die als Start- und Enddatum für die Zusammenfassung verwendet werden sollen. { "startFiscalPeriodSysId": "String", "endFiscalPeriodSysId": "String" }
TimeScope.startFiskalPeriodSysId	Zeichenfolge	SYS_ID der Geschäftsperiode, die als Startdatum für die Zusammenfassung verwendet werden soll. Tabelle: Geschäftsperiode [fiscal_period]
TimeScope.endFiskalPeriodSysId	Zeichenfolge	SYS_ID der Geschäftsperiode, die als Enddatum für die Zusammenfassung verwendet werden soll. Tabelle: Geschäftsperiode [fiscal_period]
ExpenseType	Zeichenfolge	Optional. Typ der Ausgabe, die in die Zusammenfassung aufgenommen werden soll, z. B. Investitionsausgaben (Investitionsaufwand) oder Betriebsausgaben (Betriebsausgaben). Gültige Werte: investitionsaufwand betriebsausgaben

In diesem Beispiel wird ein instanziiert FinancialsWidgetUtil Objekt, das verwendet werden kann, um Aggregatwerte für eine Investition zurückzugeben, bei der der Ausgabentyp Investitionsaufwand und der Zeitraum ist Kontext.Zeitumfang .

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

Gibt die ist-Kosten für alle Planungselemente und Arbeitselemente zurück, die mit einer Investition verknüpft sind.

So verwenden Sie diese Methode: Erstellen Sie ein untergeordnetes Widget Mit Ist-Kosten bis heute Widget als übergeordnetes Element. Verwenden Sie diese Methode in Skript Feld des untergeordneten Widget-Datensatzes.

Die ist-Kosten Von dieser Methode zurückgegeben wird für den Zeitraum und den Ausgabentyp, der beim Instanziieren von angegeben wurde FinancialsWidgetUtil Objekt.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 3. Ergebnisse

Typ	Beschreibung
Objekt	Objekt, das den Anzeigewert und den Wert für die ist-Kosten enthält. { "displayValue": "String", "value": Number }
<Object>.DisplayValue	Anzeigewert der ist-Kosten, z. B. 1,00 000 USD . Datentyp: Zeichenfolge
<Object>.Wert	Wert der ist-Kosten, z. B. 1000 . Datentyp: Zahl

In diesem Beispiel wird dem Widget „ist-Kosten bis heute“ ein untergeordnetes Widget hinzugefügt, das nur die ist-Kosten für Betriebsausgaben anzeigt.

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

Gibt das Budget für alle Planungselemente und Arbeitselemente zurück, die mit einer Investition verknüpft sind.

So verwenden Sie diese Methode: Erstellen Sie ein untergeordnetes Widget Mit Budget Widget als übergeordnetes Element. Verwenden Sie diese Methode in Skript Feld des untergeordneten Widget-Datensatzes.

Das Budget Von dieser Methode zurückgegeben wird für den Zeitraum und den Ausgabentyp, der beim Instanziieren von angegeben wurde FinancialsWidgetUtil Objekt.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 5. Ergebnisse

Typ	Beschreibung
Objekt	Objekt, das den Anzeigewert und den Wert für das Budget enthält. { "displayValue": "String", "value": Number }
<Object>.DisplayValue	Anzeigewert des Budgets, z. B. 2,50 000 USD . Datentyp: Zeichenfolge
<Object>.Wert	Wert des Budgets, z. B. 2500 . Datentyp: Zahl

In diesem Beispiel wird dem Budget-Widget ein untergeordnetes Widget hinzugefügt, das das Budget nur für Betriebsausgaben anzeigt.

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

Gibt den EAC-Wert (EAC) für alle Planungselemente und Arbeitselemente zurück, die mit einer Investition verknüpft sind.

So verwenden Sie diese Methode: Erstellen Sie ein untergeordnetes Widget Mit Schätzung bei Abschluss Widget als übergeordnetes Element. Verwenden Sie diese Methode in Skript Feld des untergeordneten Widget-Datensatzes.

Der EAC-Wert Von dieser Methode zurückgegeben wird für den Zeitraum und den Ausgabentyp, der beim Instanziieren von angegeben wurde FinancialsWidgetUtil Objekt.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 7. Ergebnisse

Typ	Beschreibung
Objekt	Objekt, das den Anzeigewert und den Wert für die EAC enthält. { "displayValue": "String", "value": Number }
<Object>.DisplayValue	Anzeigewert der EAC, z. B. 2,38 000 USD . Datentyp: Zeichenfolge
<Object>.Wert	Wert der EAC, z. B. 2380 . Datentyp: Zahl

In diesem Beispiel wird dem Widget „Schätzung bei Abschluss“ ein untergeordnetes Widget hinzugefügt, das den EAC nur für Betriebsausgaben anzeigt.

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

Gibt die geplanten Kosten für alle Planungselemente und Arbeitselemente zurück, die mit einer Investition verknüpft sind.

So verwenden Sie diese Methode: Erstellen Sie ein untergeordnetes Widget Mit Geplante Kosten Widget als übergeordnetes Element. Verwenden Sie diese Methode in Skript Feld des untergeordneten Widget-Datensatzes.

Die geplanten Kosten Von dieser Methode zurückgegeben wird für den Zeitraum und den Ausgabentyp, der beim Instanziieren von angegeben wurde FinancialsWidgetUtil Objekt.

Tabelle : 8. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 9. Ergebnisse

Typ	Beschreibung
Objekt	Objekt, das den Anzeigewert und den Wert für die geplanten Kosten enthält. { "displayValue": "String", "value": Number }
<Object>.DisplayValue	Anzeigewert der geplanten Kosten, z. B. 4,05 000 USD . Datentyp: Zeichenfolge
<Object>.Wert	Wert der geplanten Kosten, z. B. 4050 . Datentyp: Zahl

In diesem Beispiel wird dem Widget „geplante Kosten“ ein untergeordnetes Widget hinzugefügt, das nur die geplanten Kosten für Betriebsausgaben anzeigt.

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