SOAP

ロボットは、SOAP リクエストを開始することで、その他のコンピューターにインストールされているプログラムと通信し、必要な情報を送信して、レスポンスを返すことができます。

[リポジトリ] > [ロボット] タブで、[SOAP] の列をクリックして、SOAP リクエストの編集およびテストを行うためのウィンドウにアクセスします。


SOAP ウィンドウ

サービス ウィンドウの [リクエスト] ペインを使用して、リクエストを構成します。[テスト サービス] をクリックしてロボットを実行します。すると結果が [レスポンス] ペインに表示されます。

入力フォーマット

「正常」または「フラット」は、SOAP リクエスト メッセージの構成を指しています。たとえば、ロボットの myRobot は、入力変数 var1 および var2 両方のタイプに属性 attr1 および attr2 があると予測している場合、「正常」は、以下のような SOAP メッセージを予測します。

  <myRobot>
     <var1>
       <attr1>Some value</attr1>
       <attr2>Another value</attr2>
     </var1>
     <var2>
       <attr1>More input</attr1>
       <attr2>and some more</attr2>
     </var2>
   </myRobot>

「フラット」構造では、以下のような SOAP メッセージを必要とします。

 <myRobot>
     <var1__attr1>Some value</var1__attr1>
     <var1__attr2>Another value</var1__attr2>
     <var2__attr1>More input</var2__attr1>
     <var2__attr2>and some more</var2__attr2>
   </myRobot>                      

フラット構造は、互換性の理由から導入されました。

WSDL URL

このロボットが属するプロジェクトの WSDL の URL。注意:この URL は、同じプロジェクトのロボットすべてと同一です。

リクエスト URL

ロボットを実行する際、HTTP POST リクエストは、この URL に送信される必要があります。

SOAPAction

ロボットを実行する際、SOAPAction という HTTP ヘッダーが、表示されている値とともに示されます。

リクエスト

このフィールドは、例の SOAP メッセージで事前に入力されます。すべての入力属性には、デフォルト/テスト値が設定されます。これは、テスト サービスをプレスする前に編集できます。

レスポンス

ロボット実行からの出力を含む編集できないフィールド。

入力パラメータにエラーがある場合や、ロボット実行の際にエラーが発生した場合、"SOAP Fault" メッセージが表示されます (エラーの理由と詳細の一部が含まれます)。

重要なメモ
  • プロジェクト名には、WSDL で許可されていない文字を含めることができます。そのため、プロジェクト名は、WSDL/SOAP メッセージでは異なることがあります。すなわち、"A-Z"、"0-9"、または "_" ではないすべての文字は、"_" で置き換えられます。
  • 同じように、ロボット名は違う形で表示されることがあります。これらは、プロジェクト名と同じように変換されます。ただし、ロボット名が変更されると、特殊な接尾語 (例:_1234) も追加されます。
  • 現在 SOAP 1.1 がサポートされています。