HsSetValue
Smart ViewファンクションHsSetValueについて説明します。
データ・ソース・タイプ: Oracle Essbase, Planning, Planningモジュール, Financial Consolidation and Close, Tax Reporting
説明
HsSetValueは、視点(POV)の選択したディメンション・メンバーのデータ値をワークシートからデータ・ソースへ送信します。 属性ディメンションとメンバーはHsSetValueでサポートされません。
データソースにデータを送信するには、適切なロード・ルールと、データ・ソースへの書き込み権限が必要です。
Smart View 11.1.2.5.810+では、HsSetValueを使用して、スマート・リスト、テキスト、日付などの列挙データ型を送信できます。
ノート:
HsSetValue関数を使用して、サポート詳細を含むデータ・セルの値を設定しないでください。 使用する場合、HsSetValue関数は、セルにサポート詳細が含まれているかどうかを識別できず、新しいファンクション・フェッチ値を使用してセル値の更新および送信を続行します。 これにより、誤った動作が発生します。 元の値は、セルの「サポート詳細」ダイアログ・ボックスに引き続き表示されます。 そのため、サポート詳細を含むセルの値を設定するためにHsSetValue関数を使用しないことをお薦めします。
構文
プライベート接続:
HsSetValue (value,"PrivateConnectionName","POV")共有接続:
HsSetValue (value,"WSFN|ProviderType|Server|Application|Database","POV")URL接続:
HsSetValue (value,"URLFN|URL|Server|Application|Database","POV")構文情報の詳細は、関数の手動作成を参照してください。
例18-5 基本的な例
データ・ソース・タイプ: Essbase, Planning, Planningモジュール, Financial Consolidation and Close, Tax Reporting
次の例では、HsSetValueはセルH4からHFM01アプリケーションに値を送信します。
プライベート接続:
HsSetValue(H4, "HFM01","Scenario#Actual;Year#2004;Period#"&B$2&";View#<Scenario View>;Entity#UnitedStates.Connecticut;Value#<Entity Currency>;Account#"&$A4&";ICP#[ICP None];Custom1#GolfBalls;Custom2#Customer2;Custom3#[None];Custom4#
Increases")共有接続:
HsSetValue(H4, "WSFN|HFM|hfm_svr|HFM01|HFM01","Scenario#Actual;Year#2004;Period#"&B$2&";View#<Scenario View>;Entity#UnitedStates.Connecticut;Value#<Entity Currency>;Account#"&$A4&";ICP#[ICP None];Custom1#GolfBalls;Custom2#Customer2;Custom3#[None];Custom4#
Increases")URL接続:
HsSetValue(H4, "URLFN|http://<servername:port>/hfmadf/../hfmadf/officeprovider|<servername:port>|HFM01|HFM01","Scenario#Actual;Year#2004;Period#"&B$2&";View#<Scenario View>;Entity#UnitedStates.Connecticut;Value#<Entity Currency>;Account#"&$A4&";ICP#[ICP None];Custom1#GolfBalls;Custom2#Customer2;Custom3#[None];Custom4#
Increases")例18-6 スマート・リストの例
データ・ソース・タイプ: Planning, Planningモジュール, Financial Consolidation and Close, Tax Reporting
この例では、構文はテキストに使用される構文と似ていますが、テキストはスマート・リストのテキスト値のいずれかと一致する必要があります。
プライベート接続:
HsSetValue("Trips", "Vision","Account#7110: Advertising","Period#x---------x","HSP_View#BaseData","Year#FY16","Scenario#Forecast","Version#Driver","Entity#International Sales","Product#No Product")共有接続:
HsSetValue("Trips", "WSFN|HP|serviceURL|Vision|Plan1","Account#7110: Advertising","Period#x---------x","HSP_View#BaseData","Year#FY16","Scenario#Forecast","Version#Driver","Entity#International Sales","Product#No Product")URL接続:
HsSetValue("Trips", "URLFN|https://<servername:port>/HyperionPlanning/SmartView|<servername:port>|Vision|Plan1","Account#7110: Advertising","Period#x---------x","HSP_View#BaseData","Year#FY16","Scenario#Forecast","Version#Driver","Entity#International Sales","Product#No Product")例18-7 テキストを使用した例
データ・ソース・タイプ: Planning, Planningモジュール, Financial Consolidation and Close, Tax Reporting
関数内でテキスト値を使用する場合は、テキスト値を引用符で囲みます。
プライベート接続:
HsSetValue("Enter Some Text", "Vision","Account#7110: Advertising","Period#Jun","HSP_View#BaseData","Year#FY16","Scenario#Plan","Version#Commentary","Entity#International Sales","Product#No Product")共有接続:
HsSetValue("Enter Some Text", "WSFN|HP|serviceURL|Vision|Plan1","Account#7110: Advertising","Period#Jun","HSP_View#BaseData","Year#FY16","Scenario#Plan","Version#Commentary","Entity#International Sales","Product#No Product")URL接続:
HsSetValue("Enter Some Text", "URLFN|https://<servername:port>/HyperionPlanning/SmartView|<servername:port>|Vision|Plan1","Account#7110: Advertising","Period#Jun","HSP_View#BaseData","Year#FY16","Scenario#Plan","Version#Commentary","Entity#International Sales","Product#No Product")例18-8 日付を使用した例
データ・ソース・タイプ: Planning, Planningモジュール, Financial Consolidation and Close, Tax Reporting
関数内で日付値を使用する場合、日付値を引用符で囲みます。
プライベート接続:
HsSetValue("01/03/2003","Vision","Account#Request Date","Period#x---------x","HSP_View#BaseData","Year#FY16","Scenario#Plan","Version#Working","Entity#No Department","Product#No Product")共有接続:
HsSetValue("01/03/2003","WSFN|HP|serviceURL|Vision|Plan1","Account#Request Date","Period#x---------x","HSP_View#BaseData","Year#FY16","Scenario#Plan","Version#Working","Entity#No Department","Product#No Product")URL接続:
HsSetValue("01/03/2003","URLFN|https://<servername:port>/HyperionPlanning/SmartView|<servername:port>|Vision|Plan1","Account#Request Date","Period#x---------x","HSP_View#BaseData","Year#FY16","Scenario#Plan","Version#Working","Entity#No Department","Product#No Product")
例18-9 今日の日付にTODAY関数を使用した日付の例
データ・ソース・タイプ: Planning, Planningモジュール, Financial Consolidation and Close, Tax Reporting
今日の日付にはTODAY関数も使用できます。
プライベート接続:
HsSetValue(TEXT(TODAY(),"mm/dd/yyyy"),"Vision","Account#Request Date","Period#x---------x","HSP_View#BaseData","Year#FY16","Scenario#Plan","Version#Working","Entity#No Department","Product#No Product")共有接続:
HsSetValue(TEXT(TODAY(),"mm/dd/yyyy"),"WSFN|HP|serviceURL|Vision|Plan1","Account#Request Date","Period#x---------x","HSP_View#BaseData","Year#FY16","Scenario#Plan","Version#Working","Entity#No Department","Product#No Product")URL接続:
HsSetValue(TEXT(TODAY(),"mm/dd/yyyy"),"URLFN|https://<servername:port>/HyperionPlanning/SmartView|<servername:port>|Vision|Plan1","Account#Request Date","Period#x---------x","HSP_View#BaseData","Year#FY16","Scenario#Plan","Version#Working","Entity#No Department","Product#No Product")