アクティビティ

SOAP 要求

UiPath.Web.Activities.Design.SoapClientWithBodyFactory

説明

SOAP プロトコルを使用する指定した Web API への HTTP 要求を実行できるようにします。最初にこのアクティビティをデザイナー パネルにドラッグすると、[SOAP 要求ウィザード] ウィンドウが表示されます。このウィザードでは、要求の作成およびサーバー応答のプレビューを簡単に行うことができます。このウィザードを終了すると、再度開くことはできません。

このウィンドウにあるすべてのフィールドは、[プロパティ] パネルでも使用できます。その結果、ウィザードを終了した後でも、環境設定を編集することができます。

プロジェクトの対応 OS

Windows - レガシ

注:

SOAP 要求は、Windows - レガシプロジェクトでのみサポートされています。Windows プロジェクトまたはクロスプラットフォームプロジェクトで SOAP 要求を実行する必要がある場合は、以下の解決策をお試しください。

プロセス全体に Windows レガシを使用する
SOAP 要求の部分にのみ Windows レガシプロセスを使用し、Windows プロセスから入力/出力引数経由で呼び出す
[コードを呼び出し] アクティビティを使用する
コード化されたワークフロー (Studio v2023.10 以降で利用可能) を使用する
[HTTP 要求] アクティビティを使用して、SOAP 定義に一致する独自の要求を作成する。適切なヘッダーを使用し、要求本文に正しい XML を含めてください。

SOAP 要求ウィザード

サービス説明 - WSDL スキーマの場所です。
3 点リーダーメニュー - ハードドライブで .wsdl ファイルを参照できます。ファイルです。
Get - 指定した .wsdl ファイルから情報をフェッチし、次の表に使用可能なパラメーターを表示します。
Contract - SOAP サービスによって公開されるメソッドを説明するコントラクトの名前です。
Method - サポートされているすべてのメソッドのリストです。メソッドを変更すると、下の表に表示されているパラメーターも変更されます。

[パラメーター] 表

Name - サポートされているすべてのパラメーターの名前です。
Type - サポートされている各パラメーターの種類です。場合によっては、[Type] 上にカーソルを置くと、パラメーターがオプションであるかどうかなどの詳細情報が表示されます。
Value - 各パラメーターに値を追加することができるため、必要な要求を行うことができます。

Authentication - Web サービスで使用する認証の種類を選択できるドロップダウンリストです。次のオプションを使用できます。
- None - 既定のオプションです。Web サービスがいずれの種類の認可も使用していないことを示しています。
- Simple - サービスが簡易認証を使用することを示しています。このメソッドを選択すると、[ユーザー名] と [パスワード] のフィールドが表示され、資格情報を入力できます。
- Windows - サービスが Windows 認証を使用することを示しています。
- Client Certificate - サービスが認可にクライアント証明書を使用していることを示します。選択した場合、[Client Certificate] フィールドが表示され、証明書のローカルドライブを参照できます。
Invoke - 指定したオプションを使用して要求を実行できるようにします。
応答 - Web サーバーの応答のプレビューを表示します。

プロパティ

クライアント証明書認証

Client Certificate - サービスが認可にクライアント証明書を使用し、証明書のローカルドライブを参照できることを示します。
クライアント証明書のパスワード - クライアント証明書のパスワードです。このフィールドでは String 型変数がサポートされています。
セキュリティで保護されたクライアント証明書パスワード - Secure String 型変数の形式の、クライアント証明書のパスワードです。

共通

エラー発生時に実行を継続 - アクティビティが例外をスローした場合でも、ワークフローを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は False です。その結果、フィールドが空白で例外がスローされると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

注: このアクティビティが [トライキャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True の場合、プロジェクトが実行されたときにエラーは発生しません。
表示名 - アクティビティの表示名です。

入力

Contract Name - SOAP サービスによって公開されるメソッドを説明するコントラクトの名前です。このプロパティは、文字列と String 型変数をサポートします。
EndPoint - WSDL スキーマの場所です。既定では、テストの目的で http://www.webservicex.com/globalweather.asmx?wsdl URL が提供されます。このプロパティは、文字列と String 型変数をサポートし、[SOAP 要求ウィザード] ウィンドウの [サービス説明] フィールドに対応します。
Method - クライアントによって呼び出されるメソッド名です。
Parameters - 指定したメソッドのパラメーターです。[Ellipsis] ボタンをクリックして、[パラメーター] ウィンドウを表示し、目的のパラメーターを追加できます。

その他

プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

ヘッダー - SOAP 要求から受け取る応答です。
結果 - Web サーバーの応答です (String 型変数)。

シンプル認証

ユーザー名 - Web サービスが簡易認証を使用し、ユーザー名を入力できることを示します。パスワードの追加も必要です。このプロパティは、文字列と String 型変数をサポートします。
セキュリティで保護されたパスワード - Web サービスがセキュリティで保護された認証を使用し、セキュリティで保護された文字列のパスワードを入力できることを示します。ユーザー名の追加も必要です。このプロパティでは Strings 型と String 型変数がサポートされています。
セキュリティで保護されたパスワード - Web サービスがセキュリティで保護された認証を使用し、セキュリティで保護された文字列のパスワードを入力できることを示します。ユーザー名の追加も必要です。このプロパティは Secure String 変数をサポートします。