関数の手動作成

特性およびその他のExcel関数の制約については、Microsoftのドキュメントおよびサポート・サイトを参照してください。

関数を手動で作成するには:

Excelで、関数を入力するセルをクリックします。
等号を入力します (=)
関数名(HsSetValueなど)を入力します
例15-1で説明されているルールに従って、関数のパラメータを入力します。このとき、「関数の説明」で示されている各関数の固有の情報を使用します。
ワークシートをリフレッシュするには、Oracle Smart View for Officeのメニューで、「リフレッシュ」を選択します。

関数はリフレッシュ時にのみ検証されます。

例15-1 構文のガイドライン

個々の関数の構文については、関数の説明を参照してください。

共有接続を使用するには、ワークスペース関数を指定するWSFN識別子を接続文字列とともに関数に追加する必要があります。フォーマットは次のようになります:
```
"WSFN|ProviderType|Server|Application|Database","POV"
```
たとえば、HsGetValue関数でOracle Essbaseデータ・ソースへの共有接続には、WSFN識別子と接続文字列を次のように関数に追加します:
```
=HsGetValue("WSFN|Essbase|myserver|Sample|Basic","Market#South")
```
ProviderTypeでは、次のいずれかの文字列を、大文字/小文字を区別して使用します:
- Essbase (Essbaseオンプレミスのみ。Oracle Essbaseクラウドではプライベート接続構文が必要です)
- HFM (Oracle Hyperion Financial Managementの場合)
- HP (Oracle Hyperion Planning、Planning、Planningモジュール、Financial Consolidation and Close、Tax Reportingの場合)
Financial Managementでは、Databaseパラメータを省略でき、指定する場合はApplicationパラメータと同じ値を指定します。整合性を保つために、Databaseパラメータにアプリケーション名を入力することをお薦めします。
URL接続を使用するには、URL関数を指定するURLFN識別子を接続文字列とともに関数に追加する必要があります。フォーマットは次のようになります:

URLFN|URL|Server|Application|Database

たとえば、Planningビジネス・プロセスに接続するためのURLを使用したHsGetValue関数の構文は次のとおりです。

HsGetValue("URLFN|URL|Server|Application|Database","POV")

前述のとおり、接続の確立に必要な情報はすべてトークンの一部です。トークンに無効な情報が含まれる場合は通常、#NoConnectionエラーが表示されますが、Serverトークンに関する次の例外があります。
- Oracle Enterprise Performance Management Cloudビジネス・プロセス(Planningなど)の場合、Serverトークンは空白(または無効)でもかまいません
- EssbaseのServerトークンは、空白のみ可能です
- Financial Managementには、Serverトークン・パラメータが必要です
プライベート接続パラメータには次の値を入力できます:
- 空白: デフォルトの接続
- HsActive: 関連付けられたアクティブな接続
- プライベート接続のユーザー定義名
プライベート接続を指定する場合は、POVの前に置く必要があります。
POVは次の例のようにdimension#memberのペアで構成されます:
```
Entity#Connecticut
```
親子関係は次の例のようにピリオド(.)で示されます:
```
Entity#UnitedStates.Maine
```
接続と各POVのdimension#memberペアは個別の関数パラメータに分割でき、次の例に示すように各パラメータが引用符(")で囲まれ、カンマ(,)で区切られます:
```
"My_connection","Entity#UnitedStates","Account#Sales"
```
または接続をカンマ(,)でPOVから分離できます。この場合は次の例のようにPOV全体が引用符(")で囲まれ、dimension#memberの各ペアがセミコロン(;)で区切られます:
```
"My_connection","Entity#UnitedStates;Account#Sales"
```
関数のディメンション名とその別名を混合しないでください。ただし、メンバーの場合、メンバー名または選択した別名表の別名のいずれかを使用できます。