Descrive la funzione HsGetValue di Smart View.
Tipi di origini dati cloud: Oracle Essbase, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting, Narrative Reporting
Tipi di origini dati locali: Oracle Essbase, Oracle Hyperion Financial Management, Oracle Hyperion Planning
Descrizione
HsGetValue recupera i dati dall'origine dati per i membri dimensione selezionati di un punto di vista (POV).
Se HsGetValue non recupera alcun dato, viene utilizzato il valore specificato per l'opzione di sostituzione Etichetta #NoData/Missing (fare riferimento a Tabella 5-7).
Quando l'utente seleziona Aggiorna o Aggiorna tutto, viene chiamata solo la funzione HsGetValue. Quando l'utente seleziona Sottometti, viene chiamata prima la funzione HsSetValue e quindi, se tale funzione viene completata correttamente, viene chiamata la funzione HsGetValue.
La funzione HsGetValue supporta l'utilizzo di una dimensione attributo e un membro attributo con le origini dati Essbase. In Oracle Smart View for Office 11.1.2.5.710+, HsGetValue estende il supporto degli attributi alle origini dati Planning, Moduli Planning, Financial Consolidation and Close, Oracle Tax Reporting Cloud (fare riferimento alla sezione Esempio 18-2).
In Smart View 11.1.2.5.720+, la funzione HsGetValue può essere utilizzata per restituire tipi di dati enumerati, ad esempio smartlist, testo e date (fare riferimento a Esempio 18-3).
Con Narrative Reporting 24.02 e versioni successive, l'aggiornamento avviato dal server è supportato per le funzioni HsGetValue() create con riferimenti di cella di Excel.
Sintassi
Connessione privata:
HsGetValue("PrivateConnectionName","POV")
Connessione condivisa:
HsGetValue("WSFN|ProviderType|Server|Application|Database","POV")
Connessione URL:
HsGetValue("URLFN|URL|Server|Application|Database","POV")
Per informazioni dettagliate sulla sintassi, vedere Creazione manuale di funzioni.
Esempio 18-1 Esempio senza attributo
Tipi di origini dati cloud: Essbase, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting, Narrative Reporting
Tipi di origini dati locali: Essbase, Financial Management, Planning
In questo esempio, HsGetValue restituisce il valore dall'applicazione HFM01 per il POV predefinito.
Connessione privata:
=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")
Connessione condivisa:
=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")
Connessione URL:
=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")
Esempio 18-2 Esempio con attributo
Tipi di origini dati cloud: Essbase, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting
Tipi di origini dati locali: Essbase
In questo esempio la funzione HsGetValue restituisce il valore dall'applicazione Vision, database Plan1, e il POV include una dimensione attributo e un membro attributo, ovvero Entity_Regions#NA_Reg.
Nota:
La funzione HsGetValue supporta solo una dimensione attributo e un membro attributo per funzione.
Connessione privata:
=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")
Connessione condivisa:
=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")
Connessione URL:
=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")
Esempio 18-3 Esempio con smartlist
Tipi di origini dati cloud: Planning, Moduli Planning, Financial Consolidation and Close, Tax Reporting
In questo esempio la funzione HsGetValue restituisce un valore di smartlist dall'applicazione Vision, database Plan1. In questo caso lo smartlist cerca il valore Driver per "Cleaning and Maintenance". I valori che possono essere restituiti sono "% ricavi", "Unità", "Ore FTE", "Visite di vendita", "Viaggi", "Piedi quadrati" e "Nessuno".
Connessione privata:
=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")
Connessione condivisa:
=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")
Connessione URL:
=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")Esempio 18-4 Esempio con riferimento cella alla connessione a un'origine dati
Per le funzioni HsGetValue create con riferimenti di cella a connessioni origini dati, nel file Excel, definire la connessione per la funzione utilizzando il formato di connessione URL:
URLFN|URL:Port|Server|Application|Database
Nota:
Se la cartella di lavoro contiene funzioni HsGetValue che utilizzano riferimenti di cella che puntano al nome di una connessione privata, tenere conto che le connessioni private non sono trasportabili da un computer all'altro e pertanto non sono supportate dall'aggiornamento avviato dal server. Oracle consiglia di convertire tali funzioni in modo da utilizzare il formato URLFN.
Per l'esempio riportato di seguito, si supponga che la cella B1 contenga informazioni per la connessione. Immettere le informazioni per la connessione nel formato seguente, anteponendo il prefisso URLFN:
URLFN|http://<serviceURL>:<port>/HyperionPlanning/SmartView|<serverName>|App|Database
Creare quindi la funzione in modo che il parametro di connessione faccia riferimento alla cella B1, come indicato di seguito:
=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")