HsGetValue

クラウド・データ・ソース・タイプ: Oracle Analytics Cloud - Essbase、Planning、Planning Modules、Financial Consolidation and Close、Tax Reporting、Narrative Reporting

オンプレミス・データ・ソース・タイプ: Oracle Essbase、Oracle Hyperion Financial Management、Oracle Hyperion Planning

説明

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

HsGetValueでデータが取得されない場合、#NoData/Missingラベルの置換オプションで指定された値が使用されます(表24-6を参照してください)。

ユーザーが「リフレッシュ」または「すべてリフレッシュ」を選択した場合は、HsGetValueのみが呼び出されます。ユーザーが「送信」を選択した場合は、最初にHsSetValueが呼び出され、HsSetValueが正常に返される場合にのみHsGetValueが呼び出されます。

HsGetValue関数では、Essbaseデータ・ソースの1つの属性ディメンションとメンバーを使用することがサポートされています。Oracle Smart View for Office 11.1.2.5.710以上では、HsGetValueの属性サポートはPlanning、Planning Modules、Financial Consolidation and Close、Tax Reportingの各データ・ソースまで拡張されています(例25-3を参照)。

Smart View 11.1.2.5.720以上では、HsGetValueを使用して、スマート・リスト、テキストおよび日付などの列挙データ型を返すことができます(例25-4を参照)。

構文

プライベート接続:

HsGetValue("PrivateConnectionName","POV")

共有接続:

HsGetValue("WSFN|ProviderType|Server|Application|Database","POV")

構文情報の詳細は、関数の手動作成を参照してください。

例25-2 属性を使用しない例

クラウド・データ・ソース・タイプ: Oracle Analytics Cloud - Essbase、Planning、Planning Modules、Financial Consolidation and Close、Tax Reporting、Narrative Reporting

オンプレミス・データ・ソース・タイプ: Essbase、Financial Management、Planning

次の例では、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")

例25-3 属性を使用する例

クラウド・データ・ソース・タイプ: Oracle Analytics Cloud - Essbase、Planning、Planning Modules、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")

例25-4 スマート・リストを使用する例

クラウド・データ・ソース・タイプ: Planning、Planning Modules、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")