Erstellen Sie einen neuen SOAP Web Service mit Skript

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 1 Minute Lesedauer
  • Folgen Sie diesen Beispielen, um einen neuen SOAP Web Service mit Skript zu erstellen.

    Wenn das Plugin „Web Services Provider - Scripted“ aktiviert ist, ist ein neues Modul Geskriptete Webservices unter der Anwendung System-Webservices verfügbar.

    Abbildung : 1. Scripted SOAP Web Services

    Scripted SOAP Web Services

    Beispiel 1: Abrufen einer Systemeigenschaft

    Der erste Schritt besteht darin, die eingehenden und ausgehenden Parameter zu definieren. Dies geschieht durch Hinzufügen eines Eintrags zu Eingabeparameter und Ausgabeparameter. Diese Parameter werden verwendet, um eine sinnvolle WSDL zu erstellen und darzustellen, und sie ergänzen nicht die Funktionalität der eigentlichen Verarbeitung des Webservice.

    Abbildung : 2. GetProperty-Eingabe- und -Ausgabeparameter

    GetProperty-Eingabeparameter

    GetProperty-Ausgabeparameter

    Die Parameter werden im Skript des Webservice referenziert. Alle Eingabeparameter werden mit folgender Syntax abgerufen:
    var a= request.property;
    Die Ausgabeparameter werden mithilfe der folgenden Syntax festgelegt:
    response.property="ABC";

    Im folgenden Beispiel wird veranschaulicht, wie eine Systemeigenschaft abgerufen und als Teil der SOAP-Antwort zurückgegeben wird. Das Beispiel zeigt, wie Sie einen anwenderdefinierten Webservice mit Skript erstellen, um etwas Bestimmtes zu tun, was die direkten Webservices des Basissystems ServiceNow nicht können.

    Abbildung : 3. GetProperty-Webservice

    GetProperty-Webservice

    Beispiel 2: Bestellen eines Blackberry

    Direkte Webservices werden mit Tabellen und deren Daten ausgeführt. Das folgende Beispiel zeigt, wie Sie durch Aufrufen eines geskripteten Webservice eine Geschäftslösung initiieren, z. B. die Bestellung eines Blackberry. Die folgenden Eingabe- und Ausgabeparameter unterstützen das Blackberry-Beispiel:

    Abbildung : 4. Eingabe/Ausgabe Blackberry

    OrderBlackBerry-Eingabeparameter

    OrderBlackBerry-Ausgabeparameter

    Dieses Skript zeigt, wie Sie die oben genannten Parameter verwenden, um einen Blackberry zum Warenkorb des Servicekatalogs hinzuzufügen und ihn zu bestellen. Die Anforderungsnummer wird im Feld request_number der SOAP-Antwort zurückgegeben.
    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');