SOAPResponseV2 - スコープ、グローバル
SOAPResponseV2 API は、JavaScript コードの送信 SOAP メッセージによって返されたデータを使用するメソッドを提供します。
SOAPResponseV2 オブジェクトは、 SOAPMessageV2 メソッド execute() および executeAsync() によって返されます。
この API は、スコープ対象のアプリケーションまたはグローバルスコープ内で使用できます。
この API は sn_ws 名前空間で実行されます。
SOAPResponseV2:getAllHeaders()
重複するヘッダーを含む、応答に含まれるすべてのヘッダーを返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| List<GlideHTTPHeader> | 応答に含まれるヘッダーのリスト。各ヘッダーは、ヘッダー 名 と 値を含む GlideHTTPHeader オブジェクトとして表されます。 |
var r = new sn_ws.SOAPMessageV2('<A SOAP message>', 'get');
var response = r.execute();
var headers = response.getAllHeaders();
for(var i in headers){
gs.info(headers[i].name + ': ' + headers[i].value);
}
SOAPResponseV2:getBody()
SOAP 応答本文の内容を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 文字列 | SOAP 応答本文。 |
var body = response.getBody();
SOAPResponseV2:getCookies()
応答に含まれるすべての Cookie を返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| オブジェクト | Cookie を表す文字列のアレイ。アレイを反復処理して、各 Cookie に対して操作を実行します。 |
応答から個々の Cookie を表示します。
var cookies = response.getCookies();
for (var i = 0; i < cookies.length; i++) {
gs.info('cookie: ' + cookies.get(i));
}
cookie: JSESSIONID=4135AA97A5D12DA22EF614AA2B0CAFD8.node20; Path=/; Secure; HttpOnly
cookie: SABASESSIONID=370152970.36895.0000; path=/SOAPResponseV2:getErrorCode()
SOAP トランザクション中にエラーが発生した場合の数値エラーコードを取得します。
このエラーコードは ServiceNow AI Platform固有のものであり、HTTP エラーコードではありません。カスタマーサービス & サポートから支援が必要な場合は、このエラーコードを入力してください。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | 数値エラーコード (ソケットタイムアウトの場合は 1 など)。 |
var errorCode = response.getErrorCode();
SOAPResponseV2:getErrorMessage()
SOAP トランザクション中にエラーが発生した場合にエラーメッセージを取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 文字列 | エラーメッセージ |
var errorMsg = response.getErrorMessage();
SOAPResponseV2:getHeader(文字列名)
指定された HTTP ヘッダーの値を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| name | 文字列 | 値を設定するヘッダーの名前 (Set-Cookie など)。 |
| タイプ | 説明 |
|---|---|
| 文字列 | 指定されたヘッダーの値。 |
var headerVal = response.getHeader("Accept");
SOAPResponseV2:getHeaders()
SOAP 応答で返されたすべての HTTP ヘッダーと関連する値を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| オブジェクト | 各ヘッダーの名前を関連する値にマップするオブジェクト。 |
var headers = response.getHeaders();
SOAPResponseV2:getStatusCode()
SOAP プロバイダーによって返された数値の HTTP ステータスコードを取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | SOAP プロバイダーによって返される数値のステータスコード (応答が成功した場合は 200 など)。 |
var statusCode = response.getStatusCode();
SOAPResponseV2:haveError()
SOAP トランザクション中にエラーが発生したかどうかを示します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| ブーリアン | エラーがあった場合は true を返し、エラーがなかった場合は false を返します。 |
var error = response.haveError();
SOAPResponseV2 - waitForResponse(Number timeoutSecs)
インスタンスが Web サービスプロバイダーからの応答を待機する時間を設定します。
このメソッドは、この SOAP 応答のプロパティ glide.soap.outbound.ecc_response.timeout を上書きします。
| 名前 | タイプ | 説明 |
|---|---|---|
| timeoutSecs | 番号 | この応答を待機する時間 (秒)。 |
| タイプ | 説明 |
|---|---|
| なし |
response.waitForResponse(60);