Créer un nouveau service Web SOAP scripté

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 1 minute de lecture
  • Suivez ces exemples pour créer un nouveau service Web SOAP scripté.

    Lorsque le module d’extension Fournisseur de services Web - Scripté est activé, un nouveau module Scripted Web Services est disponible sous l’application System Web Services .

    Figure 1. Scripted SOAP Web Services

    Services Web SOAP scriptés

    Exemple 1 : Récupération d’une propriété système

    La première étape consiste à définir les paramètres d’entrée et de retour. Pour ce faire, ajoutez une entrée aux paramètres d’entrée et de sortie. Ces paramètres sont utilisés pour construire et présenter un WSDL significatif, et ils n’ajoutent pas à la fonctionnalité de traitement du service Web lui-même.

    Figure 2. Paramètres d’entrée et de sortie GetProperty

    Paramètres d’entrée GetProperty

    Paramètres de sortie GetProperty

    Les paramètres sont référencés dans le script du service Web. Tous les paramètres d’entrée sont récupérés à l’aide de la syntaxe suivante :
    var a= request.property;
    Les paramètres de sortie sont définis à l’aide de la syntaxe suivante :
    response.property="ABC";

    L’exemple suivant montre comment récupérer une propriété système et la renvoyer dans le cadre de la réponse SOAP. L’exemple montre comment créer un service Web scripté personnalisé pour effectuer une action spécifique que les services Web directs du système de base ServiceNow ne peuvent pas effectuer.

    Figure 3. Service Web GetProperty

    Service Web GetProperty

    Exemple 2 : Commande d’un Blackberry

    Les services Web directs fonctionnent sur des tables et leurs données. L’exemple suivant montre comment initier une solution d’entreprise, telle que la commande d’un Blackberry, en appelant un service Web scripté. Les paramètres d’entrée et de sortie suivants prennent en charge l’exemple du Blackberry :

    Figure 4. Entrée sortie Blackberry

    Paramètres d’entrée OrderBlackBerry

    Paramètres de sortie OrderBlackBerry

    Ce script montre comment utiliser les paramètres ci-dessus pour ajouter un Blackberry au panier d’achats du catalogue de services et le commander. Le numéro de demande est renvoyé dans le champ request_number de la réponse SOAP.
    var cart = new Cart();
    var item = cart.addItem('e2132865c0a8016500108d9cee411699');
    cart.setVariable(item,'original', request.phone_number);
     
    // set the requested for
    var gr = new GlideRecord("sys_user");
    gr.addQuery("user_name", request.requested_for);
    gr.query();
    
    if(gr.next()){
      var cartGR = cart.getCart();
      cartGR.requested_for = gr.getUniqueValue();
      cartGR.update();
    }
     
    var rc = cart.placeOrder();
    response.request_number= rc.getValue('number');