FinancialsWidgetUtil : Bereichsbezogen

Die FinancialsWidgetUtil- Skripteinbindung bietet Methoden zum Anpassen von Widgets im Abschnitt „Financials“ von Projektarbeitsbereich und Strategische Planung Arbeitsbereich.

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

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

Sie können die Skripteinbindung FinancialsWidgetUtil verwenden, 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 Skripteinbindung zu verwenden, erstellen Sie ein untergeordnetes Widget mit einem der verfügbaren Finanz-Widgets als übergeordnetes Widget. Verwenden Sie die Methoden aus dieser Skripteinbindung im Feld Skript des untergeordneten Widget-Datensatzes.

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

FinancialsWidgetUtil – FinancialsWidgetUtil(GlideRecord InvestmentGr, Object timeScope, Zeichenfolgen-kostentyp)

Instanziiert ein FinancialsWidgetUtil- Objekt.

Dieses Objekt wird verwendet, um aggregierte Werte wie das Budget und die geplanten Kosten für eine Investition abzurufen.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Investitionsgr	GlideRecord	Investition, für die aggregierte Werte 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.startGeschäftsperiodeSysId	Zeichenfolge	Sys_id der Geschäftsperiode, die als Startdatum für die Zusammenfassung verwendet werden soll. Tabelle: Geschäftsperiode [fiscal_period]
timeScope.endFiscalPeriodSysId	Zeichenfolge	Sys_id der Geschäftsperiode, die als Enddatum für die Zusammenfassung verwendet werden soll. Tabelle: Geschäftsperiode [fiscal_period]
Spesentyp	Zeichenfolge	Optional. Typ der Ausgabe, die in die Zusammenfassung aufgenommen werden soll, z. B. Investitionsaufwand oder Betriebskosten. Gültige Werte: Investitionsaufwand Betriebsausgaben

In diesem Beispiel wird ein FinancialsWidgetUtil- Objekt instanziiert, mit dem aggregierte Werte für eine Investition zurückgegeben werden können, bei der der Ausgabentyp „CapEx“ und der Zeitraum „context.timeScope“ist.

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 Ist-Kosten bis heute “ als übergeordnetes Widget. Verwenden Sie diese Methode im Feld Skript des untergeordneten Widget-Datensatzes.

Ist-Kosten von dieser Methode zurückgegebene X steht für den Zeitraum und den Ausgabentyp, die beim Instanziieren 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 Ist-Kosten. { "displayValue": "String", "value": Number }
<Object>.displayValue	Anzeigewert der Ist-Kosten, z.  B. 1,00 Tsd $. 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 OpEx 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 “ als übergeordnetes Widget. Verwenden Sie diese Methode im Feld Skript des untergeordneten Widget-Datensatzes.

Das Budget von dieser Methode zurückgegebene X steht für den Zeitraum und den Ausgabentyp, die beim Instanziieren 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>.displayValue	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 Wert der Schätzung bei Abschluss (EAC) 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 Erwartete Gesamtkosten bei Fertigstellung “ als übergeordnetes Widget. Verwenden Sie diese Methode im Feld Skript des untergeordneten Widget-Datensatzes.

Der EAC-Wert von dieser Methode zurückgegebene X steht für den Zeitraum und den Ausgabentyp, die beim Instanziieren des FinancialsWidgetUtil- Objekts angegeben wurden.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 7. Ergebnisse

Typ	Beschreibung
Objekt	Objekt mit dem Anzeigewert und dem Wert für EAC. { "displayValue": "String", "value": Number }
<Object>.displayValue	Anzeigewert des BK, z. B. $2.38 K. Datentyp: Zeichenfolge
<Object>.Wert	Wert des EAC, z. B. 2380. Datentyp: Zahl

In diesem Beispiel wird dem Widget Schätzung bei Abschluss ein untergeordnetes Widget hinzugefügt, das nur EAC für OpEx 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 “ als übergeordnetes Widget. Verwenden Sie diese Methode im Feld Skript des untergeordneten Widget-Datensatzes.

Die geplanten Kosten von dieser Methode zurückgegebene X steht für den Zeitraum und den Ausgabentyp, die beim Instanziieren 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>.displayValue	Anzeigewert der geplanten Kosten, z. B. 4,05 T $. 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 OpEx 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
      };
   }
})();