Zum Inhalt springen

ServiceNow Query-Aktivität in Jitterbit Studio

Einführung

Eine ServiceNow Query-Aktivität ruft mit ihrer ServiceNow-Verbindung Datensätze aus ServiceNow ab und dient als Quelle zur Bereitstellung von Daten in einem Vorgang.

ServiceNow Query-Aktivität erstellen

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

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Aktivitäts- oder Tool-Instanz erstellen in Komponentenwiederverwendung.

Eine vorhandene ServiceNow Query-Aktivität kann an diesen Stellen bearbeitet werden:

ServiceNow Query-Aktivität konfigurieren

Führen Sie diese Schritte aus, 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 Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. 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 aktuellen Endpunktnamen bewegen. Klicken Sie, 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 Bereich zeigt im ServiceNow-Endpunkt verfügbare Objekte an.

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

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Objektliste zu filtern. Die Suche ist nicht case-sensitiv. Wenn Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Objekte vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie nachfolgend beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Objekte vom ServiceNow-Endpunkt neu zu laden. Dies kann hilfreich 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.

    -   **Type:** Der Objekttyp, entweder _Table_ oder _View_.

-   **Description:** Die Objektbeschreibung aus ServiceNow.

    Tipp

    Falls die Tabelle nicht mit verfügbaren Objekten gefüllt wird, ist die ServiceNow-Verbindung möglicherweise nicht erfolgreich. Stelle sicher, dass du verbunden bist, indem du die Verbindung erneut öffnest und die Anmeldedaten erneut testest.

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

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

  • Discard changes: Nach Änderungen klicken, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert dich auf zu bestätigen, dass du die Änderungen verwerfen möchtest.

Step 2: Build your query

In diesem Schritt erstellst du eine Abfrageanweisung, indem du Bedingungen für Objektfelder festlegst und Paging entweder über den Query Builder oder durch manuelles Eingeben einer Abfrageanweisung anwendest. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

Hinweis

Du kannst den Query Builder umgehen und eine Abfrageanweisung direkt im Feld Query string eingeben.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginne entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicke auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen.

  • Search: Gib einen beliebigen Teil eines Feldnamens in das Suchfeld ein, um die Feldliste für das ausgewählte Objekt zu filtern. Die Suche berücksichtigt keine Groß- und Kleinschreibung. Die aufgelisteten Ergebnisse werden in Echtzeit mit jedem Tastendruck gefiltert.

  • Refresh: Klicke auf das Aktualisierungssymbol oder das Wort Refresh, um die Felder des Objekts vom ServiceNow-Endpunkt neu zu laden.

  • Select All: Wenn du das Suchfeld zum Filtern verwendest, kannst du dieses Kontrollkästchen verwenden, um alle sichtbaren Felder auf einmal auszuwählen.

  • Select Fields: Wähle die Kontrollkästchen der Felder aus, die du in die Abfrage einbeziehen möchtest, damit sie automatisch zur Abfrageanweisung im Feld Query string hinzugefügt werden. Du kannst auch alle Felder auf einmal mit dem Kontrollkästchen auswählen.

  • Paging: Um eine Paging-Klausel hinzuzufügen (eine Begrenzung der Anzahl der Datensätze mit optionalem Datensatzoffset), kannst du das Dropdown-Menü verwenden, um das Paging-Limit festzulegen und das Feld zum Eingeben eines Offsets zu verwenden. Wenn kein Offset angegeben wird, wird standardmäßig 0 verwendet. Eine einzelne Paging-Klausel wird unterstützt. Wenn keine Paging-Klausel enthalten ist, werden alle Datensätze zurückgegeben.

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

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

  • Conditions: Um bedingte Klauseln hinzuzufügen, verwende die folgenden Felder als Eingabe, um die Klauseln zu erstellen, die dann im Textfeld Query string angezeigt werden.

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

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

      Operator Label Description
      = Equals
      != Not equals
      LIKE 'string' Like Like string
      LIKE 'string%' Starts with Starts with string
      LIKE '%string' Ends with Ends with string
      LIKE '%string%' Contains Contains string
      < Less than
      <= Less or equal
      > Greater than
      >= Greater or equal

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

  • Hinzufügen: Klicken Sie, um die Klausel automatisch basierend auf den Dropdown-Auswahlmöglichkeiten 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 Erweiterte HTTP-Eigenschaften zeigen das Variablensymbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit gefüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.

  • Abfragezeichenfolge: Während Sie Felder auswählen, Bedingungen angeben und Paging festlegen, wird die Abfrageanweisung in diesem Textfeld automatisch mit den ausgewählten Feldern, Bedingungen und Paging-Limits gefüllt. Dieses Feld ist bearbeitbar, sodass Sie eine Abfrageanweisung manuell eingeben oder die automatisch gefüllte Anweisung bearbeiten können.

    Hinweis

    Die Werte aller globalen Variablen, die in der Abfragezeichenfolge verwendet werden, werden bei Verwendung der Schaltfläche Abfrage testen nicht gefü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 Datensätze aus der Abfrage in einer Tabelle angezeigt. Wenn die Abfrage nicht gültig ist, werden relevante Fehlermeldungen angezeigt.

    Hinweis

    Während der Laufzeit wird das Limit von 50 Datensätzen nicht erzwungen, es sei denn, es 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 wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

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

Schritt 3: Überprüfen Sie die Datenschemas

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

  • Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden erneut während der Transformationszuordnung 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 Developer-Dokumentation. 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, um mit system_ zu beginnen, 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 generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden 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 Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Wichtig

ServiceNow-Aktivitäten für Datums-/Uhrzeitfelder müssen ihren Datentyp auf string setzen, um ihre Daten in Transformationen zu bewahren. Spiegeln Sie dazu das Schema in der Transformation, bearbeiten Sie es und ändern Sie den Datentyp aller dateTime-Felder in string.

Nach der Konfiguration einer ServiceNow-Query-Aktivität schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

ServiceNow-Query-Aktivitäten können als Quelle mit diesen Vorgangsmustern 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 Sie bereit sind, stellen Sie den Vorgang bereit und führen Sie ihn aus und validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.