Zum Inhalt springen

ServiceNow (veraltet) Query-Aktivität in Jitterbit Studio

Warnung

Der ServiceNow-Connector ist veraltet und wird nicht mehr unterstützt. In einer kommenden Version wird diese Aktivität zusammen mit dem restlichen Connector dauerhaft entfernt. Verwenden Sie stattdessen die Query-Aktivität im ServiceNow v2-Connector.

Einführung

Eine ServiceNow-Query-Aktivität ruft mithilfe ihrer ServiceNow-Verbindung Datensätze aus ServiceNow ab und ist dazu vorgesehen, als Quelle Daten in einem Vorgang bereitzustellen.

ServiceNow Query-Aktivität erstellen

Eine Instanz einer ServiceNow-Query-Aktivität wird aus einer ServiceNow-Verbindung mit dem Aktivitätstyp Query erstellt.

Zum Erstellen einer Aktivitätsinstanz ziehen Sie den Aktivitätstyp auf die Designoberfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Designoberfläche ein. Weitere Informationen finden Sie unter Aktivitäts- oder Tool-Instanz erstellen in Komponenten wiederverwenden.

Eine vorhandene ServiceNow-Query-Aktivität lässt sich von diesen Orten aus bearbeiten:

ServiceNow Query-Aktivität konfigurieren

Gehen Sie folgendermaßen vor, um eine ServiceNow-Query-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Objekt auswählen

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie ein Objekt aus. Jedes Oberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Endpunkt-Menü: Wenn mehrere Endpunkte des gleichen Connector-Typs konfiguriert sind, wird ein Menü oben auf dem Bildschirm mit dem Namen des aktuellen Endpunkts angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den Namen des aktuellen Endpunkts bewegen. Klicken Sie auf diese Option, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede ServiceNow-Query-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Objekt auswählen: Dieser Abschnitt zeigt die im ServiceNow-Endpunkt verfügbaren Objekte an.

    • Ausgewähltes ServiceNow-Objekt: Nach der Auswahl eines Objekts wird es hier aufgeführt.

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Die Suche berücksichtigt nicht die Groß-/Kleinschreibung. Wenn Objekte bereits in der Tabelle angezeigt werden, wird die Tabelle in Echtzeit mit jedem Tastendruck gefiltert. Um beim Suchen Objekte vom Endpunkt neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie den Bildschirm, wie unten beschrieben.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Objekte vom ServiceNow-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Objekte zu ServiceNow hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der angezeigten Objekte in der Konfiguration verwendet werden.

  • Objekt auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Objekt auszuwählen. Es kann nur ein Objekt ausgewählt werden. Die für jedes Objekt verfügbaren Informationen werden vom ServiceNow-Endpunkt abgerufen:

    • Name: Der Objektname aus ServiceNow.

    • Typ: Der Objekttyp, entweder Tabelle oder Ansicht.

    • Beschreibung: Die Objektbeschreibung aus ServiceNow.

Tipp

Wenn die Tabelle nicht mit verfügbaren Objekten gefüllt wird, ist die ServiceNow-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

  • Speichern und beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Klicken Sie nach Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Abfrage erstellen

Erstellen Sie in diesem Schritt eine Abfrageanweisung, indem Sie Bedingungen für Objektfelder festlegen und das Paging entweder über den Abfrage-Generator oder durch manuelles Eingeben einer Abfrageanweisung anwenden. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

Hinweis

