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

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:4分
  • ターゲット ホスト上で特定の情報を返すように構成されたプローブを実行するアクティビティを作成します。

    始める前に

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

    このタスクについて

    アクティビティテンプレートのプロセスフローの使用手順については、「カスタムアクティビティを作成する」を参照してください。

    手順

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

    次のタスク

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

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

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

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

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

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

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

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

    始める前に

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

    必要なロール:activity_creator、admin

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

    手順

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