SOAPResponseV2 - Champ d’application, global

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 3 minutes de lecture
  • L’API SOAPResponseV2 vous permet d’utiliser les données renvoyées par un message SOAP sortant en 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 .

    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 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 à travers 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 au cours de la transaction SOAP.

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

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

    SOAPResponseV2 : getErrorMessage()

    Obtient le message d’erreur en cas d’erreur au cours 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 dont vous souhaitez obtenir 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 plusieurs fois dans la réponse, par exemple un en-tête Set-Cookie, cette fonction renvoie uniquement le dernier des en-têtes dupliqués. 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, par exemple 200 pour une réponse réussie.
    var statusCode = response.getStatusCode();

    SOAPResponseV2 - haveError()

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

    Tableau 17. Paramètres
    Nom Type Description
    Aucun
    Tableau 18. Renvoie
    Type Description
    booléen Renvoie 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 la durée pendant laquelle l’instance attend une réponse du fournisseur de service Web.

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

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