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 に送信される必要があります。

SOAP アクション

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

リクエスト

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

レスポンス

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

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

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