スクリプトの登録

登録されたスクリプトは、スクリプト・ファイル(JythonまたはVisual Basicスクリプトを含む)とターゲット・アプリケーションに関連付けられます。カスタム・スクリプトが実行されると、スクリプトにパラメータを入力するための値リストがプロンプトで表示されます。

スクリプトを登録するには:

1. 「設定」タブの「スクリプト」で、「スクリプトの登録」を選択します。

   「カスタム・スクリプトの登録」画面には次の3つの領域があります:

   • サマリー — すべてのカスタム・スクリプトがリスト表示されます。

   • 詳細 — スクリプト名、関連付けられたターゲット・アプリケーションおよびスクリプト・ファイルが表示されます。

   • パラメータ - パラメータ名、パラメータ・タイプ、表示名、シーケンス、パラメータ値、および特定のカスタム・スクリプトの値リストの指定に使用される問合せ定義が表示されます。

2. 「サマリー」グリッドの上で、「追加」をクリックします。

3. 「詳細」グリッドの「名前」にカスタム・スクリプトの名前を入力します。

4. 「ターゲット・アプリケーション」で、カスタム・スクリプトに関連付けられているターゲット・アプリケーションを選択します。

5. カスタム・スクリプトをカスタム・スクリプト・グループに関連付けるには、「カスタム・スクリプト・グループ」でグループを選択します。

6. 「スクリプト・ファイル」でカスタム・スクリプトに関連付けるスクリプト・ファイルを選択します。

   スクリプト・ファイルを検索するには、「選択」をクリックし、「スクリプト・ファイルの選択」画面でスクリプト・ファイルを選択します。

   スクリプト・ファイルをアップロードするには、「選択」をクリックします。「スクリプト・ファイルの選択」で「アップロード」をクリックします。「参照」をクリックしてアップロードするスクリプト・ファイルに移動し、「OK」をクリックします。

7. 「保存」をクリックします。

カスタム・スクリプトのパラメータを定義するには:

1. 「サマリー」グリッドから、パラメータを追加するカスタム・スクリプトの名前を選択します。

2. 「スクリプト・パラメータ」グリッドで「追加」をクリックします。

   パラメータの追加先の空白の行が表示されます。

3. 「パラメータ名」に、スクリプトで参照するパラメータの名前を入力します。

   たとえば、「POVロケーション」に「POVLOC」、「POV期間」に「POVPeriod」、「POVカテゴリ」に「POVCAT」、または「ターゲット・カテゴリ」に「POVTARGET」を入力します。

   パラメータ名はユーザー定義です。カスタム・スクリプト内でこれらを区別するために接頭辞または接尾辞を選択できます。

4. 「タイプ」でパラメータのタイプを選択します。

   使用可能なタイプ:

   • POV — POVのロケーション、期間、カテゴリまたはルールに対するプロンプトを表示します。「POV」値のデフォルトは、カスタム・スクリプトを実行した際のユーザーのPOVです。

   • 問合せ — 「問合せ」タイプでは問合せを作成でき、カスタム・スクリプトの実行時にユーザーはこの問合せによって移入される値リストから値を選択できます。

   • 静的 - 「静的」タイプはパラメータが定数または定義済の値であることを示し、パラメータ値がユーザーにより指定されたことを示します。カスタム・スクリプトが実行されるとき、パラメータに別の値を指定できます。

   パラメータに対して任意の名前を使用できます。また、現在のスクリプト内でパラメータを区別するために名前に接頭辞または接尾辞を使用することもできます。

   パラメータ名は、スクリプトの登録で指定された名前と正確に一致する必要があります。

5. 「表示名」で、「スクリプトの実行」画面でパラメータに表示される名前を入力します。

6. 「パラメータ値」に、静的パラメータ・タイプの値を入力します。

   このパラメータ値は、カスタム・スクリプトで次のAPIを使用して取得する必要があります:

   fdmAPI.getCustomScriptParameterValue("PARAMETER NAME"))

7. 「シーケンス」で、「スクリプトの実行」画面でのパラメータの表示順序を入力します。

8. 「問合せ」で、パラメータの値リストを提供する問合せ定義を指定します。

   たとえば、「レポートの生成」画面でユーザーが選択するデータ・ルールのリストを表示するには、これらの問合せを定義する問合せ定義を指定します。

9. 「保存」をクリックします。