REST Web Service package
REST Web Service package の actions をメソッド (DELETE、GET、PATCH、POST、または PUT) として使用し、API へリクエストを送信して API からレスポンスを受信します。
REST Web Service actions の操作
REST リクエストを送信してレスポンスを受信するには、次の情報を指定します。すべてのメソッドで必ずしもすべてのパラメーターが必要なわけではありません。
- URI: API リソースの一意のアドレス。
- 認証モード: 3 つの認証モードがサポートされています。
- 基本: 基本認証にはテキスト文字列を使用できます。
- ログイン済み AD ユーザー: 関連する API にアクセスする権限を与えられた Active Directory (AD) ユーザーは、AD を介して認証されます。リクエストに資格情報は必要ありません。
- Windows NT LAN Manager (NTLM) 認証 (AD ユーザー): 暗号化された資格情報やプレーン テキストとしてユーザー名とパスワードをクライアントが提供できるチャレンジ/レスポンス認証方法。Automation Anywhere Credential Vault に保存されている資格情報を使用することが推奨されます。
- ヘッダー: すべてのメソッドでヘッダーが必要です。ヘッダーは、リクエストに関連付けられたメタデータを表します。注: リクエストで API キーを使用するには、[名前] フィールドのヘッダーに「
api_key
」を入力し、[値] フィールドにキー値を入力します。 - 失敗応答をキャプチャ: [成功/OK] のレスポンスを除く失敗レスポンスをキャプチャするには、このチェック ボックスをオンにします。失敗レスポンスの詳細は、レスポンスの本文にキャプチャされます。
- https を使用するときは、安全でない接続を許可します: https を使用するときに安全でない接続を許可する場合は、チェックボックスをオンにします。
- コンテンツタイプ: コンテンツ タイプを含むヘッダーは、クライアントとサーバー間のコンテンツ ネゴシエーションを定義します。REST Web Service actions は、以下のコンテンツ タイプをサポートしています。
- application/json
- application/xml
- text/plain
- text/html
- text/xml
- multipart/form-data
- アクションの完了を待機: REST リクエストを送信してレスポンスを受信するまでのタイムアウト値を設定できます。POST、PUT、DELETE、PATCH、GET などの actions を実行する場合、[アクションの完了を待機] フィールドで待機時間 (ミリ秒単位) を指定できます。デフォルトでは、待機時間は 60,000 ミリ秒です。
- 出力変数: レスポンスの出力はディクショナリ変数にキャプチャされます。ディクショナリ変数はキーと値のペアです。レスポンス ヘッダー名をキーとして使用するとヘッダー値が返されます。「本文」をキーとして使用すると、レスポンス本文が返されます。注: REST API のレスポンス ステータスを表示するために、ディクショナリ変数においてレスポンス キーとその値を使用できます。API リソースのヘッダー名のリストを取得するには、次の手順を実行します。
- REST Web Service action の後に Loop action を挿入します。
- [ディクショナリ内の各キー] 反復子を選択します。
- [ディクショナリ変数] フィールドで、REST Web Service action 出力を保持する変数を選択します。
- 各キーの値を
$prompt-assignment$
に割り当てます。 - [Log To File action] を挿入します。
- ヘッダー名のリストを保持するテキスト ファイルへのファイル パスを指定します。
- [ログにテキストを入力] フィールドに
$prompt-assignment$
を挿入します。 - [既存のファイルを上書き] オプションを選択します。
- [保存] をクリックします。
bot を実行すると、API リソースから選択したファイルにヘッダー名が印刷されます。
値の安全な受け渡し
Credential Vault から Web サービスに値を安全に渡すには、サポートされている次の action フィールドに locker、資格情報、および属性を指定します。
- URI
- カスタム ヘッダー
- 本文:
application/x-www-form-urlencoded
コンテンツ タイプの場合は、[パラメーターを追加] をクリックして Credential Vault から値を選択します。他のすべてのコンテンツ タイプでは、[資格情報をパラメーターとして選択] オプションを選択して [選択] をクリックします。
REST Web Service package の Actions
Action | 説明 |
---|---|
DELETE メソッド | URI によって特定されるリソースを削除します。 |
GET メソッド | URI に含まれるパラメーターによって特定された情報を取得します。すべてのパラメーターは URI の一部として渡されるので、GET メソッドの [コンテンツ タイプ] はありません。 GET メソッドの制限と特徴には次が含まれます。
|
PATCH メソッド | URI によって特定されるリソースを修正します。 |
POST メソッド | URI に新しいリソースを作成します。
|
PUT メソッド | URI または本文で渡されたパラメーターに基づいてリソースが更新または置き換えられます。 |
プロキシ サポート
デバイスがプロキシで構成されている場合、この package からのすべてのアウトバウンド リクエストはプロキシ サーバー経由でルーティングされます。「Bot agent とプロキシの設定されているデバイスの接続」をご覧ください。