SOAPResponseV2 : dans le champ d’application, global

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture

    • L’API SOAPResponseV2 fournit des méthodes qui utilisent les données renvoyées par un message SOAP sortant dans le code JavaScript.

    Un objet SOAPResponseV2 est renvoyé par les méthodes SOAPMessageV2execute() et executeAsync().

    Vous pouvez utiliser cette API dans des applications incluses dans le périmètre ou dans le périmètre global.

    Cette API s’exécute dans l’espace de noms sn_ws .

    Voir aussi :

    SOAPResponseV2 : getAllHeaders()

    Renvoie tous les en-têtes contenus dans la réponse, y compris les en-têtes en double.

    Tableau 1. Paramètres
    Nom Type Description
    Aucun
    Tableau 2. Renvoie
    Type Description
    Liste <GlideHTTPHeader> Liste des en-têtes contenus dans la réponse. Chaque en-tête est représenté sous la forme d’un objet GlideHTTPHeader qui contient le nom et la valeur de l’en-tête. 
    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()

    Obtient le contenu du corps de la réponse SOAP.

    Tableau 3. Paramètres
    Nom Type Description
    Aucun
    Tableau 4. Renvoie
    Type Description
    Chaîne Corps de la réponse SOAP. 
    var body = response.getBody();

    SOAPResponseV2 : getCookies()

    Renvoie tous les cookies inclus dans la réponse.

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    Tableau 6. Renvoie
    Type Description
    Objet Tableau de chaînes représentant les cookies. Itérez dans le tableau pour effectuer des opérations sur chaque cookie.

    Affichez les cookies individuels de la réponse.

    var cookies = response.getCookies();
for (var i = 0; i < cookies.length; i++) {
  gs.info('cookie: ' + cookies.get(i));
}
    Sortie : 
    cookie: JSESSIONID=4135AA97A5D12DA22EF614AA2B0CAFD8.node20; Path=/; Secure; HttpOnly
cookie: SABASESSIONID=370152970.36895.0000; path=/

    SOAPResponseV2 : getErrorCode()

    Obtient le code d’erreur numérique en cas d’erreur pendant la transaction SOAP.

    Ce code d’erreur est spécifique au , il ne s’agit pas d’un ServiceNow AI Platform code d’erreur HTTP. Fournissez ce code d’erreur si vous avez besoin de l’aide de .Service client et assistance

    Tableau 7. Paramètres
    Nom Type Description
    Aucun
    Tableau 8. Renvoie
    Type Description
    Numéro Code d’erreur numérique, par exemple 1 pour le délai d’expiration d’un socket. 
    var errorCode = response.getErrorCode();

    SOAPResponseV2 : getErrorMessage()

    Obtient le message d’erreur en cas d’erreur lors de la transaction SOAP.

    Tableau 9. Paramètres
    Nom Type Description
    Aucun
    Tableau 10. Renvoie
    Type Description
    Chaîne Message d'erreur 
    var errorMsg = response.getErrorMessage();

    SOAPResponseV2 : getHeader(nom de chaîne)

    Obtient la valeur d’un en-tête HTTP spécifié.

    Tableau 11. Paramètres
    Nom Type Description
    nom Chaîne Nom de l’en-tête pour lequel vous voulez la valeur, par exemple Set-Cookie.
    Tableau 12. Renvoie
    Type Description
    Chaîne Valeur de l’en-tête spécifié. 
    var headerVal = response.getHeader("Accept");

    SOAPResponseV2 - getHeaders()

    Obtient tous les en-têtes HTTP renvoyés dans la réponse SOAP et les valeurs associées.

    Remarque :
    Si un en-tête est présent plus d’une fois dans la réponse, tel qu’un en-tête Set-Cookie, cette fonction renvoie uniquement le dernier des en-têtes en double. Pour renvoyer tous les en-têtes, y compris les doublons, utilisez la fonction getAllHeaders( ).
    Tableau 13. Paramètres
    Nom Type Description
    Aucun
    Tableau 14. Renvoie
    Type Description
    Objet Objet qui mappe le nom de chaque en-tête à la valeur associée. 
    var headers = response.getHeaders();

    SOAPResponseV2 : getStatusCode()

    Obtient le code d’état HTTP numérique renvoyé par le fournisseur SOAP.

    Tableau 15. Paramètres
    Nom Type Description
    Aucun
    Tableau 16. Renvoie
    Type Description
    Numéro Code d’état numérique renvoyé par le fournisseur SOAP, tel que 200 pour une réponse réussie. 
    var statusCode = response.getStatusCode();

    SOAPResponseV2 - haveError()

    Indique si une erreur s’est produite lors de la transaction SOAP.

    Tableau 17. Paramètres
    Nom Type Description
    Aucun
    Tableau 18. Renvoie
    Type Description
    booléen Renvoie la valeur vrai s’il y a eu une erreur, faux s’il n’y a pas eu d’erreur. 
    var error = response.haveError();

    SOAPResponseV2 : waitForResponse(Number timeoutSecs)

    Définit le délai d’attente de l’instance pour une réponse du fournisseur de service web.

    Cette méthode remplace la propriété glide.soap.outbound.ecc_response.timeout de cette réponse SOAP.

    Tableau 19. Paramètres
    Nom Type Description
    timeoutSecs Numéro Durée, en secondes, d’attente de cette réponse.
    Tableau 20. Renvoie
    Type Description
    nul 
    response.waitForResponse(60);