Describe la función de Smart View, HsGetValue.
Tipos de orígenes de datos en la nube: Oracle Essbase, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting, Narrative Reporting
Tipos de orígenes de datos locales: Oracle Essbase, Oracle Hyperion Financial Management, Oracle Hyperion Planning
Descripción
HsGetValue recupera los datos del origen de datos para los miembros de dimensión seleccionados de un punto de vista (PDV).
Cuando HsGetValue no recupera ningún dato, se utiliza el valor especificado para la opción de reemplazo #Sin datos/Falta etiqueta (consulte la Tabla 5-7).
Cuando los usuarios seleccionan Actualizar o Actualizar todo, sólo se activa HsGetValue. Cuando los usuarios seleccionan Enviar, se activa HsSetValue primero y solo se activa HsGetValue si HsSetValue se ejecuta correctamente.
La función HsGetValue soporta el uso de una dimensión y miembro de atributo con orígenes de datos de Essbase. En Oracle Smart View for Office 11.1.2.5.710+, HsGetValue amplía el soporte de atributos a orígenes de datos de Planning, Módulos de Planning, Financial Consolidation and Close, Tax Reporting (consulte Ejemplo 18-2).
En Smart View 11.1.2.5.720+, se puede utilizar HsGetValue para devolver tipos de datos enumerados, como lista inteligente, texto y fecha (consulte Ejemplo 18-3).
Con Narrative Reporting 24.02+, el refrescamiento iniciado por servidor está soportado para las funciones HsGetValue() creadas con referencias de celdas de Excel.
Sintaxis
Conexiones privadas:
HsGetValue("PrivateConnectionName","POV")
Conexiones compartidas:
HsGetValue("WSFN|ProviderType|Server|Application|Database","POV")
Conexión URL:
HsGetValue("URLFN|URL|Server|Application|Database","POV")
Para obtener información de sintaxis detallada, consulte Creación manual de funciones.
Ejemplo 18-1 Ejemplo sin atributo
Tipos de orígenes de datos en la nube: Essbase, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting, Narrative Reporting
Tipos de orígenes de datos locales: Essbase, Financial Management y Planning
En este ejemplo, HsGetValue devuelve el valor de la aplicación HFM01 para el PDV por defecto.
Conexiones privadas:
=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")
Conexiones compartidas:
=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")
Conexión 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")
Ejemplo 18-2 Ejemplo con atributo
Tipos de orígenes de datos en la nube: Essbase, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting
Tipos de orígenes de datos locales: Essbase
En este ejemplo, HsGetValue devuelve el valor de la aplicación Vision de la base de datos Plan1. Además, el PDV incluye una dimensión y un miembro de atributo, Entity_Regions#NA_Reg.
Nota:
HsGetValue solo soporta una dimensión y un miembro de atributo por función.
Conexiones privadas:
=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")
Conexiones compartidas:
=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")
Conexión 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")
Ejemplo 18-3 Ejemplo con listas inteligentes
Tipos de orígenes de datos en la nube: Planning, Módulos de Planning, Financial Consolidation and Close, Tax Reporting
En este ejemplo, HsGetValue devuelve un valor de lista inteligente de la aplicación Vision, de la base de datos Plan1. La lista inteligente en este caso está buscando el valor Driver para Cleaning and Maintenance. Los valores posibles que se pueden devolver son "% of Revenue", "Units", "FTE Hours", "Sales Calls", "Trips", "Square Feet" y "None".
Conexiones privadas:
=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")
Conexiones compartidas:
=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")
Conexión 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")
Ejemplo 18-4 Ejemplo con conexión de referencia de celda a origen de datos
Para las funciones HsGetValue creadas con referencias de celdas a conexiones de origen de datos, en el archivo de Excel, defina la conexión para la función utilizando el formato de conexión URL:
URLFN|URL:Port|Server|Application|Database
Nota:
Si el libro contiene funciones HsGetValue que utilicen referencias de celdas que apunten a un nombre de conexión privada, tenga en cuenta que las conexiones privadas no son portátiles entre máquinas, por lo que no están soportadas en un refrescamiento iniciado por servidor. Oracle recomienda que convierta esas funciones para que utilicen el formato URLFN.
Para el siguiente ejemplo, suponga que la celda B1 contiene información de conexión. Introduzca la información de conexión en el siguiente formato con URLFN como prefijo:
URLFN|http://<serviceURL>:<port>/HyperionPlanning/SmartView|<serverName>|App|Database
Después, cree la función con el parámetro de conexión haciendo referencia a la celda B1, como se muestra a continuación:
=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")