関数ビルダーで、関数を選択し、関数で使用する接続とメンバーを指定します。これにより、関数ビルダーが適切な構文を使用して関数を作成し、選択したセルにその関数を入力します。これらの関数は編集が可能です。
関数ビルダーの特定のフィールドで使用可能な選択内容は、関数ビルダーの他のフィールドでの選択内容によって限定されてきます。たとえば、選択した関数でサポートされる接続のみが表示され、選択した関数でサポートされるディメンションのみが表示されます。
各関数の引数でセル参照を選択できます。引数の入力値がわかる場合は、オフライン・モードで関数を作成できます。各引数でタイプ・イン機能を使用できます。
注： | リリース11.1.2.2.310より前のリリースの関数ビルダーで作成された関数を使用できます。ただし、リリース11.1.2.2.310以降の関数ビルダーでは、セミコロン(;)ではなくカンマ(,)がメンバー・リスト引数の区切りに使用されています。どちらの文字も新しい関数ビルダーでサポートされていますが、前のバージョンで作成された関数を変更しようとすると、新しいカンマ区切り形式に変換するよう求められます。変換しないことを選択すると、関数に加えた変更は一切適用されません。 |
関数ビルダーを使用して関数を作成するには:
関数ビルダーは、共有接続とプライベート接続をサポートします。
「Smart View」パネルで関数のベースにするデータベースに移動し、データベース名を右クリックして「関数の構築」を選択します。
この方法で関数ビルダーにアクセスすると、手順4の説明に従って、「関数の引数」ダイアログ・ボックスの「接続」フィールドに特定の接続情報が事前移入されます。
または、Smart Viewのリボンから、「関数」、「関数の構築」の順に選択します。
この方法で関数ビルダーにアクセスした場合、「関数の引数」ダイアログ・ボックスの「接続」フィールドは空白です。手順4の説明に従って、接続情報を指定できます。または、シートにアクティブな接続がある場合は、ドロップダウン・リストからHSACTIVEを選択します。
「関数の選択」で、リストから関数を選択し、「OK」をクリックします。
注：
すべてのプロバイダですべての関数を使用できるわけではありません。関数およびサポートされているプロバイダのリストについては、表20を参照してください。
「関数の引数」ダイアログ・ボックスが表示されます。「接続」フィールドには、接続情報が次のフォーマットのいずれかで自動的に移入されています。
共有接続の場合:
WSFN| ProviderType | Server | Application | Database上記のWSFNパラメータは、この関数がWorkspace関数であり、共有接続を使用していることを示しています。
プライベート接続の場合:
PrivateConnectionName
接続情報を手動で入力するには、上記の構文を使用してください。
「関数の引数」で、選択した関数の各引数に対して、次のいずれかを実行します:
右端のボタン
をクリックします。たとえば、HsGetValueの場合、
をクリックし、「メンバー選択」からメンバーを選択します; HsLabelおよびHsGetVariableの場合、ラベルまたは変数をドロップダウン・リストから選択します。Essbaseのみ: 変数名が重複している場合、その完全修飾名がドロップダウン・リストに表示されることに注意してください。これは、グローバル、アプリケーションおよびデータベース・レベルで定義された変数の識別に役立ちます。
引数を手動で入力するには、テキスト・ボックスに引数を入力します。たとえば、メンバーを入力するには、Year#Qtr1やYear#Janのように、dimension#memberというフォーマットを使用します。
セル参照を使用するには、セル参照の使用の手順に従います。
図55に、HsGetValue関数の完了した「関数の引数」ダイアログ・ボックスを表示します。
「関数の引数」に表示される引数は、手順4で選択された関数によって非常に異なります。
注意:
HsGetSheetInfoでは、セル参照を使用してください。詳細は、セル参照の使用を参照してください。
HsSetValueの場合のみ: 「データ」または「セル参照」を選択し、送信する値を入力します。
HsGetTextおよびHsSetTextの場合のみ:
「コメント」または「セル参照」を選択し、送信するセル・テキストを入力します
「セル・テキスト・ラベル」を選択して、ドロップダウン・メニューからラベルを選択します
アクティブなワークシート接続が使用可能な場合、「接続」ドロップダウン・リストから「HSACTIVE」を選択できます。
「検証」をクリックして、記載されたエラーがあれば修正します。
表示される可能性のあるエラーを次に示します。
接続がオフラインまたは無効です
無効な選択
メンバー名が無効か、選択した別名と一致しません
ディメンション名が無効か、選択した別名と一致しません
Dimension#Memberの組合せが不完全です
疑問符の欠落またはその他の微細な構文エラーによる、一般的なエラー
図56に、「検証」ボタンをクリックした後の「関数の引数」ダイアログ・ボックスのエラーを示します。Financial Managementアプリケーションの次の例では、2つのDimension#Memberの組合せの構文にエラーがあります。最初のエラーは、ディメンション名が無効か、選択した別名と一致しないことです。2番目のエラーは、メンバー名が無効か、選択した別名と一致しないことです。
関数を実行するには、関数の実行の手順に従います。
接続、ラベル、データ/テキストまたは変数の引数の単一セルへの参照を入力できます。ディメンション/メンバー参照の、2つの連続するセルまたは連続しないセルへの参照を入力することもできます。参照を3つ以上のセルのセル範囲にすることはできません。
セル参照を使用するには:
「関数の引数」ダイアログ・ボックスで、選択した関数の引数ごとに「セル参照」ボタン
をクリックします。選択した引数のタイプに応じた「セル参照」ダイアログ・ボックスが表示されます。
「単一セル参照」のダイアログボックスの場合、引数のタイプに応じて、参照する単一セル(変数を含むセルなど)をクリックします。
図59に、ラベルの引数のセルが選択された「単一セル参照」のダイアログ・ボックスを示します。
「ディメンションおよびメンバー名のセル参照」のダイアログボックスで、次のいずれかの操作を行います。
参照する単一セル(ディメンションとメンバー名の両方を含むセルなど)をクリックします。
「[Ctrl]」キーを押して、2つの連続するセルまたは連続しないセル(ディメンションとメンバーのセルなど)を選択します。
「[Ctrl]」を押して、ワークシートの異なる領域の2つのセルまたは2つの隣接するセルをクリックできます。各セルの選択は、「[Ctrl]」キーを押しながら1回クリックして行います。
図60は、2つの連続しないセルが選択された「ディメンションおよびメンバー名のセル参照」のダイアログ・ボックスを示しています。
「セル参照」ダイアログ・ボックスで「OK」をクリックします。
「関数の引数」の引数のテキスト・フィールドには、参照先のセルが表21に示す形式で含まれます。
表 21. セル参照の形式
セル参照
関数の引数のフォーム
単一セル
""&A3&""
詳しい説明は、この表の下にある「注意」を参照してください。
2つの連続するセル
""&A3&"#"&B3&""
2つの連続しないセル
""&A5&"#"&B9&""
注意:
単一セル参照の場合、手順3で選択したメンバー名がグリッド内でdimension#memberとして表示されていれば、引数の選択は完全です。たとえば、メンバーがグリッド内のセルA3にYear#Qtr 2と表示されている場合、""&A3&""は完全です。
グリッド内にメンバー名のみが表示されている場合、二重引用符の最初の2セットの間に、ディメンション名と#を続けて手動入力する必要があります。たとえば、メンバーがセルA3にQtr2として表示されている場合、次のように引用符の間にYear#と入力する必要があります: "Year#"&A3&""
引数テキスト・フィールドにテキストが含まれている状態で参照セルを選択すると、そのテキストに参照セルのテキストが追加されます。そのため、参照セルを選択する前に不要なテキストはフィールドから削除しておきます。
![ディメンションとメンバーを表すセルの単一セル参照を手動で入力するか、[Ctrl]キーを使用してディメンションとメンバーを表す2つの連続するセルまたは連続しないセルを入力する、「セル参照」ダイアログ・ボックス](images/graphics/function_builder_cell_ref.jpg)
