ServiceNow v2 Query-Aktivität in Jitterbit Studio

Einführung

Eine ServiceNow v2 Query-Aktivität verwendet ihre ServiceNow v2-Verbindung und ruft Datensätze aus ServiceNow ab. Sie ist als Quelle gedacht, um Daten in einem Vorgang bereitzustellen.

ServiceNow v2 Query-Aktivität erstellen

Eine Instanz einer ServiceNow v2 Query-Aktivität wird aus einer ServiceNow v2-Verbindung mit ihrem Query-Aktivitätstyp 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 Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene ServiceNow v2 Query-Aktivität kann von diesen Orten aus bearbeitet werden:

• Die Design-Canvas (siehe Komponentenaktionsmenü in Design-Canvas).
• Die Registerkarte Komponenten des Projektbereichs (siehe Komponentenaktionsmenü in Projektbereich-Registerkarte „Komponenten").

ServiceNow v2 Query-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine ServiceNow v2 Query-Aktivität zu konfigurieren:

• Schritt 1: Namen eingeben und ServiceNow-Objekt auswählen
  Geben Sie einen Namen für die Aktivität ein und wählen Sie ein ServiceNow-Objekt aus.

• Schritt 2: Abfrage erstellen
  Legen Sie Bedingungen für eine Abfrage mit den Objektfeldern fest und wenden Sie Paging auf eine Abfrage an.

• Schritt 3: Datenschemas überprüfen
  Alle Anfrage- oder Antwortschemas werden angezeigt.

Schritt 1: Namen eingeben und ServiceNow-Objekt auswählen

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

• Endpunkt-Menü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, 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 v2 Query-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

• Objekt auswählen: Dieser Bereich zeigt Objekte an, die im ServiceNow v2-Endpunkt verfügbar sind.

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

  • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte 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 unten beschrieben.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Objekte vom ServiceNow v2-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 verfügbaren Informationen für jedes Objekt werden vom ServiceNow v2-Endpunkt abgerufen:

• Name: Der Objektname aus ServiceNow.

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

  Tipp

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

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

• Next: 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 Finished im letzten Schritt klicken.

• Discard changes: Klicken Sie nach dem Vornehmen von Ä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.

Step 2: Build your query

In diesem Schritt legen Sie Bedingungen für eine Abfrage mit den ServiceNow-Objektfeldern fest und wenden Paging auf eine Abfrage an. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

• Search: 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 Tastendruck gefiltert.

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

• Select All: Wenn Sie das Suchfeld zum Filtern verwenden, können Sie dieses Kontrollkästchen verwenden, um alle sichtbaren Felder auf einmal auszuwählen.

• Select Fields: Aktivieren Sie die Kontrollkästchen der Felder, die Sie in die Abfrage einbeziehen möchten, damit diese automatisch zur SELECT-Anweisung in der Query String hinzugefügt werden. Sie können auch alle Felder auf einmal mit dem Kontrollkästchen auswählen.

• Paging: Um eine Paging-Klausel (ein Limit für die Anzahl der Datensätze mit optionalem Datensatzoffset) hinzuzufügen, können Sie das Dropdown-Menü verwenden, um das Paging-Limit und das Feld für die Eingabe eines Offsets festzulegen. Wenn kein Offset 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.

  • Apply: 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 Query String angezeigt.

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

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

  • Field: 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	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.

  Tipp

  Bei Verwendung von globalen Variablen in den Bedingungen einer WHERE-Klausel wird empfohlen, einen Standardwert anzugeben, damit das Skript getestet werden kann. Da globale Variablen ihren Wert zur Laufzeit erhalten, kann die Syntax während des Tests ungültig werden oder es werden keine Daten zurückgegeben, wenn kein Standardwert angegeben ist.

• 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.

• Abfragezeichenfolge: Während Sie Felder auswählen, Bedingungen angeben und Paging festlegen, wird das Abfrageanweisung in diesem Textfeld automatisch mit den ausgewählten Feldern, Bedingungen und Paging-Limits gefüllt. Diese Anweisung kann bearbeitet werden.

  Tipp

  Die Abfragezeichenfolge akzeptiert Standard-SQL-Syntax für Klauseln, die nicht mit den Optionen Bedingungen und Paging oben verfügbar sind. Fügen Sie beispielsweise eine ORDER BY-Klausel hinzu, um Ergebnisse zu sortieren (ORDER BY <field> ASC oder ORDER BY <field> DESC), oder verwenden Sie IS NULL und IS NOT NULL in einer WHERE-Klausel, um zu filtern, ob ein Feld einen Wert hat.

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

  Hinweis

  Während der Laufzeit wird die Beschränkung auf 50 Datensätze nicht erzwungen, es sei denn, sie ist im Feld Paging angegeben (siehe oben).

• 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 die Schaltfläche Fertig im letzten Schritt klicken.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem 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 Request- oder Response-Schemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

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

  Hinweis

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

  Der ServiceNow v2-Connector verwendet die ServiceNow REST API. Informationen zu den Schemanknoten und Feldern finden Sie in der API-Dokumentation.

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom ServiceNow v2-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 die in einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer ServiceNow v2 Query-Aktivität wird die Konfiguration des Vorgangs durch Hinzufügen und Konfigurieren weiterer Aktivitäten, Transformationen oder Skripte als Vorgangsschritte abgeschlossen. Du kannst 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 Designoberfläche zugänglich. Weitere Informationen findest du unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

ServiceNow v2 Query-Aktivitäten können als Quelle mit diesen Vorgangsmustern verwendet werden:

• Transformationsmuster
• Zwei-Ziel-Archivmuster (nur als erste Quelle)
• Zwei-Ziel-HTTP-Archivmuster (nur als erste Quelle)
• Zwei-Transformationsmuster (als erste oder zweite Quelle)

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

Wenn alles bereit ist, stelle den Vorgang bereit und führe ihn aus und validiere das Verhalten durch Überprüfung der Vorgangsprotokolle.