SOAPコネクション設定
SOAPコネクターとその依存関係をインストールした後、コネクションを設定できます。
ステップ1: Workatoでコネクションを設定する
SOAPコネクションの設定
新しいコネクションを作成し、インストールしたSOAPコネクターを選択します。 次に、以下のフィールドに入力します:
コネクション名
このSOAPコネクションに、接続先アプリケーションを識別する一意の名前を付けます。
場所
このコネクションに既存のプロジェクトを選択するか、新しいプロジェクトを作成します。
コネクションタイプ
SOAP拡張機能をインストールしたOPAがあるオンプレミスグループを必ず選択してください。 Cloudを選択しないでください。
WSDLソースタイプ
WSDLファイルをURLリンクとして指定するか、ファイルコンテンツを直接入力するかを選択します。 WSDLファイルは、Webサービスのインターフェイス、操作、およびデータ型を定義します。
WSDL URL
WSDLファイルはオンプレミスエージェント(OPA)から読み込まれます。 通常、URLはクエリ文字列として
WSDLを含むSOAP Webサービスです。 例:https://<hostname>/<path>?WSDLファイルコンテンツ
WSDLファイルのコンテンツを直接入力します。 これは、SOAP Webサービスを定義する有効なXMLドキュメントである必要があります。 コンテンツが正しくフォーマットされ、有効であることを確認します。
ファイルパス
OPA上のWSDLファイルの絶対パスまたは相対パスを入力します。 相対パスの場合、
config.ymlのOPA設定ファイルのextensions.soap.wsdlBaseセクションで、WSDLファイルを含むディレクトリの絶対パスを指定する必要があります。 例:yamlextensions: soap: wsdlBase: /opt/workato/ext/wsdl
専用ログイン操作を要求する
ログイン操作は認証情報を検証し、サービスとの以降のやり取りに使用する認証トークンまたはセッション識別子を取得します。 通常、これは必要ありません。 詳細については、専用ログイン操作を参照してください。
認証タイプ
認証タイプを選択します。
詳細オプション
オプションの詳細フィールドを表示するには、表示を選択します。
Webサービスアドレス
WSDLファイルでサービスアドレスが定義されていない場合、または上書きする場合は、ここでサービスアドレスを指定します。 SOAPメッセージはこのアドレスに送信されます。
最大スキーマ深度
入力フィールドおよび出力フィールドの最大深度。 これにより、コネクターがスキーマツリーをどの深さまでトラバースするかが決まります。 実際の深度がこの値を超える場合、一部のフィールドが表示されないことがあります。 これにより、スキーマ構造が過度に大きくなるのを防ぎます。 デフォルト値は15です。
最大タイプ再帰
スキーマ構造内の特定タイプに対する最大再帰回数。 これにより、タイプがそれ自体の内部にネストされている場合に発生する可能性のある無限ループを防ぎます。 デフォルト値は3です。
SOAPエンベロープを記録
リクエストおよびレスポンスのSOAPエンベロープの記録を有効にし、ジョブログで利用できるようにします。 これはデバッグに役立ちます。
すべての証明書を信頼
有効にすると、コネクターはサーバーから提示された証明書を検証しません。 プロダクションEnvironmentでは、通常、これを有効にしないことをお勧めします。
すべてのホスト名を信頼
有効にすると、コネクターはサーバーから提示された証明書のホスト名を検証しません。 プロダクションEnvironmentでは、通常、これを有効にしないことをお勧めします。
日時形式
一部のサービスではカスタム日時形式が必要です。 デフォルトは
yyyy-MM-dd'T'HH:mm:ss'Z'(UTCのISO 8601)です。例:2023-07-04T22:00:00.000Z。 詳細および日時パターンの例については、Javaドキュメントを参照してください。接続タイムアウト
サーバーへのコネクション確立のタイムアウト(秒)。 デフォルトは10秒です。
ステップ2: コネクションをテストする
コネクションの設定が完了したら、接続を選択してコネクションを保存し、テストします。
Last updated: