Descreve a função do Smart View, HsGetValue.
Tipos de origem de dados na nuvem: Oracle Essbase, Planning, Módulos do Planning, Financial Consolidation and Close, Tax Reporting, Narrative Reporting
Tipos de origem de dados locais: Oracle Essbase, Oracle Hyperion Financial Management, Oracle Hyperion Planning
Descrição
HsGetValue recupera dados na origem de dados dos membros selecionados de uma dimensão de um Ponto de Vista (PDV).
Quando HsGetValue não recupera dados, o valor especificado para a opção de substituição #NoData/Missing Label é usado (consulte Tabela 5-7).
Quando os usuários selecionarem as opções Atualizar ou Atualizar Tudo, somente a função HsGetValue será chamada. Quando os usuários selecionarem a opção Enviar, a função HsSetValue será chamada primeiro, e HsGetValue só será chamada se HsSetValue for retornada com sucesso.
A função HsGetValue suporta o uso de uma dimensão de atributo e um membro com as origens de dados do Essbase. No Oracle Smart View for Office 11.1.2.5.710+, HsGetValue amplia o suporte de atributo a origens de dados do Planning, do Planning Modules, do Financial Consolidation and Close, do Tax Reporting (consulte Exemplo 18-2).
No Smart View 11.1.2.5.720+, é possível usar HsGetValue para retornar tipos de dados enumerados, como Smart List, texto e datas (consulte Exemplo 18-3).
Com o Narrative Reporting 24.02 ou versões posteriores, a atualização iniciada pelo servidor é compatível com funções HsGetValue() criadas com referências de células do Excel.
Sintaxe
Conexão privada:
HsGetValue("PrivateConnectionName","POV")
Conexão compartilhada:
HsGetValue("WSFN|ProviderType|Server|Application|Database","POV")
Conexão do URL:
HsGetValue("URLFN|URL|Server|Application|Database","POV")
Para obter informações sobre sintaxe, consulte Como Criar Funções Manualmente.
Exemplo 18-1 Exemplo sem Atributo
Tipos de origem de dados na nuvem: Essbase, Planning, Módulos do Planning, Financial Consolidation and Close, Tax Reporting, Narrative Reporting
Tipos de origem de dados locais: Essbase, Financial Management, Planning
Neste exemplo, HsGetValue retorna o valor do aplicativo HFM01 para o PDV padrão.
Conexão privada:
=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")
Conexão compartilhada:
=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")
Conexão do 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")
Exemplo 18-2 Exemplo com Atributo
Tipos de origem de dados na nuvem: Essbase, Planning, Módulos do Planning, Financial Consolidation and Close, Tax Reporting
Tipos de origem de dados locais: Essbase
Neste exemplo, HsGetValue retorna o valor do aplicativo Vision, banco de dados Plan1, e o PDV inclui uma dimensão de atributo e um membro, Entity_Regions#NA_Reg.
Nota:
A função HsGetValue só suporta uma dimensão de atributo e um membro por função.
Conexão privada:
=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")
Conexão compartilhada:
=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")
Conexão do 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")
Exemplo 18-3 Exemplo com Smart List
Tipos de origem de dados em nuvem: Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting
Neste exemplo, HsGetValue retorna um valor de Smart List do aplicativo Vision, banco de dados Plan1. Nesse caso, a Smart List está procurando o valor Driver para Limpeza e Manutenção. Os valores que podem ser retornados são "% de Receita", "Unidades", "Horas de FTE", "Chamadas de Vendas", "Viagens", "Pés Quadrados" e "Nenhum".
Conexão privada:
=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")
Conexão compartilhada:
=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")
Conexão do 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")
Exemplo 18-4 Exemplo com Referência de Célula para Conexão de Origem de Dados
Para funções HsGetValue criadas com referências de células para conexões de origens de dados, no arquivo do Excel, defina a conexão para a função usando o formato de conexão de URL:
URLFN|URL:Port|Server|Application|Database
Nota:
Caso sua pasta de trabalho contenha funções HsGetValue que usam referências de células que apontam para um nome de conexão privada, esteja ciente de que as conexões privadas não são portáteis entre máquinas e, portanto, não são suportadas pela atualização iniciada pelo servidor. A Oracle recomenda que você converta essas funções para usarem o formato URLFN.
Para o exemplo a seguir, parta do princípio de que a célula B1 contém informações de conexão. Especifique as informações de conexão no seguinte formato, com prefixo URLFN:
URLFN|http://<serviceURL>:<port>/HyperionPlanning/SmartView|<serverName>|App|Database
Em seguida, crie a função com o parâmetro de conexão referenciando a célula B1, da seguinte forma:
=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")