お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

早期アクセス

この機能は、すべてのユーザーに対して有効になっているわけではありません。お試しになりたい場合は、メールでサポートチームに早期アクセスをリクエストしてください。

ここでは、アウトバウンドSOAPメッセージの作成と設定方法について説明します。

WSDL契約の設定   

1. Qntrlにログインします。
   

2. ［設定］→［Webサービス］→［アウトバウンド］→［SOAP］の順に選択します。
   

3. ［新しいSOAP］をクリックし、次の詳細を入力します。
   

1. ［名前］：SOAPサービスの名前を入力します。
   

2. ［WSDL URL］：外部のWSDL契約を使用する場合は、APIエンドポイントURLを入力します。

3. ［WSDLのダウンロード］：［WSDLのダウンロード］が有効になっている場合、外部URLからWSDLがダウンロードまたは取得されます。同じ内容がエディターに表示されます。

4. ［認証の種類］：WSDLの取得に認証情報が必要な場合は、必要な認証方法を選択します。

5. ［認証情報］：必要に応じて認証情報の詳細を入力します。

6. ［Bridgeで実行］：Bridge経由でSOAPサービスを実行するオプションを選択し、該当する場合は適切なBridge IDを選択します。
   

3. ［保存］をクリックします。 

URL経由でダウンロードした契約は読み取り専用です。契約を変更するには、［WSDLのダウンロード］オプションのチェックを外し、XMLを手動で編集します。この場合、［WSDL URL］は使用されません。

SOAP関数の生成と実行   

1. ［SOAP関数］セクションに移動します。

2. ［SOAP関数を生成］をクリックします。これにより、WSDL契約が解析され、利用可能なAPIが一覧表示されます。

3. 新しいAPIメッセージを手動で作成するには、右上の［SOAP関数］をクリックして、SOAPメッセージを最初から設定します。

4. 一覧から選択したAPIメッセージを実行する場合、次の項目が自動入力されます。
   

1. ［名前］

2. ［バインディング］

3. ［オペレーション］

4. ［SOAPアクション］

5. ［エンドポイント］

6. ［メッセージ］

5. 関数を実行するには、その他の項目を入力します。
   

1. ［認証の種類］：［認証の種類］を選択します。

2. ［認証情報］：認証に使用する［認証情報］を選択します。SOAPアウトバウンドの作成時に最初に指定した認証情報が自動選択されますが、変更できます。

3. ［接続タイムアウト］：［接続タイムアウト］を設定します（ミリ秒）。
   

6. ［送信］をクリックしてAPIエンドポイントを呼び出し、XML形式のレスポンスを受信します。

WSDL契約を変更した場合は、［サンプルSOAPメッセージの再生成］をクリックして、関数定義を更新します。

• 既存のSOAPメッセージは削除されません。

• 新しいAPI／メッセージが検出された場合に追加されます。

• 変更されたメッセージは最新のWSDLに基づいて自動的に更新されます。

 変数の設定 

1. 要求メッセージでは、ローカル変数またはConfig Store の値もサポートされています。
   
2. 使用する場合は、［更新］アイコンをクリックして、利用可能な変数を読み込み、必要に応じて値を割り当てます。

3. APIエンドポイントを呼び出してXML形式の応答を受け取るには、［送信］をクリックします。
   

その他の操作     

SOAPメッセージの有効化／無効化   

SOAPメッセージは、さまざまなレベルで有効化または無効化できます。

• WSDLレベル：WSDL関数全体と関連APIを有効化または無効化します。

• ［SOAP設定］に移動します。 

• 左側の［SOAPライブラリー］で、SOAPメッセージを有効化または無効化します。

      

• 関数レベル：SOAPメッセージ内の特定のAPI関数を有効化または無効化します。

• ［SOAP関数］セクションに移動します。

• メッセージを選択し、特定のAPI関数を有効化または無効化します。

 SOAPメッセージの削除   

• WSDL全体を削除するには

• SOAPメッセージページ右上の［削除］アイコンをクリックします。

• WSDL内の特定のAPIメッセージを削除するには

• ［SOAP関数］セクションに移動します。

• APIメッセージを選択し、右上の［削除］アイコンをクリックします。

CodexでのアウトバウンドSOAPの実行   

OutboundSOAP.execute('<soap_config_id>', <variables>);

let requestData = {};
requestData['inputNumber'] = '100';
OutboundSOAP.execute(31453000002078039, requestData);  

OutboundSOAP.executeByName('wsdl_name', 'function_name', '{var1}:{val1}');

let numberToConvert = {};

numberToConvert['number'] = '100';
OutboundSOAP.executeByName('NumberToWordService', 'convertNumberToWord', numberToConvert);   

SOAP実行のサンプル   

数値の文字表記への変換  

サンプルリクエスト。  

<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/' 
xmlns:num='http://www.dataaccess.com/webservicesserver/'>
<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>