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データ・ソースに拡張されています(例18-2を参照)。
Smart View 11.1.2.5.720+では、HsGetValueを使用して、スマート・リスト、テキストおよび日付などの列挙データ型を戻すことができます(例18-3を参照)。
Narrative Reporting 24.02以降は、Excelセル参照を使用して構築されたHsGetValue()関数で、サーバー始動リフレッシュがサポートされています。
構文
プライベート接続:
HsGetValue("PrivateConnectionName","POV")
共有接続:
HsGetValue("WSFN|ProviderType|Server|Application|Database","POV")
URL接続:
HsGetValue("URLFN|URL|Server|Application|Database","POV")
構文情報の詳細は、関数の手動作成を参照してください。
例18-1 属性を使用しない例
クラウド・データ・ソース・タイプ: 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")
例18-2 属性を使用した例
クラウド・データ・ソース・タイプ: 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")
例18-3 スマート・リストを使用した例
クラウド・データ・ソース・タイプ: 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")例18-4 データ・ソース接続へのセル参照がある例
データ・ソース接続へのセル参照を使用して構築されたHsGetValue関数の場合は、Excelファイルで、URL接続フォーマットを使用して関数の接続を定義します:
URLFN|URL:Port|Server|Application|Database
注:
ワークブックにプライベート接続名を指すセル参照を使用するHsGetValue関数が含まれている場合、プライベート接続はマシン間で移植できないため、サーバー始動リフレッシュではサポートされないことに注意してください。URLFNフォーマットを使用するように、これらの関数を変換することをお薦めします。
次の例では、セルB1に接続情報が含まれていると仮定します。URLFNの接頭辞を付けて、次のフォーマットで接続情報を入力します:
URLFN|http://<serviceURL>:<port>/HyperionPlanning/SmartView|<serverName>|App|Database
その後、次のようにセルB1を参照する接続パラメータを使用して関数を構築します:
=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")