HsGetValue

Smart ViewファンクションHsGetValueについて説明します。

データ・ソース・タイプ: Oracle Essbase, Planning, Planningモジュール, Financial Consolidation and Close, Tax Reporting, Narrative Reporting

説明

HsGetValueは、選択した視点(POV)のディメンション・メンバーのデータをデータ・ソースから取得します。

HsGetValueがデータを取得しない場合、#NoData/Missing Label置換オプションに指定された値が使用されます(「表5-5」を参照)。

ユーザーが「リフレッシュ」または「すべてリフレッシュ」を選択した場合は、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

次の例では、HsGetValueはHFM01アプリケーションからデフォルトのPOVの値を返します。

プライベート接続:

=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

次の例では、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のDriver値を検索します。返される可能性のある値は、% 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関数がワークブックに含まれている場合、プライベート接続はマシン間で移植できないため、サーバー起動リフレッシュではサポートされないことに注意してください。 Oracleでは、これらの関数を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")