機械翻訳について

関数ビルダーでの関数の作成

関数ビルダーでは、関数を選択し、その関数で使用する接続とメンバーを指定します。 関数ビルダーは、適切な構文を使用して関数を作成し、選択したセルに関数を入力します。 これらの機能は編集できます。

特定の「関数ビルダー」フィールドで利用可能な選択は、「関数ビルダー」の他のフィールドでの選択によって制限されます。 たとえば、選択した機能でサポートされている接続だけが表示され、選択した機能でサポートされているディメンションだけが表示されます。

関数参照ごとにセル参照を選択できます。 引数の入力値がわかっている場合は、オフライン・モードで関数を作成できます。 タイプ・イン機能は、各引数で使用できます。

関数の説明

注意:

Release 11.1.2.2.310の前に関数ビルダーで作成された関数を使用することができます。 ただし、Release 11.1.2.2.310から、関数ビルダーはセミコロン(;)ではなく、カンマ(、)を使用してメンバー・リスト引数を区切ります。 両方の文字は新しい関数ビルダーでサポートされていますが、以前のバージョンで作成された関数を変更すると、カンマで区切られた新しい形式に変換するよう求められます。 変換しないことを選択した場合、関数の変更は適用されません。

関数ビルダーを使用して関数を作成するには:

  1. 適切なデータソースに接続します。

    汎用ビルダーは、共有接続または専用接続をサポートしています。

    Oracle Essbase, Oracle Analytics Cloud - Essbase:プライベート接続を使用していて、関数が別名表を使用する場合は、接続に正しい別名表または"Default"別名表が設定されていることを確認する必要があります。 「Smart Viewパネル」でデータベース名を右クリックし、「別名表の設定」を選択します。 正しい別名表が選択されていることを確認し、シートをリフレッシュします。

  2. シートで、関数を入力するセルを選択します。
  3. 「Smart Viewパネル」で、関数の基底となるデータベースに移動し、データベース名を右クリックし、「関数の構築」を選択します。

    このように関数ビルダーにアクセスすると、「関数の引数」ダイアログ・ボックスの「接続」フィールドに、特定の接続情報が事前に入力されます(4のステップを参照)。

    または、Oracle Smart View for Officeリボンから、「機能、」を選択し、次に「関数の構築」を選択します。

    このように関数ビルダーにアクセスすると、「関数の引数」ダイアログ・ボックスの「接続」フィールドが空白になります。 ステップ4で説明されているように、接続情報を提供することができます。 または、シートにアクティブな接続がある場合は、ドロップダウン・リストからHSACTIVEを選択します。

  4. 「機能の選択」で、リストから関数を選択し、OKをクリックします。

    図24-1 関数ビルダー、関数の選択ダイアログ・ボックス


    このセクションで説明されているように、関数ビルダー「機能の選択」ダイアログ・ボックス(HsGetValue付き)が選択されています

    注意:

    すべての機能がすべてのプロバイダで使用できるわけではありません。 関数とサポートされているプロバイダのリストについては、「表24-1」を参照してください。

    「関数の引数」ダイアログ・ボックスが表示され、「接続」フィールドに次のいずれかの形式の接続情報が自動的に入力されます。

    • 共有接続の場合:

      WSFN|ProviderType|Server|Application|Database
      

      上記のWSFNパラメータは、この関数がWorkspace関数であり、共有接続を使用していることを示します。

    • プライベート接続の場合:

      PrivateConnectionName
      

    手動で接続情報を入力するには、上記の構文を使用します。

  5. 関数の引数では、選択した関数の各引数について、次のいずれかを実行します:
    • 一番右のボタン「メンバー選択」ボタン、「メンバー選択」ダイアログ・ボックスを開きます。をクリックします。

      たとえば、HsGetValueの場合は、「メンバー選択」ボタン、「メンバー選択」ダイアログ・ボックスを開きます。をクリックして「メンバー選択」のメンバーを選択します。HsLabelおよびHsGetVariableの場合、ラベルまたは変数のドロップダウン・リストから選択します。

      Essbase, Oracle Analytics Cloud - Essbase:変数名が複製されると、その完全修飾名がドロップダウン・リストに表示されます。 これは、グローバル・レベル、アプリケーションレベル、およびデータベース・レベルで定義された変数を識別するのに役立ちます。

    • 引数を手動で入力するには、テキスト・ボックスに引数を入力します。 たとえば、メンバーを入力するには、format: ディメンション#メンバー。Year#Qtr1またはYear#Janのようなものです。

    • セル参照を使用するには、「セル参照の使用」の手順に従います。

    「図24-2」は、HsGetValue関数の完了した「関数の引数」ダイアログ・ボックスを表示します。

    図24-2 関数ビルダー、Essbaseサンプルの基本データベースに基づくHsGetValueの関数引数ダイアログ・ボックス


    関数ビルダー、HsGetValue関数の「関数の引数」ダイアログ・ボックス。 接続フィールドと、各関数引数のディメンションとメンバーを入力するためのフィールドがあります。

    「関数の引数」にリストされている引数は、前のステップで選択した関数によって異なります。

    注意:

    • HsGetSheetInfoの場合は、セル参照を使用します。 詳細については、「セル参照の使用」を参照してください。

    • HsSetValueのみ: 「データ」または「セル参照」を選択し、送信する値を入力します。

    • HsGetTextとHsSetTextのみ:

      • 「コメント」または「セル参照」を選択し、送信するセル・テキストを入力

      • 「セル・テキスト・ラベル」を選択し、ドロップダウン・メニューからラベルを選択

    • アクティブなワークシート接続が利用可能な場合は、「接続」ドロップダウン・リストからHSACTIVEを選択できます。

  6. 「検証」をクリックして、表示されるエラーを修正します。

    表示されるエラーのいくつかは次のとおりです:

    • 接続がオフラインまたは無効

    • 無効な選択

    • メンバー名が無効か、選択した別名と一致しない

    • ディメンション名が無効か、選択した別名と一致しない

    • Dimension#Memberの組合せが不完全

    • 引用符やその他の軽微な構文エラーがない場合の一般的な"Error"

    「図24-3」は、「検証」ボタンをクリックすると、「関数の引数」ダイアログ・ボックスにエラーを表示します。 Oracle Hyperion Financial Management Simpleアプリケーションの次の例では、Dimension#Memberの2つの組み合わせの構文にエラーがあります。 最初のエラーは、ディメンション名が無効であるか、選択された別名と一致しないことです。 2番目のエラーは、メンバー名が無効であるか、選択した別名と一致しないことです。

    図24-3 関数ビルダーの検証エラー


    関数ビルダー、HsGetValue関数の「関数の引数」ダイアログ・ボックス。 Dimension#Memberの2つの組み合わせの構文に誤りがあります。 最初のエラーは、ディメンション名が無効であるか、選択された別名と一致しないことです。 2番目のエラーは、メンバー名が無効であるか、選択した別名と一致しないことです。
  7. 関数の検証が成功したら、OKをクリックして、選択したセルに関数を挿入します。
  8. この機能を実行するには、実行関数の手順に従います。