送信SOAP Webサービスの設定

送信SOAP Webサービスの設定

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

Alert

早期アクセス

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

送信SOAPサービスを使用すると、Qntrlで外部のSOAPベースAPIと通信できます。これらのサービスは、利用可能な操作とパラメーターを定義するWSDL(Webサービス記述言語)契約に基づいています。


詳細については、WSDL契約とその仕組みについて、セクション「WSDL」を参照してください。

送信SOAPメッセージの作成と設定の方法を見てみましょう。

WSDL契約の設定   

  1. 移動先:[設定][WEBサービス][送信][SOAP]を選択します。

  2. [新しいSOAP]をクリックし、次の詳細を入力します。

    1. [名前]:SOAPサービスの名前を入力します。

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

    3. [WSDLのダウンロード][WSDLのダウンロード]を有効にすると、外部URLのWSDLがダウンロードまたは取得されます。取得された内容はエディターに表示されます。

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

    5. [認証情報]:必要に応じて認証の詳細を入力します。

    6. [Bridgeで実行]:Bridge経由でSOAPサービスを実行するオプションを選択し、必要に応じて適切なBridge IDを選択します。

  1. [保存]をクリックします。 

      

 

NotesURL経由でダウンロードした契約は読み取り専用です。契約を変更するには、[WSDLのダウンロード]オプションの選択を解除し、XMLを手動で編集します。この場合、WSDL URLは使用されません。


SOAP関数の生成と実行   

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

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

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

      

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

    1. [名前]

    2. [バインディング]

    3. [操作]

    4. [SOAPアクション]

    5. [エンドポイント]

    6. [メッセージ]

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

    1. [認証の種類]:認証の種類を選択します。

    2. [認証情報]:認証に使用する認証情報を選択します。送信SOAPの作成時に最初に入力した認証情報が自動選択されますが、上書きできます。

    3. [接続タイムアウト]:接続タイムアウトを設定します(ミリ秒)。

  1. [送信]をクリックすると、APIエンドポイントが呼び出され、XML形式でレスポンスを受信できます。

      

Notes

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の実行   

Codexでは、次の方法でアウトバウンドSOAP関数を実行できます。

IDによる実行  

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);
'number' や 'inputNumber' などのプレースホルダーを、SOAP入力設定で使用している実際の変数名に置き換えます。WSDL名と関数名が、QntrlでのSOAP API設定時に定義したものと完全に一致していることを必ず確認してください。

 


SOAP実行のサンプル   

数値の文字表記への変換  

サンプル要求。  

<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/'
<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>
<NumberToWordsResult>One Hundred Twenty-Three</NumberToWordsResult>
</NumberToWordsResponse>
</soapenv:Body>
</soapenv:Envelope>



次の項目。

    • Related Articles

    • 受信SOAP Webサービスの設定

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 早期アクセス この機能は、すべてのユーザーに対して有効になっているわけではありません。お試しになりたい場合は、メールでサポートチームに早期アクセスをお申し込みください。 インバウンドSOAP ...
    • 受信REST Webサービスの設定

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 早期アクセス この機能はすべてのユーザーに対して有効になっているわけではありません。試用をご希望の場合は、メールでサポートチームにご連絡いただき、早期アクセスをお申し込みください。 QntrlのインバウンドREST ...
    • 送信REST Webサービスの設定

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 早期アクセス この機能はすべてのユーザーに対して有効になっているわけではありません。お試しになりたい場合は、サポートチームにメールで早期アクセスをお申し込みください。 アウトバウンドREST ...
    • 外部CRM経由のカード作成の自動化

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 シナリオ ある会社では、Zoho ...
    • Webサービスの概要

      お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 早期アクセス Webサービスはすべてのユーザーに対して有効化されていません。早期アクセスをご希望の場合は、サポートチームにメールでお問い合わせください。 ...