Smart View関数HsGetValueについて説明します。
クラウド・データ・ソース・タイプ: Oracle Essbase、Planning、Planningモジュール、Financial Consolidation and Close、Tax Reporting、Narrative Reporting
オンプレミス・データ・ソース・タイプ: Oracle Essbase、 Oracle Hyperion Financial Management、Oracle Hyperion Planning
説明
HsGetValueは、視点(POV)の選択したディメンション・メンバーのデータ・ソースからデータを取得します。
HsGetValueでデータが取得されない場合、#NoData/Missingラベル置換オプションで指定された値が使用されます(表5-7を参照してください)。
ユーザーが「リフレッシュ」または「すべてリフレッシュ」を選択した場合は、HsGetValueのみ呼び出されます。ユーザーが「送信」を選択した場合は、最初にHsSetValueが呼び出され、HsSetValueが正常に戻った場合にのみHsGetValueが呼び出されます。
HsGetValue関数は、Essbaseデータ・ソースでの1つの属性ディメンションおよびメンバーの使用をサポートします。Oracle Smart View for Office 11.1.2.5.710+では、HsGetValueの属性サポートはPlanning、Planningモジュール、Financial Consolidation and Close、Tax Reportingデータ・ソースに拡張されています(例17-3を参照)。
Smart View 11.1.2.5.720+では、HsGetValueを使用して、スマート・リスト、テキストおよび日付などの列挙データ型を戻すことができます(例17-4を参照)。
構文
プライベート接続:
HsGetValue("PrivateConnectionName","POV")
共有接続:
HsGetValue("WSFN|ProviderType|Server|Application|Database","POV")
URL接続:
HsGetValue("URLFN|URL|Server|Application|Database","POV")
構文情報の詳細は、関数の手動作成を参照してください。
例17-2 属性を使用しない例
クラウド・データ・ソース・タイプ: Essbase、Planning、Planningモジュール、Financial Consolidation and Close、Tax Reporting、Narrative Reporting
オンプレミス・データ・ソース・タイプ: Essbase、Financial Management、Planning
次の例では、HsGetValueでデフォルトのPOVに関してHFM01アプリケーションから値を戻します。
プライベート接続:
=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")
共有接続:
=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接続:
=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")
例17-3 属性を使用した例
クラウド・データ・ソース・タイプ: Essbase、Planning、Planningモジュール、Financial Consolidation and Close、Tax Reporting
オンプレミス・データ・ソース・タイプ: Essbase
この例では、HsGetValueはVisionアプリケーション、Plan1データベースからの値を戻し、POVには、属性ディメンションおよびメンバー、Entity_Regions#NA_Regが含まれます。
注:
HsGetValueは、関数当たり1つの属性ディメンションおよびメンバーのみをサポートします。
プライベート接続:
=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")
共有接続:
=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接続:
=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")
例17-4 スマート・リストを使用した例
クラウド・データ・ソース・タイプ: Planning、Planningモジュール、Financial Consolidation and Close、Tax Reporting
この例では、HsGetValueはVisionアプリケーション、Plan1データベースからのスマート・リスト値を戻します。この場合のスマート・リストは、Cleaning and Maintenanceのドライバ値を検索します。戻すことができる値は、"% of Revenue"、"Units"、"FTE Hours"、"Sales Calls"、"Trips"、"Square Feet、"および"None"です。
プライベート接続:
=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")
共有接続:
=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接続:
=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")