REST メッセージのレガシーワークフローアクティビティ

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:3分
  • 従来 REST メッセージ アクティビティにより、アドミニストレーターは REST エンドポイントを上書きしたり、REST メッセージ モジュールに設定された変数を指定したりできます。

    このアクティビティは、Zurich リリースでは、新しいワークフロー開発用にワークフローキャンバスに表示されなくなりました。新しいワークフローでは、オーケストレーション 代わりに REST アクティビティテンプレート。

    を使用してください。オーケストレーション を使用する既存のワークフローは、設計どおりに動作し続けます。既存のワークフローでこのアクティビティを編集するには、アクティビティを再アクティブ化する必要があります。

    [REST メッセージ] アクティビティは、機能レコードに定義された値を使用して、エンドポイントでデッドリンク REST 機能 (POST、PUT、GET、または DELETE) を実行します。

    注:
    MID サーバーを使用して REST メッセージを送信する場合、MID サーバーはインスタンスによりアクセス可能で、SSH を使用するように構成されている必要があります。

    入力変数

    表 : 1. REST メッセージ アクティビティの入力変数
    フィールド 説明
    REST メッセージ
    REST メッセージ 実行する [REST メッセージを作成] の名前。これは、REST メッセージ [sys_rest_message] テーブルへの参照フィールドです (システム Web サービス > アウトバウンド > REST メッセージ) を開きます。
    REST メッセージ関数 REST メッセージ関数で定義された呼び出し機能。これは、HTTP メソッド [sys_rest_message_fn] テーブルへの参照フィールドです (システム Web サービス > アウトバウンド > REST メッセージ) を開きます。

    利用可能な関数は、PUTPOSTGET、または DELETE です。各 REST メッセージ レコードの [HTTP メソッド] 関連リストで関数を編集できます。

    REST エンドポイント HTTP メソッド レコードで定義された [エンドポイント] の代わりに使用する REST エンドポイント。このフィールドを空白のままにして、REST メッセージ関数レコードで定義されたエンドポイントを使用します。
    REST メッセージの変数
    変数 HTTP メソッドレコードで定義された送信 REST メッセージでの変数の置換に使用する値。
    文字列には、次の形式を使用します。
    name1=value1, name2=value2, . . .
    たとえば、name=${nameValue}, id=${idValue} (name および id は関数の変数) を使用します。変数名または値のいずれかにカンマまたは等号が含まれている場合は、これらの文字をバックスラッシュでエスケープします。
    REST メッセージの MID サーバー
    MID サーバーを使用 MID サーバーを使用して REST メッセージを送信する場合は、このボックスをオンにします。インスタンスには表示されないファイアウォールまたはサブネットワーク内のエンドポイントに到達するには、MID サーバーが必要な場合があります。このチェック ボックスがオンになっていても [MID サーバー] フィールドで MID サーバーが定義されていない場合、ワークフローは IP 範囲と REST 機能に基づいて自動的に MID サーバーを検索しようとします。
    MID サーバー 使用する MID サーバーの名前。このフィールドは、[MID サーバーを使用] が選択された場合に利用可能です。use_midserver パラメーターが無効な場合、ワークフローはこのパラメーターを無視します。
    REST メッセージ スクリプト
    センサー スクリプト 要求が行われ、回答が受信されてから実行されるスクリプト。activity.output 変数から応答本文全体にアクセスできます。