SOAPMessageV2 - スコープ指定、グローバル

SOAPMessageV2 - execute()

SOAP メッセージをエンドポイントに送信します。

表 : 1. パラメーター
名前	タイプ	説明
なし

表 : 2. 返される内容
タイプ	説明
SOAPResponseV2 - スコープ指定、グローバル	SOAP プロバイダーによって返される応答。

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var response = sm.execute(); //Might throw exception if http connection timed out or some issue with sending request itself because of encryption/decryption of password.

SOAPMessageV2 - executeAsync()

SOAP メッセージを ECC キューに送信します。

ECC キュー内の SOAP メッセージは SOAPClient ビジネスルールによって処理されます。

デフォルトでは、このビジネスルールは非同期で実行されません。このビジネスルールを非同期で実行するように設定するには、[時期] の値を [Async] に設定し、current.update() を [スクリプト] の最後に追加します。インスタンスは、ECC キューを介してメッセージを送信する際に、Web サービスプロバイダーからの応答を待機しません。

表 : 3. パラメーター
名前	タイプ	説明
なし

表 : 4. 返される内容
タイプ	説明
SOAPResponseV2 - スコープ指定、グローバル	SOAP プロバイダーによって返される応答。注: 応答が処理される前に SOAP 応答オブジェクトを使用しようとすると、タイムアウトエラーが発生する可能性があります。

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var response = sm.executeAsync();

SOAPMessageV2 - getEndpoint()

SOAP メッセージのエンドポイントを取得します。

表 : 5. パラメーター
名前	タイプ	説明
なし

表 : 6. 返される内容
タイプ	説明
文字列	SOAP Web サービスプロバイダーの URL。

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var endpoint = sm.getEndpoint();

SOAPMessageV2 - getRequestBody()

SOAP メッセージ本文の内容を返します。

注:

getRequestBody() メソッドを呼び出す前に、execute() メソッドを呼び出して応答オブジェクトを取得する必要があります。

表 : 7. パラメーター
名前	タイプ	説明
なし

表 : 8. 返される内容
タイプ	説明
文字列	SOAP メッセージの本文。

