FinancialsWidgetUtil – Scoped

Die FinancialsWidgetUtil -API kann zum Anpassen von Widgets im Abschnitt „Finanzen“ von Projektarbeitsbereich und Strategische Planung Arbeitsbereichverwendet werden.

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

• Budget
• Erwartete Gesamtkosten bei Fertigstellung
• Geplante Kosten
• Tatsächliche Kosten bis heute

Die FinancialsWidgetUtil -API kann verwendet werden, um untergeordnete Widgets hinzuzufügen, die Werte für einen bestimmten Zeitraum oder Ausgabentyp anzeigen.

Abbildung : 1. Abschnitt „Finanzen“ in Projektarbeitsbereich

In diesem Beispiel von Projektarbeitsbereichverfügt das Widget „Geplante Kosten“ über untergeordnete Widgets, die Werte für Investitionsaufwand und Betriebsausgaben anzeigen, während das Widget „Budget“ keine untergeordneten Widgets aufweist.

Um diese API zu verwenden, erstellen Sie ein untergeordnetes Widget mit einem der verfügbaren Finanz-Widgets als übergeordnetes Element. Verwenden Sie die Methoden aus dieser API im Skriptfeld des untergeordneten Widget-Datensatzes.

Die FinancialsWidgetUtil -API erfordert die Anwendung Financials Core (sn_invst_pln) sowie die Anwendung Strategische Planung (sn_apw_advanced) oder die Anwendung Projektarbeitsbereich (sn_pw). Diese API wird innerhalb des Namespace sn_invst_pln bereitgestellt.

FinancialsWidgetUtil – FinancialsWidgetUtil(GlideRecord InvestmentGr, Object TimeScope, String ExpenseType)

Instantiiert ein FinancialsWidgetUtil -Objekt.

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

Tabelle : 1. Parameter

Name	Typ	Beschreibung
InvestmentGr	GlideRecord	Investition, für die zusammengefasste Werte abgerufen werden sollen. Befindet sich in der Tabelle „Investition“ [sn_invst_pln_invst_investment].
timeScope	Objekt	Objekt mit den Geschäftsperioden, die als Start- und Enddatum für die Zusammenfassung verwendet werden sollen. { "startFiscalPeriodSysId": "String", "endFiscalPeriodSysId": "String" }
timeScope.startFiscalPeriodSysId	Zeichenfolge	Sys_id der Geschäftsperiode, die als Startdatum für die Zusammenfassung verwendet werden soll. Befindet sich in der Tabelle „Geschäftsperiode“ [fiscal_period].
timeScope.endFiscalPeriodSysId	Zeichenfolge	Sys_id der Geschäftsperiode, die als Enddatum für die Zusammenfassung verwendet werden soll. Befindet sich in der Tabelle „Geschäftsperiode“ [fiscal_period].
ExpenseType	Zeichenfolge	Optional. Typ der Ausgaben, die in die Zusammenfassung aufgenommen werden sollen, z. B. Investitionsaufwand (CapEx) oder Betriebsausgaben (OpEx). Gültige Werte: Investitionsaufwand Betriebsausgaben

In diesem Beispiel wird ein FinancialsWidgetUtil -Objekt instanziiert, das verwendet werden kann, um zusammengefasste Werte für eine Investition zurückzugeben, bei der der Ausgabentyp CapEx und der Zeitraum context.timeScopeist.

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 tatsächlichen Kosten für alle Planungselemente und Arbeitselemente zurück, die mit einer Investition verknüpft sind.

Um diese Methode zu verwenden, erstellen Sie ein untergeordnetes Widget mit dem Tatsächliche Kosten bis heute -Widget als übergeordnetes Element. Verwenden Sie diese Methode im Feld Skript des untergeordneten Widget-Datensatzes.

Tatsächliche Kosten von dieser Methode zurückgegebene X bezieht sich auf den Zeitraum und den Ausgabentyp, die bei der Instanziierung des FinancialsWidgetUtil -Objekts angegeben wurden.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 3. Ergebnisse

Typ	Beschreibung
Objekt	Objekt mit dem Anzeigewert und dem Wert für die tatsächlichen Kosten. { "displayValue": "String", "value": Number }
<Object>.Anzeigewert	Anzeigewert der tatsächlichen Kosten, z. B. 1,00 $. Datentyp: Zeichenfolge
<Object>.Wert	Wert der tatsächlichen Kosten, z. B. 1000. Datentyp: Zahl

In diesem Beispiel wird dem Widget „Tatsächliche Kosten bis heute“ ein untergeordnetes Widget hinzugefügt, das die tatsächlichen Kosten 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').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.

Um diese Methode zu verwenden, erstellen Sie ein untergeordnetes Widget mit dem Budget -Widget als übergeordnetes Element. Verwenden Sie diese Methode im Feld Skript des untergeordneten Widget-Datensatzes.

Das Budget von dieser Methode zurückgegebene X bezieht sich auf den Zeitraum und den Ausgabentyp, die bei der Instanziierung des FinancialsWidgetUtil -Objekts angegeben wurden.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 5. Ergebnisse

Typ	Beschreibung
Objekt	Objekt mit dem Anzeigewert und dem Wert für das Budget. { "displayValue": "String", "value": Number }
<Object>.Anzeigewert	Anzeigewert des Budgets, z. B. 2,50 $. Datentyp: Zeichenfolge
<Object>.Wert	Wert des Budgets, z. B. 2500. Datentyp: Zahl

In diesem Beispiel wird dem Widget „Budget“ ein untergeordnetes Widget hinzugefügt, das nur das Budget 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 (Estimate at Completion) für alle Planungselemente und Arbeitselemente zurück, die mit einer Investition verknüpft sind.

Um diese Methode zu verwenden, erstellen Sie ein untergeordnetes Widget mit dem Schätzung bei Abschluss -Widget als übergeordnetes Element. Verwenden Sie diese Methode im Feld Skript des untergeordneten Widget-Datensatzes.

Der BK-Wert von dieser Methode zurückgegebene X bezieht sich auf den Zeitraum und den Ausgabentyp, die bei der Instanziierung des FinancialsWidgetUtil -Objekts angegeben wurden.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 7. Ergebnisse

Typ	Beschreibung
Objekt	Objekt, das den Anzeigewert und den Wert für das BK enthält. { "displayValue": "String", "value": Number }
<Object>.Anzeigewert	Anzeigewert des BK, z. B. $2,38 T. Datentyp: Zeichenfolge
<Object>.Wert	Wert des BK, z. B. 2380. Datentyp: Zahl

In diesem Beispiel wird dem Widget „Erwartete Gesamtkosten bei Abschluss“ ein untergeordnetes Widget hinzugefügt, das die BK 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.

Um diese Methode zu verwenden, erstellen Sie ein untergeordnetes Widget mit dem Geplante Kosten -Widget als übergeordnetes Element. Verwenden Sie diese Methode im Feld Skript des untergeordneten Widget-Datensatzes.

Die geplanten Kosten von dieser Methode zurückgegebene X bezieht sich auf den Zeitraum und den Ausgabentyp, die bei der Instanziierung des FinancialsWidgetUtil -Objekts angegeben wurden.

Tabelle : 8. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 9. Ergebnisse

Typ	Beschreibung
Objekt	Objekt mit dem Anzeigewert und dem Wert für die geplanten Kosten. { "displayValue": "String", "value": Number }
<Object>.Anzeigewert	Anzeigewert der geplanten Kosten, z. B. 4,05 $. 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
      };
   }
})();