Créer un service Web SOAP scripté

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 Services Web basés sur des scripts est disponible sous l’application Services Web du système .

    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 Web Service. 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 faire quelque chose de spécifique que les services Web directs du système de base ServiceNow ne peuvent pas faire.

    Figure 3. Service Web GetProperty

    Service Web GetProperty

    Exemple 2 : Commander un Blackberry

    Les services Web directs fonctionnent sur les tables et leurs données. L’exemple suivant montre comment lancer une solution d’entreprise, comme 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 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');