RESTful サービス アクティビティの構成

RESTful サービス アクティビティ」を参照してください。

RESTful サービス アクティビティを使用するには、最初に RESTful サービス参照を設定する必要があります。Web サービス レファレンスの作成を参照してください。

  1. マップにアクティビティの追加します。

    デフォルトでは、アクティビティの [プロパティ] パネルで [構成] タブが開きます。

  2. アクティビティのデフォルトの [名前] を意味のある名前に変更します。
  3. [タイプ] リストで、[その他] > [RESTful サービス] を選択します。
  4. [Web サービス] リストで、次のいずれかを実行します。
    • 必要に応じて、事前構成された RESTful Web サービス参照を選択します。

      選択した RESTful サービスに応じて、事前構成された [ベース URL] が表示されます。また、RESTful サービスで定義されたカスタム ヘッダーが [カスタム ヘッダー] の下に表示されます。

    • 事前構成された RESTful Open API Web サービスを選択します。Web サービス レファレンスの作成を参照してください。

      [パラメータ] の [構成] リンクが使用可能になります。[構成] をクリックして、選択した RESTful サービスの統合で事前構成されたベース URL を表示します。クラスを選択すると、選択したクラスで使用可能なメソッドが表示されます。インライン値/変数をパラメータにマッピング可能なパラメータおよびパラメータ タイプを表示する方法を選択します。また、RESTful サービスで定義されたカスタム ヘッダーが [カスタム ヘッダー] の下に表示されます。

  5. 必要に応じて、[Web サービス] リストで事前構成済みの RESTful Web サービス リファレンスを選択します。

    選択した RESTful サービスに応じて、[ベース URL] が表示されます。また、RESTful サービスで定義されたカスタム ヘッダーが [カスタム ヘッダー] の下に表示されます。

    Web サービス レファレンスをホワイトリストに登録できます。システム設定ですべて許可が選択されていない場合は、ホワイトリストに登録された Web サービス レファレンスのみを使用できます。サーバー URL とデータベース接続文字列の構成を参照してください。
  6. この項目は任意です。次のいずれかを実行して、[URL パラメータ] (返される結果に影響を及ぼす文字列型のパラメータ) を指定します。
    • 静的なパラメータを指定するには、必要なテキストを入力します。

    • 実行時に関連情報を動的に取得し、その情報をユーザーに対して表示するには、URL パラメータ ルール エディタを右クリックし、プロセス変数またはサーバー変数を選択します。

    • 固定テキストと動的な値の組み合わせを使用します。

    ベース URL パラメータをコピーして別の RESTful サービスのベース URL パラメータに貼り付けると、ベース URL パラメータを再利用できます。
  7. [メソッド] リストで、実行する次のアクションを選択します。GET、DELETE、POST、PUT (デフォルト: GET)
  8. 返されたステータス コードの処理方法を指定するには、[エラー時にジョブを一時停止] に対して次のいずれかを実行します。(デフォルト: クリア)
    • チェック ボックスをオフのままにして、[エラー コード] リストでプロセス変数またはサーバー変数を選択します。

      エラーが検出され、選択されたエラー コードが実行時に表示される場合でも、ジョブは完了します。これは、ユーザーがエラーを手動で処理するのに役立ちます。

    • チェック ボックスを選択します。

      エラーが見つかった場合、ジョブは一時停止されます。

  9. プロセス マップを [保存] します。

データを取得または削除する

データを取得および削除するように Restful サービス アクティビティを構成できます。情報を取得する要求により、JSON または XML 形式のいずれかで応答が返されます。出力全体を、文字列型、XML 型、またはデータ オブジェクト変数の単一の変数に格納できます。応答が JSON である場合は、データ オブジェクト変数を使用して戻り値を保持できます。SlackUserDetails.ID を URL パラメータとして使用したり、列/行のリストである SlackUserDetails.Channels を使用したりするなど、データ オブジェクトの単一フィールドを使用して要求/応答を構成できます。