var sm = new sn_ws.SOAPMessageV2("StockQuote","StockQuoteSoap.GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var response = sm.execute();
var requestBody = response.getRequestBody();

SOAPMessageV2 - getRequestHeader(文字列 headerName)

SOAP クライアントによって指定された HTTP ヘッダーの値を取得します。

デフォルトでは、このメソッドはシステムによって自動的に設定されたヘッダーの値を返すことはできません。このメソッドにすべてのヘッダーへのアクセスを許可するには、プロパティ glide.http.log_debug を true に設定します。

表 : 9. パラメーター
名前	タイプ	説明
headerName	文字列	値を取得する要求ヘッダー。

表 : 10. 返される内容
タイプ	説明
文字列	指定されたヘッダーの値。

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var header = sm.getRequestHeader("Accept");

SOAPMessageV2 - getRequestHeaders()

SOAP クライアントによって設定された HTTP ヘッダーと関連する値を取得します。

このメソッドは、システムによって自動的に設定されたヘッダーを返しません。このメソッドがすべてのヘッダーを返すように設定するには、プロパティ glide.http.log_debug を true に設定します。

表 : 11. パラメーター
名前	タイプ	説明
なし

表 : 12. 返される内容
タイプ	説明
オブジェクト	各ヘッダーの名前を関連する値にマッピングするオブジェクト。

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var requestHeaders = sm.getRequestHeaders();

SOAPMessageV2 - setBasicAuth(文字列 userName, 文字列 userPass)

SOAP メッセージの基本認証ヘッダーを設定します。

このメソッドを使用して基本認証ヘッダーを設定すると、SOAP メッセージレコードで定義された基本認証値が上書きされます。

表 : 13. パラメーター
名前	タイプ	説明
userName	文字列	SOAP メッセージを認証するときに使用するユーザー名。
userPass	文字列	指定されたユーザーのパスワード。

表 : 14. 返される内容
タイプ	説明
なし

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setBasicAuth("username","password");

SOAPMessageV2 - setEccCorrelator(文字列 correlator)

送信要求と ECC キュー内の結果の応答レコードを関連付けます。

このメソッドは、MID Server を介して送信される SOAP メッセージにのみ適用されます。提供されたコリレーターは、応答の ECC キューレコードの [エージェントコリレーター] フィールドに入力されます。MID Server を介して非同期自動化を設計するときに、それぞれの送信要求に一意のコリレーターを提供して、ECC キュー内の正しい結果を要求に関連付けます。

表 : 15. パラメーター
名前	タイプ	説明
correlator	文字列	一意の識別子

表 : 16. 返される内容
タイプ	説明
なし

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setEccCorrelator("unique_id");

SOAPMessageV2 - setEccParameter(文字列 name, 文字列 value)

SOAP メッセージペイロードに書き込むことで、データベースの値を上書きします。

このメソッドは、MID サーバーを介して送信される SOAP メッセージにのみ適用されます。エンドポイント URL が SOAP エンドポイントの最大フィールド長よりも長い場合など、データベース内の SOAP メッセージにある値が無効な場合は、このメソッドを使用します。

name パラメーターの有効な値は次のとおりです。

source：エンドポイント URL。
name：実行する SOAP メッセージ関数。

表 : 17. パラメーター
名前	タイプ	説明
name	文字列	ECC パラメーターの名前。
value	文字列	指定された ECC パラメーターに割り当てる値。

表 : 18. 返される内容
タイプ	説明
なし

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setEccParameter("source","http://very.long.endpoint");

SOAPMessageV2 - setEndpoint(文字列 endpoint)

SOAP メッセージのエンドポイントを設定します。

デフォルトでは、SOAP メッセージは SOAP メッセージレコードで指定されたエンドポイントを使用します。このメソッドを使用してデフォルトを上書きします。パラメーターなしで SOAPMessageV2() コンストラクターを使用する場合は、このメソッドを呼び出す必要があります。

表 : 19. パラメーター
名前	タイプ	説明
endpoint	文字列	連携する SOAP Web サービスプロバイダーの URL。

表 : 20. 返される内容
タイプ	説明
なし

var sm = new sn_ws.SOAPMessageV2();
sm.setEndpoint("http://web.service.endpoint");

SOAPMessageV2 - setHttpTimeout(数字 timeoutMs)

要求がタイムアウトするまでに SOAP メッセージが Web サービスプロバイダーからの応答を待機する時間を設定します。

表 : 21. パラメーター
名前	タイプ	説明
timeoutMs	数字	Web サービスプロバイダーからの応答を待機する時間 (ミリ秒単位)。

表 : 22. 返される内容
タイプ	説明
なし

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setHttpTimeout(6000);

SOAPMessageV2 - setLogLevel(文字列 level)

このメッセージおよび対応する応答のログレベルを設定します。

SOAPMessageV2 API を使用してログレベルを設定すると、SOAP メッセージレコードで設定されたログレベルが上書きされます。エンドポイントドメインが除外されている場合、またはプロパティ glide.outbound_http_log.override が true の場合、このログレベルは適用されません。送信 Web サービスのログを表示するには、次の場所に移動します。システムログ > 送信 HTTP 要求.

表 : 23. パラメータ
名前	タイプ	説明
level	文字列	ログレベル。有効な値は、basic、elevated、および all です。

表 : 24. 返される内容
タイプ	説明
なし

SOAPMessageV2 - setMIDServer(文字列 midServerName)

MID Server を介して送信されるように SOAP メッセージを設定します。

デフォルトでは、SOAP メッセージは SOAP メッセージ関数レコードで指定された MID サーバーを使用します。このメソッドを使用してデフォルトを上書きします。

表 : 25. パラメーター
名前	タイプ	説明
midServerName	文字列	SOAP メッセージを送信する際に使用する MID サーバーの名前。インスタンスには、名前が指定されたアクティブな MID サーバーが必要です。

表 : 26. 返される内容
タイプ	説明
なし

SOAPMessageV2 - setMutualAuth(文字列 profileName)

SOAP メッセージの相互認証プロトコルプロファイルを設定します。

このメソッドを使用してプロトコルプロファイルを設定すると、SOAP メッセージレコードに対して選択されたプロトコルプロファイルが上書きされます。

表 : 27. パラメーター
名前	タイプ	説明
profileName	文字列	相互認証に使用するプロトコルプロファイルの名前。

表 : 28. 返される内容
タイプ	説明
なし

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setMutualAuth("auth_profile_name");

SOAPMessageV2 - setRequestBody(文字列 requestBody)

Web サービスプロバイダーに送信する本文のコンテンツを設定します。

このメソッドを使用して本文のコンテンツを設定すると、本文の変数が SOAP メッセージ関数レコードのパラメーターに置き換えられません。SOAP メッセージ本文内のすべての値を明示的に定義する必要があります。

表 : 29. パラメーター
名前	タイプ	説明
requestBody	文字列	SOAP メッセージの本文。

表 : 30. 返される内容
タイプ	説明
なし

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var body = "<SOAP message body>";
sm.setRequestBody(body);

SOAPMessageV2 - setRequestHeader(文字列 headerName, 文字列 headerValue)

SOAP メッセージ内の HTTP ヘッダーを指定された値に設定します。

表 : 31. パラメーター
名前	タイプ	説明
headerName	文字列	ヘッダーの名前。
headerValue	文字列	指定されたヘッダーに割り当てる値。

表 : 32. 返される内容
タイプ	説明
なし

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setRequestHeader("Accept","Application/json");

SOAPMessageV2 - setSOAPAction(文字列 soapAction)

この SOAP メッセージが実行する SOAP アクションを定義します。

Web サービスプロバイダーの WSDL に、実行できる SOAP アクションが一覧表示されます。パラメーターなしで SOAPMessageV2() コンストラクターを使用する場合は、このメソッドを呼び出す必要があります。

表 : 33. パラメーター
名前	タイプ	説明
soapAction	文字列	この SOAP メッセージが実行する SOAP アクション。

表 : 34. 返される内容
タイプ	説明
なし

var sm = new sn_ws.SOAPMessageV2();
sm.setSOAPAction("GetQuote");
//construct SOAP message by specifying endpoint and auth
sm.execute();

SOAPMessageV2 - setStringParameter(文字列 name, 文字列 value)

SOAP メッセージレコードにある指定の名前の変数を、指定した値に設定します。

値の中の XML 予約文字は、同等のエスケープ文字に変換されます。

表 : 35. パラメーター
名前	タイプ	説明
name	文字列	SOAP メッセージ変数の名前。
value	文字列	指定された変数に割り当てる値。

表 : 36. 返される内容
タイプ	説明
なし

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setStringParameter("symbol","NOW");

SOAPMessageV2 - setStringParameterNoEscape(文字列 name, 文字列 value)

SOAP メッセージレコードにある指定の名前の変数を、指定した値に設定します。

このメソッドは setStringParameter と同等ですが、XML 予約文字をエスケープしません。

表 : 37. パラメーター
名前	タイプ	説明
name	文字列	SOAP メッセージ変数の名前。
value	文字列	指定された変数に割り当てる値。

表 : 38. 返される内容
タイプ	説明
なし

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setStringParameterNoEscape("symbol","NOW");

SOAPMessageV2 - setWSSecurity(文字列 keystoreId, 文字列 keystoreAlias, 文字列 keystorePassword, 文字列 certificateId)

SOAP メッセージの Web サービスセキュリティの値を設定します。

このメソッドを使用してセキュリティ値を設定すると、SOAP メッセージレコードに対して定義された Web サービスセキュリティの値が上書きされます。

表 : 39. パラメーター
名前	タイプ	説明
keystoreId	文字列	使用する Java または PKCS12 キーストアの sys_id。
keystoreAlias	文字列	公開鍵と秘密鍵を識別するエイリアス。
keystorePassword	文字列	キーストアレコードに割り当てられたパスワード。
certificateId	文字列	信頼できるサーバー証明書の sys_id。

表 : 40. 返される内容
タイプ	説明
なし

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setWSSecurity("70d65e074f3812001f6eac118110c71a","Quote keys","UXr82cqX75Z7MaSa+EyjGA==","ba969a074f3812001f6eac118110c76d");

SOAPMessageV2 - SOAPMessageV2()

空の SOAPMessageV2 オブジェクトをインスタンス化します。

この方法でインスタンス化されたオブジェクトを使用する場合は、SOAP アクションとエンドポイントを手動で指定する必要があります。

表 : 41. パラメーター
名前	タイプ	説明
なし

var sm = new sn_ws.SOAPMessageV2();

SOAPMessageV2 - SOAPMessageV2(文字列 soapMessage, 文字列 soapFunction)

SOAP メッセージレコードとそのレコードに関連付けられた関数から、SOAPMessageV2 オブジェクトをインスタンス化します。

SOAP メッセージレコードのエンドポイント、認証、MID サーバー設定などの値がこのオブジェクトに適用されます。

表 : 42. パラメーター
名前	タイプ	説明
soapMessage	文字列	このオブジェクトのベースとして使用する SOAP メッセージレコード。
soapFunction	文字列	実行する SOAP 関数。使用可能な SOAP 関数は、Web サービスプロバイダーによって提供される WSDL によって異なります。

var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.