Sie können den Abfrage-Generator umgehen und eine Abfrageanweisung in das Feld Abfragezeichenfolge eingeben.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder auf das Variablensymbol klicken, um ein Menü mit vorhandenen Variablen zur Auswahl anzuzeigen.

  • Suchen: Geben Sie einen beliebigen Teil eines Feldnamens in das Suchfeld ein, um die Feldliste für das ausgewählte Objekt zu filtern. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden. Die aufgelisteten Ergebnisse werden in Echtzeit mit jedem Tastenanschlag gefiltert.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Felder des Objekts vom ServiceNow-Endpunkt neu zu laden.

  • Alle auswählen: Wenn Sie das Suchfeld zum Filtern verwenden, können Sie mit diesem Kontrollkästchen alle sichtbaren Felder auf einmal auswählen.

  • Felder auswählen: Aktivieren Sie die Kontrollkästchen der Felder, die Sie in die Abfrage einbeziehen möchten, damit diese automatisch zur Abfrageanweisung in der Abfragezeichenfolge hinzugefügt werden. Sie können auch Alle Felder auf einmal mit dem Kontrollkästchen auswählen.

  • Paging: Um eine Paging-Klausel (eine Begrenzung der Anzahl der Datensätze mit optionalem Datensatzversatz) hinzuzufügen, können Sie das Dropdown-Menü verwenden, um das Paging-Limit festzulegen, und das Feld verwenden, um einen Versatz einzugeben. Wenn kein Versatz angegeben ist, wird standardmäßig 0 verwendet. Eine einzelne Paging-Klausel wird unterstützt. Wenn keine Paging-Klausel enthalten ist, werden alle Datensätze zurückgegeben.

    • Anwenden: Klicken Sie, um die Klausel automatisch basierend auf den Dropdown-Auswahlen und dem eingegebenen Wert zu erstellen. Die automatisch erstellte Paging-Klausel wird im Textfeld Abfragezeichenfolge angezeigt.

    • Entfernen: Klicken Sie, um eine angewendete Paging-Klausel zu entfernen.

  • Bedingungen: Um bedingte Klauseln hinzuzufügen, verwenden Sie die folgenden Felder als Eingabe, um die Klauseln zu erstellen, die dann im Textfeld Abfragezeichenfolge angezeigt werden.

    • Feld: Verwenden Sie das Dropdown-Menü, um ein Feld aus dem ausgewählten Objekt auszuwählen.

    • Operator: Verwenden Sie das Dropdown-Menü, um einen Operator auszuwählen, der für den Felddatentyp geeignet ist:

      Operator Beschriftung Beschreibung
      = Gleich
      != Nicht gleich
      LIKE 'string' Ähnlich Ähnlich string
      LIKE 'string%' Beginnt mit Beginnt mit string
      LIKE '%string' Endet mit Endet mit string
      LIKE '%string%' Enthält Enthält string
      < Kleiner als
      <= Kleiner oder gleich
      > Größer als
      >= Größer oder gleich

  • Wert: Geben Sie den gewünschten Wert ein, der mit den Dropdown-Auswahlen verwendet werden soll.

  • Hinzufügen: Klicken Sie, um die Klausel automatisch basierend auf den Dropdown-Auswahlen und dem eingegebenen Wert zu erstellen. Die bedingte Klausel wird zum Textfeld Abfragezeichenfolge hinzugefügt.

  • Alle entfernen: Klicken Sie, um alle eingegebenen bedingten Klauseln zu entfernen.

    Wichtig

    Felder in der Tabelle Advanced HTTP Properties zeigen das Variablensymbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit aufgefüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.

  • Abfragezeichenfolge: Bei Auswahl von Feldern, Angabe von Bedingungen und Festlegung des Pagings wird die Abfrageanweisung in diesem Textfeld automatisch mit den ausgewählten Feldern, Bedingungen und Paging-Limits aufgefüllt. Dieses Feld ist bearbeitbar, d. h. Sie können eine Abfrageanweisung manuell eingeben oder die automatisch aufgefüllte Anweisung bearbeiten.

    Hinweis

    Die Werte von globalen Variablen, die in der Abfragezeichenfolge verwendet werden, werden bei Verwendung der Schaltfläche Abfrage testen nicht aufgefüllt, auch wenn ein Standardwert angegeben ist. Globale Variablenwerte werden zur Laufzeit abgerufen, wenn die Abfrage ausgeführt wird. Um die Abfrage mit einem Standardvariablenwert zu testen, verwenden Sie stattdessen eine Projektvariable.

  • Abfrage testen: Klicken Sie, um die Abfrage zu validieren. Wenn die Abfrage gültig ist, werden maximal 50 von der Abfrage abgerufene Datensätze in einer Tabelle angezeigt. Wenn die Abfrage ungültig ist, werden entsprechende Fehlermeldungen angezeigt.

    Hinweis

    Während der Laufzeit wird die Grenze von 50 Datensätzen nicht erzwungen, es sei denn, sie ist im Feld Paging angegeben (siehe oben). Wenn Sie die Abfragezeichenfolge manuell bearbeiten, muss die Abfrage gültig sein und durch diese Schaltfläche validiert werden, um die Schaltfläche Weiter zu aktivieren.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu gehen. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Datenschemas überprüfen

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Datenschemas: Diese Datenschemas werden von benachbarten Transformationen geerbt und werden während der Transformationszuordnung erneut angezeigt.

    Der ServiceNow-Connector verwendet die ServiceNow REST API. Weitere Informationen zu den Schemafeldern finden Sie unter Schemas und in der ServiceNow REST API unter ServiceNow-Entwicklerdokumentation. Passen Sie die Dokumentations-URL an, indem Sie Ihre ServiceNow-Releaseversion auswählen.

    Hinweis

    Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.

    Tabellennamen mit dem Präfix sys_ werden umbenannt und beginnen mit system_, um reservierte ServiceNow-Namen zu vermeiden.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom ServiceNow-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen auf das gleiche Schema verwiesen wird, z. B. in einer benachbarten Transformation.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Wichtig

ServiceNow-Aktivitätsdatetimefelder müssen ihren Datentyp auf string festgelegt haben, um ihre Daten bei Transformationen zu bewahren. Spiegeln Sie dafür das Schema in der Transformation, bearbeiten Sie es und ändern Sie den Datentyp aller dateTime-Felder in string.

Nach der Konfiguration einer ServiceNow-Aktivität vom Typ Query wird die Operationskonfiguration durch Hinzufügen und Konfigurieren anderer Aktivitäten oder Tools als Operationsschritte abgeschlossen. Sie können auch die Operationseinstellungen konfigurieren, die die Möglichkeit bieten, Operationen zu verketten, die sich im selben oder in verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

ServiceNow-Aktivitäten vom Typ Query können als Quelle mit diesen Operationsmustern verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.

Wenn alles bereit ist, stellen Sie die Operation bereit und führen Sie sie aus und überprüfen Sie das Verhalten durch Prüfung der Operationsprotokolle.