アクションが完了すると、返されたデータがオブジェクトのフィールドと配列に入力されます。これらの値は、実行時またはデバッグ時に表示することができます。モデルの構造と応答が一致するのが理想的です。ただし、構造が一致しない場合は、返されたデータ内の一致するフィールドおよびデータ オブジェクト構造内の一致するフィールドのみが入力されます。

  • 応答内のデータと一致するフィールドがデータ オブジェクト構造に存在しない場合、そのデータは無視されます。

  • また、データ オブジェクト構造のフィールドと一致するものが応答内に存在しない場合、それも無視されます。

データを取得または削除するには、次の手順を実行します。

  1. [タイプ] として [XML] または [JSON] を選択します。(デフォルト: XML)
  2. Web サービス レファレンスの作成時に定義されたカスタム ヘッダーとそのデフォルト値は、[カスタム ヘッダー] の下に表示されます。カスタム ヘッダーのデフォルト値を編集するには、次の手順を実行します。
    1. 行をダブル クリックするか、行を選択して、 をクリックします。
    2. [値] で動的変数を選択するか、 をクリックして静的な値を入力します。
    3. [OK] をクリックします。プロセスでジョブが作成されると、定義されたカスタム値がサード パーティの Web サービスに渡されます。このアクティビティでマッピングされた値またはインライン値が指定されなかった場合、RESTful サービス定義で定義されたデフォルト値が使用されます。
  3. [応答タイプ] リストで次のいずれかを選択します。
    • [変数] (デフォルト) を選択し、[値] リストでプロセス変数またはサーバー変数を選択して、出力全体を文字列タイプまたは XML タイプの単一の変数にマップします。データ オブジェクト変数を使用して、サービスからの応答を受信し、それを変数に格納できます。

      データ オブジェクト変数またはデータ オブジェクト変数の特定のフィールドをマッピングすることができます。

    • [式] を選択して次の手順を実行します。

      1. をクリックします。

      2. 式から抽出する要素を定義するには、正しい [パス] を指定します。

      3. [値] リストで、プロセス変数またはサーバー変数を選択します。

      4. [追加] をクリックします。

データを挿入または更新する

データを挿入および更新するように Restful サービス アクティビティを構成できます。POST/PUT の場合、要求と応答をデータ オブジェクト変数にマッピングできます。この要求は、REST API 呼び出しに渡される前に 1 つの要求として結合される複数のオブジェクトを受け入れます。

SlackUserDetails.Id を URL パラメータとして使用したり、応答の式を使用してデータを入力したりするなど、データ オブジェクトの単一フィールドを使用して要求/応答を構成できます。

データを挿入または更新するには、次の手順を実行します。

  1. [タイプ] として [XML] または [JSON] を選択します。(デフォルト: XML)
  2. Web サービス レファレンスの作成時に定義されたカスタム ヘッダーとそのデフォルト値は、[カスタム ヘッダー] の下に表示されます。カスタム ヘッダーのデフォルト値を編集するには、次の手順を実行します。

    1. 行をダブル クリックするか、行を選択して、 をクリックします。
    2. [値] で動的変数を選択するか、 をクリックして静的な値を入力します。

    3. [OK] をクリックします。

      プロセスでジョブが作成されると、定義されたカスタム値がサード パーティの Web サービスに渡されます。このアクティビティにマッピング値またはインライン値が指定されていない場合、RESTful サービス定義で定義したデフォルト値が使用されます。

    4. [リクエスト] ルール エディタを右クリックして、プロセス変数またはサーバー変数を選択します。

      データ オブジェクト変数またはその特定のフィールドを使用して、サービスに要求を送信できます。

    5. [応答タイプ] リストで次のいずれかを選択します。

      • [変数] (デフォルト) を選択し、[値] リストでプロセス変数またはサーバー変数を選択して、出力全体を文字列タイプまたは XML タイプの単一の変数にマップします。データ オブジェクト変数を使用して、サービスからの応答を受信し、それを変数に格納できます。

        データ オブジェクト変数またはデータ オブジェクト変数の特定のフィールドをマッピングすることができます。

      • [式] を選択して次の手順を実行します。

        1. をクリックします。

        2. 式から抽出する要素を定義するには、正しい [パス] を指定します。

        3. [値] リストで、プロセス変数またはサーバー変数を選択します。

        4. [追加] をクリックします。

    別の RESTful サービスの PUT および POST メソッドに要求をコピーして貼り付けることで、要求を再利用できます。