Erstellen eines Importsatz-Webservice

Erstellen Sie eine Webdienst-Importsatztabelle, um zu definieren, wie importierte Daten bereitgestellt und transformiert werden.

Navigieren zu Alle > System-Webservices > Eingang > Neu erstellen:.

Abbildung : 1. Webservice erstellen

Der Name des Webservice ist der Tabellenname der Importsatztabelle, während das Feld Bezeichnung das Feld der resultierenden Tabelle ist.

Wenn Sie nach dem Erstellen des Webservice eine -Transformationszuordnung erstellen möchten, aktivieren Sie das Kontrollkästchen Transformationszuordnung erstellen, und wählen Sie die Zieltabelle aus, in die die Daten umgewandelt werden sollen. Nach dem Klicken auf die Schaltfläche Erstellen wird der Webservice erstellt, und Sie gelangen sofort in das Formular „ Tabellentransformationszuordnung “. Anschließend können Sie die Transformationszuordnung oder das Skript angeben.

Webservice-Felder

Die für diesen Webservice verfügbaren Felder. Standardmäßig werden alle Felder als XSD-Typ xsd:stringveröffentlicht. Name ist das Feld, das für den Webservice verfügbar gemacht wird, und wird daher als Name des Felds in WSDL angezeigt. Die Bezeichnung ist die Bezeichnung des Felds, wie sie für die Importsatztabelle angezeigt wird.

Sie können ein vorhandenes Webservice-Feld in dieser Liste hinzufügen, zum Löschen markieren oder ändern (durch Doppelklicken auf das Feld).

Hinweis:

Klicken Sie nach dem Hinzufügen von Webservice-Feldern auf Erstellen, um die Importsatztabelle für den Webservice zu erstellen.

Um nach der Erstellung des Webservice weitere Felder hinzuzufügen, suchen Sie die Zieltabelle, und fügen Sie die Felder zu dieser Tabelle hinzu.

Importsätze für Webservice-Zuordnungen

Während der Erstellung des Webdienst-Importsatzes können Sie optional die Transformationszuordnung dafür erstellen.

Alle Transformationszuordnungen werden für den Service ausgeführt, wenn er aufgerufen wird und der Importsatzmodus auf „Synchron“ (Standardeinstellung) festgelegt ist.

Die folgende Abbildung zeigt ein Beispiel für die Transformationszuordnung, die dem Importsatz des Webservice für Benachrichtigungen zugeordnet ist.

Abbildung : 2. Transformationszuordnung für Benachrichtigungen

Werte für die Webservice-Antwort werden hinzugefügt

Im Transformationszuordnungsskript, das einem Webdienst-Importsatz zugeordnet ist, können einige Variablenwerte die Antwortwerte des Webdiensts ändern. Zusätzlich zu den normalen Variablen, die in einem -Transformationszuordnungsskript verfügbar sind, dokumentiert die Tabelle die verfügbaren Variablen und ihre Auswirkungen.

Tabelle : 1. Werte für die Webservice-Antwort werden hinzugefügt

Variablenname	Typ	Beschreibung
response	Ausgabeobjekt	Javascript-Objekt, das dynamisch erstellte Antwortelemente enthält, die zum Anpassen der Ausgabeantwort einer Webservice-Importsatzeinfügung verwendet werden.

Beispiel

// create new elements called "transaction_id" 
// and "hello" in the web service response
response.transaction_id="abc123";
response.hello="world";
 
status_message="message 1";
// this is the normal status_message variable

Das Code-Fragment-Beispiel führt dazu, dass die folgende Antwort an den Webservice-Verbraucher generiert wird

<soapenv:Envelopexmlns:imp="http://www.service-now.com/imp_notification"                  
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header/><soapenv:Body>
<insertResponse xmlns="http://www.service-now.com/imp_notification">
  <sys_id>969d157c0a0a0baf008ba5770ffa798c</sys_id>
  <table>incident</table>
  <display_name>number</display_name>
  <display_value>INC0010091</display_value>
  <status>inserted</status>
  <status_message>message 1</status_message>
  <transaction_id>abc123</transaction_id>
  <hello>world</hello>
</insertResponse>
</soapenv:Body></soapenv:Envelope>

Webservice-Importsätze debuggen

Um eine im System eingehende SOAP-Anforderung zu debuggen, erstellen Sie die Systemeigenschaft glide.processor.debug.SOAPProcessor.

Legen Sie nach der Erstellung den Wert auf „ true “ fest, damit alle SOAP-Anforderungen im Systemprotokoll protokolliert werden. Setzen Sie die Option auf „ false “, wenn Sie fertig sind, um die Größe Ihres Systemprotokolls auf einer verwalteten Länge zu halten.