JavaScript プローブアクティビティを作成する

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む7読むのに数分

    • MID Serverにサーバー側の JavaScript を実行するよう指示するために JavaScript プローブアクティビティを作成します。

    始める前に

    必要なロール：activity_creator または workflow_admin

    このタスクについて

    JavascriptProbe アクティビティには、標準 Java ライブラリーに対する「パッケージ」コールと同じ機能があります。これにより、MID Server上の Java ライブラリーをより詳細に制御することができます。独自の JAR ファイルを MID Serverにロードして、JavascriptProbe がそれらの Java ファイルに対するパッケージ コールを行うようにすることができます。

    手順

    1. カスタムアクティビティを作成します。
      このアクションにより、テンプレートを使用してカスタムアクティビティが作成されます。
    2. general properties をセットアップして入力変数を作成した後で、JavaScript プローブアクティビティ実行コマンドを設定します。
      オプション説明
      入力変数をマップする 作成した変数を使用して、オーケストレーションが MID Server上で実行するコマンドを設定します。
      スクリプト タイプ 含めるスクリプトのタイプを選択します。使用可能なオプションは次のとおりです。
      • カスタム JavaScript
      • MID Server スクリプトの内容
      スクリプト このプローブで実行するカスタム JavaScript。
      注:
      このフィールドは、選択されている [スクリプト タイプ] が [カスタム JavaScript] である場合に使用可能です。
      MID Server スクリプトの内容 このプローブで実行する MID Server のスクリプト。
      注:
      このフィールドは、選択されている [スクリプト タイプ] が [MID Server スクリプトの内容] である場合に使用可能です。
      ホスト別に MID Server を選択 プローブが動作する MID Server。
      必要な MID Server 機能 使用する MID Server (機能別)。
      パラメーター このプローブでホストに渡す名前と値のペア。これらのパラメーターは手動で作成することも、入力変数を [パラメーター] フィールドにドラッグして値を割り当てることもできます。
      注:
      テストペイロードのパラメーター値を、[出力] タブの変数に自動的にマッピングできます。「出力変数を自動マッピングする」を参照してください。

    次のタスク

    出力変数を作成する、解析ルールを作成する、または条件を作成するのいずれかを行って、JavaScript プローブアクティビティの作成を終了します。テンプレート オプションの詳細については、「カスタムアクティビティを作成する」のトピックを参照してください。

    JavaScript プローブ テンプレートの実行パラメーター

    実行パラメーターを使用して、アクティビティデザイナーの [前処理] フォームで入力プロセス スクリプトを作成します。

    JavaScript プローブ コマンド フィールドの説明については、「JavaScript プローブ実行コマンドを設定する」の表を参照してください。
    注:
    この表のすべての変数で executionParam. プリフィックスを使用する必要があります。
    表 : 1. JavaScript テンプレートの実行パラメーター
    名前 変数 タイプ 使用法
    スクリプトタイプ script_type 列挙 実行するスクリプトのタイプ。可能なタイプは次のとおりです。
    • custom_javascript_typ
    • mid_script_include_type
    スクリプト スクリプト 文字列 script_type が custom_javascript_type のときにカスタム JavaScript を実行するスクリプト。
    Mid スクリプトの内容 mid_script_include 参照 script_type が mid_script_include_type のときに、MID Server スクリプトに関連付けられた sys_id 参照。
    ソース ソース 文字列 スクリプトを実行するターゲット ホスト。
    MidCapabilities midCapabilities 文字列 (コンマ区切り) 必要な MID Server機能のリスト。
    パラメーター parameters JavaScript オブジェクトの配列 executionParam. プリフィックスを付けて表現した JavaScript オブジェクトの配列。parameters 配列に名前と値のペアをさらに追加するには、値を既存の配列に追加します。次の構文を使用して JavaScript オブジェクトを作成し、それを executionParam.parameter 配列に追加します。これにより、メッセージに追加のパラメーターが割り当てられます。
    var newParameter = {"name":"parameterName","value":"parameterValue"};
executionParam.parameters.push(newParameter);
    ValueCapabilities valueCapabilities ハッシュマップの配列 MID Server の選択に使用される機能値。詳細については、「MID Server の機能」を参照してください。値によって割り当てられる追加の機能がある場合は、次の例を使用して MID Server の選択をカスタマイズします。
    var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'};
executionParam.valueCapabilities.push(valueCapability);

    JavaScript プローブ テンプレートの後処理パラメーター

    これらのパラメーターを使用して、後処理スクリプトを作成します。

    表 : 2. JavaScript プローブの後処理パラメーター
    名前 変数 タイプ 使用法
    ペイロード payload 文字列 JavaScript プローブから返された生のペイロードが含まれます。
    出力 output 文字列 JavaScript プローブから返された出力データが含まれます。
    EccSysId eccSysId 文字列 ECC キュー入力メッセージに関連付けられた参照 ID が含まれます。
    エラーメッセージ errorMessage 文字列 JavaScript プローブから返されたエラーメッセージが含まれます。エラーメッセージが返されない場合、この値は null です。

    JavaScript プローブ実行コマンドを設定する

    作成した入力変数を使用して、オーケストレーションが JavaScript プローブのターゲット ホストで実行するコマンドを設定します。

    始める前に

    [実行コマンド] ステージに進む前に、[入力] フォームで必要な入力変数を作成します。

    必要なロール：activity_creator、admin

    注:
    MID Serverとターゲット間の JavaScript プローブ接続は、ワークフロー コンテキストでアクティビティを実行しなくてもテストできます。詳細は、「テスト テンプレート出力」を参照してください。

    手順

    1. 入力のリストから変数をドラッグし、コマンド フィールドにドロップします。
      システムによって、コマンドの正しい構文で変数がフォーマットされます。
      図 : 1. JavaScript プローブ実行コマンド
      JavaScript プローブ実行コマンド
    2. 表に示されたフィールドに入力します。
      表 : 3. JavaScript プローブ実行コマンド フィールド
      フィールド 説明
      入力 入力変数ビルダー。入力変数を作成するを実行して、使用可能なフィールドにマップします。
      スクリプト タイプ 含めるスクリプトのタイプを選択します。使用可能なオプションは次のとおりです。
      • カスタム JavaScript
      • MID Server スクリプトの内容
      スクリプト このプローブで実行するカスタム JavaScript。このフィールドは、選択されている [スクリプト タイプ] が [カスタム JavaScript] である場合に使用可能です。
      MID Server スクリプトの内容 このプローブで実行する MID Server のスクリプト。このフィールドは、選択されている [スクリプト タイプ] が [MID Server スクリプトの内容] である場合に使用可能です。
      ホスト別に MID Server を選択 プローブが動作する MID Server。
      必要な MID Server 機能 使用する MID Server (機能別)。
      パラメーター このプローブでホストに渡す名前と値のペア。これらのパラメーターは手動で作成することも、入力変数を [パラメーター] フィールドにドラッグして値を割り当てることもできます。
    3. [保存] をクリックします。
    4. [続行] をクリックして、[出力] ステージに進みます。