HsGetValue

Beschreibt die Smart View-Funktion "HsGetValue".

Cloud-Datenquellentypen: Oracle Essbase, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting, Narrative Reporting

On-Premise-Datenquellentypen: Oracle Essbase, Oracle Hyperion Financial Management, Oracle Hyperion Planning

Beschreibung

HsGetValue ruft Daten aus der Datenquelle für ausgewählte Dimensionselemente eines POV (Point of View) ab.

Wenn HsGetValue keine Daten abruft, wird der Wert verwendet, der als Ersetzungsoption für das Label "#NoData/Missing" angegeben wurde (siehe Tabelle 5-7).

Wenn Benutzer die Option "Aktualisieren" oder "Alle Aktualisieren" wählen, wird ausschließlich die Funktion HsGetValue aufgerufen. Wenn Benutzer "Weiterleiten" auswählen, wird zuerst HsSetValue aufgerufen. HsGetValue wird nur dann aufgerufen, wenn die Rückgabe von HsSetValue erfolgreich ist.

Die HsGetValue-Funktion unterstützt die Verwendung einer Attribute-Dimension und eines Attribute-Elements mit Essbase-Datenquellen. In Oracle Smart View for Office 11.1.2.5.710+, erweitert HsGetValue die Attributunterstützung auf Planning, Planning-Modulanwendung, Financial Consolidation and Close und Tax Reporting-Datenquellen (siehe Beispiel 18-2).

HsGetValue kann in Smart View 11.1.2.5.720+ verwendet werden, um Aufzählungsdatentypen, wie z.B. Smart Lists, Text und Datumsangaben zurückzugeben (siehe Beispiel 18-3).

Mit Narrative Reporting 24.02+ wird die vom Server initiierte Aktualisierung für HsGetValue()-Funktionen unterstützt, die mit Excel-Zellreferenzen erstellt wurden.

Syntax

Private Verbindung:

HsGetValue("PrivateConnectionName","POV")

Gemeinsame Verbindung:

HsGetValue("WSFN|ProviderType|Server|Application|Database","POV")

URL-Verbindung:

HsGetValue("URLFN|URL|Server|Application|Database","POV")

Ausführliche Syntaxinformationen finden Sie unter Funktionen manuell erstellen.

Beispiel 18-1 Beispiel ohne Attribut

Cloud-Datenquellentypen: Essbase, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting, Narrative Reporting

On-Premise-Datenquellentypen: Essbase, Financial Management, Planning

In diesem Beispiel gibt HsGetValue den Wert aus der HFM01-Anwendung für den Standard-POV zurück.

Private Verbindung:

=HsGetValue("HFM01","Scenario#Actual","Year#2004","Period#July","View#YTD","Entity#UnitedStates.Connecticut","Value#USD","Account#Sales","ICP#[ICP None]","Custom1#GolfBalls","Custom2#Customer2","Custom3#[None]","Custom4#Increases")

Gemeinsame Verbindung:

=HsGetValue("WSFN|HFM|hfm_svr|HFM01|HFM01","Scenario#Actual","Year#2004","Period#July","View#YTD","Entity#UnitedStates.Connecticut","Value#USD","Account#Sales","ICP#[ICP None]","Custom1#GolfBalls","Custom2#Customer2","Custom3#[None]","Custom4#Increases")

URL-Verbindung:

=HsGetValue("URLFN|http://<servername:port>/hfmadf/../hfmadf/officeprovider|<servername:port>|HFM01|HFM01","Scenario#Actual","Year#2004","Period#July","View#YTD","Entity#UnitedStates.Connecticut","Value#USD","Account#Sales","ICP#[ICP None]","Custom1#GolfBalls","Custom2#Customer2","Custom3#[None]","Custom4#Increases")

Beispiel 18-2 Beispiel mit Attribut

Cloud-Datenquellentypen: Essbase, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting

On-Premise-Datenquellentypen: Essbase

In diesem Beispiel gibt HsGetValue den Wert aus der Vision-Anwendung, Plan1-Datenbank, zurück. Der POV enthält ein(e) Attribut-Dimension und -Element, Entity_Regions#NA_Reg.

Hinweis:

