HsGetValue

Smart View関数HsGetValueについて説明します。

クラウド・データ・ソース・タイプ: Oracle EssbasePlanningPlanningモジュールFinancial Consolidation and CloseTax ReportingNarrative Reporting

オンプレミス・データ・ソース・タイプ: Oracle EssbaseOracle Hyperion Financial ManagementOracle 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の属性サポートはPlanningPlanningモジュールFinancial Consolidation and CloseTax 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 属性を使用しない例

クラウド・データ・ソース・タイプ: EssbasePlanningPlanningモジュールFinancial Consolidation and CloseTax ReportingNarrative Reporting

オンプレミス・データ・ソース・タイプ: EssbaseFinancial ManagementPlanning

次の例では、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 属性を使用した例

クラウド・データ・ソース・タイプ: EssbasePlanningPlanningモジュールFinancial Consolidation and CloseTax 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 スマート・リストを使用した例

クラウド・データ・ソース・タイプ: PlanningPlanningモジュールFinancial Consolidation and CloseTax 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")