Erstellen eines Import Set-Webservices

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer
  • Erstellen Sie eine Import Set-Tabelle für Webservices, um zu definieren, wie importierte Daten bereitgestellt und transformiert werden.

    Navigieren zu Alle > System-Webservices > Eingehend > Neu erstellen.

    Abbildung : 1. Webservice erstellen

    Der Name des Webservice ist der Tabellenname der Import Set-Tabelle, während das Feld Bezeichnung das resultierende Tabellenfeld ist.

    Wenn Sie nach dem Erstellen des Webservices 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. Nachdem die Schaltfläche Erstellen ausgewählt wurde, wird der Webservice erstellt, und Sie werden sofort in das Formular „ Tabellentransformationszuordnung “ versetzt. Sie können dann die Transformationszuordnung oder das Skript angeben.

    Webservice-Felder

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

    Sie können ein vorhandenes Webservice-Feld in dieser Liste hinzufügen, zum Löschen markieren oder ändern (auf das Feld doppelklicken).
    Hinweis:
    Klicken Sie nach dem Hinzufügen von Webservice-Feldern auf Erstellen, um die Import Set-Tabelle für Webservices zu erstellen.

    Um weitere Felder hinzuzufügen, nachdem der Webservice erstellt wurde, suchen Sie die Zieltabelle, und fügen Sie die Felder zu dieser Tabelle hinzu.

    Import Sets für Webservices werden zugeordnet

    Während der Erstellung des Webservice-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 Import Set-Modus auf „Synchron“ (Standard) festgelegt ist.

    Die folgende Abbildung zeigt ein Beispiel für die Transformationszuordnung, die dem Import Set des Benachrichtigungs-Webservices zugeordnet ist.
    Abbildung : 2. Benachrichtigungs-Transformationszuordnung

    Hinzufügen von Webservice-Antwortwerten

    Im Transformationszuordnungsskript, das einem Webservice-Import Set zugeordnet ist, können einige Variablenwerte die Antwortwerte des Webservices ändern. Zusätzlich zu den normalen Variablen, die in einem -Transform Map-Skript verfügbar sind, dokumentiert die Tabelle die verfügbaren Variablen und ihre Auswirkungen.
    Tabelle : 1. Hinzufügen von Webservice-Antwortwerten
    Variablenname Typ Beschreibung
    Antwort Ausgabeobjekt Javascript-Objekt, das dynamisch erstellte Antwortelemente enthält, die zum Anpassen der Ausgabeantwort einer Webservice-Import Set-Einfü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>

    Debugging von Webservice-Importsätzen

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

    Nachdem Sie sie erstellt haben, legen Sie sie 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.