HsGetValue unterstützt nur ein(e) Attribute-Dimension und -Element pro Funktion.

Private Verbindung:

=HsGetValue("Vision","Account#Amount","Period#Jan","Years#2017","Scenario#Annual Contract","Version#Final","Entity#AR02-Argentina-IS_Adjustments","Package#Depreciation","Currency#Local Currency","Entity_Regions#NA_Reg")

Gemeinsame Verbindung:

=HsGetValue("WSFN|HP|serviceURL|Vision|Plan1","Account#Amount","Period#Jan","Years#2017","Scenario#Annual Contract","Version#Final","Entity#AR02-Argentina-IS_Adjustments","Package#Depreciation","Currency#Local Currency","Entity_Regions#NA_Reg")

URL-Verbindung:

=HsGetValue("URLFN|https://<servername:port>/HyperionPlanning/SmartView
|<servername:port>|Vision|Plan1","Account#Amount","Period#Jan","Years#2017","Scenario#Annual Contract","Version#Final","Entity#AR02-Argentina-IS_Adjustments","Package#Depreciation","Currency#Local Currency","Entity_Regions#NA_Reg")

Beispiel 18-3 Beispiel mit Smart List

Clouddatenquellentypen: Planning, Planning-Modulanwendung, Financial Consolidation and Close, Tax Reporting

In diesem Beispiel gibt HsGetValue einen Smart List-Wert aus der Vision-Anwendung, Plan1-Datenbank, zurück. Die Smart List sucht in diesem Fall nach dem Treiberwert für den Löschvorgang und die Verwaltung. Mögliche Werte, die zurückgegeben werden können, sind "% des Ertrags", "Einheiten", "FTE-Stunden", "Verkaufsgespräche", "Reisen", "Quadratmeter" und "Kein Wert".

Private Verbindung:

=HsGetValue("Vision","Account#7440: Cleaning and Maintenance","Period#x---------x","HSP_View#BaseData","Year#FY15","Scenario#Plan","Version#Driver","Entity#No Entity","Product#No Product")

Gemeinsame Verbindung:

=HsGetValue("WSFN|HP|serviceURL|Vision|Plan1","Account#7440: Cleaning and Maintenance","Period#x---------x","HSP_View#BaseData","Year#FY15","Scenario#Plan","Version#Driver","Entity#No Entity","Product#No Product")

URL-Verbindung:

=HsGetValue("URLFN|https://<servername:port>/HyperionPlanning/SmartView|<servername:port>|Vision|Plan1","Account#7440: Cleaning and Maintenance","Period#x---------x","HSP_View#BaseData","Year#FY15","Scenario#Plan","Version#Driver","Entity#No Entity","Product#No Product")

Beispiel 18-4 Beispiel mit Zellreferenz zu Datenquellenverbindung

Für HsGetValue-Funktionen, die mit Zellreferenzen zu Datenquellenverbindungen erstellt werden, definieren Sie in der Excel-Datei die Verbindung für die Funktion mit dem folgenden URL-Verbindungsformat:

URLFN|URL:Port|Server|Application|Database

Hinweis:

Beachten Sie Folgendes, wenn Ihre Arbeitsmappe HsGetValue-Funktionen mit Zellreferenzen enthält, die auf den Namen einer privaten Verbindung verweisen: Private Verbindungen sind nicht rechnerübergreifend portierbar und werden daher von der vom Server initiierten Aktualisierung nicht unterstützt. Oracle empfiehlt, dass Sie diese Funktionen in das URLFN-Format konvertieren.

Im folgenden Beispiel enthält die Zelle B1 Verbindungsinformationen. Geben Sie die Verbindungsinformationen im folgenden Format mit dem Präfix URLFN ein:

URLFN|http://<serviceURL>:<port>/HyperionPlanning/SmartView|<serverName>|App|Database

Erstellen Sie dann wie folgt die Funktion mit dem Verbindungsparameter, der Zelle B1 referenziert:

=HsGetValue(B1,"Scenario#Actual","Year#2004","Period#July","View#YTD","Entity#UnitedStates.Utah","Value#USD","Account#Sales","ICP#[ICP None]","Custom1#GolfBalls","Custom2#Customer2","Custom3#[None]","Custom4#Increases")