Erstellen Sie einen neuen geskripteten SOAP Web Service

Folgen Sie diesen Beispielen, um einen neuen geskripteten SOAP Web Service 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

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

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 ein benutzerdefinierter geskripteter Webservice erstellt wird, um etwas Bestimmtes zu tun, was die direkten Webservices des Basissystems ServiceNow nicht können.

Abbildung : 3. GetProperty-Webservice

Beispiel 2: Bestellen eines Blackberry

Direkte Webservices werden für Tabellen und deren Daten ausgeführt. Das folgende Beispiel zeigt, wie eine Geschäftslösung initiiert wird, z. B. die Bestellung eines Blackberry, indem ein geskripteter Webservice aufgerufen wird. Die folgenden Eingabe- und Ausgabeparameter unterstützen das Blackberry-Beispiel:

Abbildung : 4. Eingabe Ausgabe Blackberry

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');