---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# FinancialsWidgetUtil -- Umfang

# FinancialsWidgetUtil -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer

Die FinancialsWidgetUtil Die Skripteinbindung bietet Methoden zum Anpassen von Widgets in Finanzen Abschnitt von ProjektarbeitsbereichUnd Strategische Planung Arbeitsbereich.  
Die folgenden Widgets sind in verfügbar ProjektarbeitsbereichUnd Strategische Planung ArbeitsbereichStandardmäßig.

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

{#FinancialsWidgetUtilScopedAPI__ul_hdz_bxw_21c}Sie können verwenden FinancialsWidgetUtil Skripteinbindung zum Hinzufügen untergeordneter Widgets, die Werte für einen angegebenen 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](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=yokohama&pubname=yokohama-it-business-management&ft:locale=en-US)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 Kernanwendung Finanzen (sn_invst_pln) sowie die Strategische PlanungAnwendung (sn_apw_Advanced) oder ProjektarbeitsbereichAnwendung (sn_pw). Diese Skripteinbindung wird in bereitgestellt `sn_invst_pln `Namespace.

## FinancialsWidgetUtil -- FinancialsWidgetUtil(GlideRecord investmentGr, Object timeScope, String expenseType) {#ariaid-title2}

Instanziiert einen FinancialsWidgetUtil Objekt.
Dieses Objekt wird verwendet, um Aggregatwerte wie Budget und geplante Kosten für eine Investition abzurufen.
{#FinWU-FinancialsWidgetUtil_O_O_S__table_f1z_33y_yzb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| InvestitionGr | [GlideRecord](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#c_GlideRecordScopedAPI "Der Umfang ist festgelegt GlideRecord API wird für Datenbankvorgänge verwendet.") | 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 \[Fiskalperiode\] |
| TimeScope.endFiskalPeriodSysId | Zeichenfolge | SYS_ID der Geschäftsperiode, die als Enddatum für die Zusammenfassung verwendet werden soll. Tabelle: Geschäftsperiode \[Fiskalperiode\] |
| 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 {#FinWU-FinancialsWidgetUtil_O_O_S__ul_cbz_s3z_yzb} |
[Tabelle : 1. Parameter]

{#FinWU-FinancialsWidgetUtil_O_O_S__table_f1z_33y_yzb}  
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() {#ariaid-title3}

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](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=yokohama&pubname=yokohama-it-business-management&ft:locale=en-US)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.
{#FinancialsWidgetUtil-getActuals__table_blj_t3y_yzb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 2. Parameter]

{#FinancialsWidgetUtil-getActuals__table_blj_t3y_yzb} {#FinancialsWidgetUtil-getActuals__table_xwh_m3y_yzb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Objekt, das den Anzeigewert und den Wert für die ist-Kosten enthält. { "displayValue": "String", "value": Number } |
| \<Object\>.Anzeigewert | Anzeigewert der ist-Kosten, z. B. `1,00 USD `. Datentyp: Zeichenfolge |
| \<Object\>.Wert | Wert der ist-Kosten, z. B. `1000 `. Datentyp: Zahl |
[Tabelle : 3. Rückgaben]

{#FinancialsWidgetUtil-getActuals__table_xwh_m3y_yzb}  
Dieses Beispiel fügt dem Widget „ist-Kosten bis heute" ein untergeordnetes Widget hinzu, 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() {#ariaid-title4}

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](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=yokohama&pubname=yokohama-it-business-management&ft:locale=en-US)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.
{#FinancialsWidgetUtil-getBudget__table_wwh_m3y_yzb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 4. Parameter]

{#FinancialsWidgetUtil-getBudget__table_wwh_m3y_yzb} {#FinancialsWidgetUtil-getBudget__table_xwh_m3y_yzb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Objekt, das den Anzeigewert und den Wert für das Budget enthält. { "displayValue": "String", "value": Number } |
| \<Object\>.Anzeigewert | Anzeigewert des Budgets, z. B. `2,50 USD `. Datentyp: Zeichenfolge |
| \<Object\>.Wert | Wert des Budgets, z. B. `2500 `. Datentyp: Zahl |
[Tabelle : 5. Rückgaben]

{#FinancialsWidgetUtil-getBudget__table_xwh_m3y_yzb}  
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() {#ariaid-title5}

Gibt den Wert der Schätzung bei Abschluss (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](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=yokohama&pubname=yokohama-it-business-management&ft:locale=en-US)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.
{#FinancialsWidgetUtil-getEAC__table_gbs_43y_yzb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 6. Parameter]

{#FinancialsWidgetUtil-getEAC__table_gbs_43y_yzb} {#FinancialsWidgetUtil-getEAC__table_xwh_m3y_yzb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Objekt, das den Anzeigewert und den Wert für die EAC enthält. { "displayValue": "String", "value": Number } |
| \<Object\>.Anzeigewert | Anzeigewert der EAC, z. B. `2,38 USD `. Datentyp: Zeichenfolge |
| \<Object\>.Wert | Wert der EAC, z. B. `2380 `. Datentyp: Zahl |
[Tabelle : 7. Rückgaben]

{#FinancialsWidgetUtil-getEAC__table_xwh_m3y_yzb}  
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() {#ariaid-title6}

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](https://www.servicenow.com/docs/access?context=configure-widget-project-financials&version=yokohama&pubname=yokohama-it-business-management&ft:locale=en-US)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.
{#FinancialsWidgetUtil-getPlannedCost__table_jzp_q3y_yzb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 8. Parameter]

{#FinancialsWidgetUtil-getPlannedCost__table_jzp_q3y_yzb} {#FinancialsWidgetUtil-getPlannedCost__table_xwh_m3y_yzb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Objekt, das den Anzeigewert und den Wert für die geplanten Kosten enthält. { "displayValue": "String", "value": Number } |
| \<Object\>.Anzeigewert | Anzeigewert der geplanten Kosten, z. B. `4,05 USD `. Datentyp: Zeichenfolge |
| \<Object\>.Wert | Wert der geplanten Kosten, z. B. `4050 `. Datentyp: Zahl |
[Tabelle : 9. Rückgaben]

{#FinancialsWidgetUtil-getPlannedCost__table_xwh_m3y_yzb}  
Dieses Beispiel fügt dem Widget „geplante Kosten" ein untergeordnetes Widget hinzu, 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
          };
       }
    })();


