POST メソッド アクションをREST Web サービス パッケージから使用し、URIに新規リソースを作成します

この例では、Swagger Petstore サンプル API (Petstore) のエンドポイントを使用して、POST メソッド アクションで Petstore データベースにデータを追加するデモを行います。

手順

  1. 新しい Bot を作成します。
    1. Control Room のインスタンスにログインします。
    2. 左パネルの オートメーション をクリックします。
    3. [作成] > [タスク Bot] をクリックします。
    4. BotCreate Task Bot<2> モーダルに適切な 名を入力してください。
    5. 選択をクリックし、適切なストレージ場所を選択するための指示に従ってください。
      デフォルトの Bot 保存場所は \Bots\ です。
    6. 作成と編集 をクリックします。
  2. [POST メソッド] アクション を使ってサーバーにデータを送ります。 この例では、新しいペットがストアに追加されています。
    1. [REST Web サービス] > [POST メソッド] アクションをダブルクリックまたはドラッグします。
      REST Web サービス - POST メソッド
    2. 以下の URI を入力します。 
      https://petstore.swagger.io/v2/store/order
    3. プロキシ構成: 次のいずれかを実行します。
      • システム: [認証モード] で認証を選択します。 この例では、このエンドポイントで認証を必要としないため、[認証なし] を選択します。
        注: 通常、エンドポイントでは、許可されたアプリケーションのみがデータにアクセスできるようにするため、認証が必要です。 アクセスしたいエンドポイントへのアクセスを許可するために、適切な認証メカニズムを選択します。
      • カスタム: このオプションは、アクション のREST Web サービス内でカスタム プロキシを設定することができます。 詳細については、[REST Web サービス パッケージ]を参照してください。
    4. データがどのフォーマットで送信されるかを示す [コンテンツ タイプ] を選択します。 着信リクエストは、それに添付されるエンティティを持つことができます。 コンテンツ タイプは、リクエストのタイプを決定します。 一般的なコンテンツ タイプとしては、application/x-www-form-urlencoded、JSON (application/json)、XML (application/XML) などがあります。 この例では、JSON (application/json) を選択し、[カスタム パラメーター] フィールドに次のコマンドをコピーして貼り付けます。 
      {
  "id": 0,
  "petId": 0,
  "quantity": 0,
  "shipDate": "2022-04-20T22:08:11.977Z",
  "status": "placed",
  "complete": true
}
    5. 置換を追加: REST 要求本文に変数を入力できます。 変数はデータのシンボリック表現であり、必要な場合は、手動で入力しなくても値にアクセスできます。 たとえば、次の REST 本文の要求について考えてみましょう。 
      {
   "name":"{{name}}",
   "email":"{{email}}",
   "status":"Active"
}
      上記の要求本文では、[置換を追加] をクリックして必要な値を追加することで、二重カッコで囲まれた変数を置換できます。
    6. アクションが完了するまでの時間をミリ秒単位で入力します。 デフォルトの 60,000 のままでも構いません。
      ヒント: 必要に応じて、詳細オプションでオプションを設定/解除できます。 詳細オプションについての詳細は、[REST Web サービス パッケージ]をご覧ください。
    7. [変数に出力を代入] フィールドに変数 Output を作成します。 変数作成の詳細については、[変数の作成]を参照してください。
  3. [メッセージ ボックス] アクション を挿入して、レスポンス本文を表示します。
    1. [メッセージ ボックス] アクションをダブルクリックまたはドラッグします。
    2. [表示するメッセージを入力] フィールドに、[$Output{Body}$]と入力します。
  4. [保存] をクリックして、[実行] をクリックします。
    Bot は、メッセージ ボックスにレスポンスを表示します。