早期アクセス
送信SOAPメッセージの作成と設定の方法を見てみましょう。
移動先:([設定])→[WEBサービス]→[送信]→[SOAP]を選択します。
[新しいSOAP]をクリックし、次の詳細を入力します。
[名前]:SOAPサービスの名前を入力します。
[WSDL URL]:外部WSDL契約を使用する場合は、APIエンドポイントURLを入力します。
[WSDLのダウンロード]:[WSDLのダウンロード]を有効にすると、外部URLのWSDLがダウンロードまたは取得されます。取得された内容はエディターに表示されます。
[認証の種類]:WSDLの取得に認証情報が必要な場合は、必要な認証方法を選択します。
[認証情報]:必要に応じて認証の詳細を入力します。
[Bridgeで実行]:Bridge経由でSOAPサービスを実行するオプションを選択し、必要に応じて適切なBridge IDを選択します。
[保存]をクリックします。
URL経由でダウンロードした契約は読み取り専用です。契約を変更するには、[WSDLのダウンロード]オプションの選択を解除し、XMLを手動で編集します。この場合、WSDL URLは使用されません。
SOAP関数セクションに移動します。
[SOAP関数の生成]をクリックします。これにより、WSDL契約が解析され、利用可能なAPIが一覧表示されます。
新しいAPIメッセージを手動で作成する場合は、右上の[SOAP関数]をクリックし、SOAPメッセージを最初から設定します。
一覧から選択したAPIメッセージを実行する場合、次の項目が自動入力されます。
[名前]
[バインディング]
[操作]
[SOAPアクション]
[エンドポイント]
[メッセージ]
関数を実行するには、その他の項目を入力します。
[認証の種類]:認証の種類を選択します。
[認証情報]:認証に使用する認証情報を選択します。送信SOAPの作成時に最初に入力した認証情報が自動選択されますが、上書きできます。
[接続タイムアウト]:接続タイムアウトを設定します(ミリ秒)。
[送信]をクリックすると、APIエンドポイントが呼び出され、XML形式でレスポンスを受信できます。
WSDL 契約に変更を加えた場合は、[サンプルSOAPメッセージを再生成]をクリックして関数定義を更新します。
既存のSOAPメッセージは削除されません。
新しいAPI/メッセージが検出された場合は追加されます。
変更されたメッセージは最新のWSDLに基づいて自動的に更新されます。
APIエンドポイントを呼び出してXML形式の応答を受信するには、[送信]をクリックします。
[SOAP設定]に移動します。
左側の[SOAPライブラリー]で、SOAPメッセージを有効または無効にします。
関数レベル:SOAPメッセージ内の特定のAPI関数を有効または無効にします。
[SOAP関数]セクションに移動します。
メッセージを選択し、特定のAPI関数を有効または無効にします。
SOAPメッセージページの右上にある[削除]アイコンをクリックします。
WSDL内の特定のAPIメッセージの削除。
[SOAP関数]セクションに移動します。
APIメッセージを選択し、右上の[削除]アイコンをクリックします。
SOAP設定に割り当てられた一意のIDを使用してサービスをトリガーします。
構文
OutboundSOAP.execute('<soap_config_id>', <variables>);
サンプル要求
let requestData = {};requestData['inputNumber'] = '100';OutboundSOAP.execute(31453000002078039, requestData);
サービスをトリガーするには、WSDL名、関数名、および必要な変数を使用します。
構文
OutboundSOAP.executeByName('wsdl_name', 'function_name', '{var1}:{val1}');
サンプル要求
let numberToConvert = {};numberToConvert['number'] = '100';OutboundSOAP.executeByName('NumberToWordService', 'convertNumberToWord', numberToConvert);
数値の文字表記への変換
サンプル要求。
<soapenv:Header/><soapenv:Body><num:NumberToWords><num:ubiNum>123</num:ubiNum></num:NumberToWords></soapenv:Body></soapenv:Envelope>
サンプル応答。
<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/'><soapenv:Body><NumberToWordsResponse xmlns='http://www.dataaccess.com/webservicesserver/'><NumberToWordsResult>One Hundred Twenty-Three</NumberToWordsResult></NumberToWordsResponse></soapenv:Body></soapenv:Envelope>