ServiceNow v2 (Beta) Query-Aktivität in Jitterbit Studio

Einführung

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

Erstellen einer ServiceNow v2 (Beta) Query-Aktivität

Eine Instanz einer ServiceNow v2 (Beta) Query-Aktivität wird aus einer ServiceNow v2 (Beta) 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 Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene ServiceNow v2 (Beta) 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).

Konfigurieren einer ServiceNow v2 (Beta) Query-Aktivität

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

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

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

• Schritt 3: Überprüfen Sie die Datenschemas
  Alle Request- oder Response-Schemas werden angezeigt.

Schritt 1: Geben Sie einen Namen ein und wählen Sie ein ServiceNow-Objekt

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.

• Endpoint-Menü: Wenn Sie mehrere Endpoints desselben Connector-Typs konfiguriert haben, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpoint-Namen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpoint zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpoint ändern in Konfigurationsbildschirme.

  • Endpoint bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpoint-Namen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpoints zu bearbeiten.

• Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede ServiceNow v2 (Beta) 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 (Beta) Endpoint 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 Endpoint 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 (Beta) Endpoint neu zu laden. Dies kann nützlich sein, wenn Objekte zu ServiceNow hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Objekttabelle 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 v2 (Beta) Endpoint 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 (Beta) 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, klicke hier, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

• Next: Klicke hier, 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: Nachdem du Änderungen vorgenommen hast, klicke hier, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt 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 legst du Bedingungen für eine Abfrage mit den ServiceNow-Objektfeldern fest und wendest Paging auf eine Abfrage an. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

• Search: Gib einen beliebigen Teil eines Feldnamens in das Suchfeld ein, um die Feldliste für das ausgewählte Objekt zu filtern. Die Suche ist nicht case-sensitiv. Die aufgelisteten Ergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert.

• Refresh: Klicke auf das Aktualisierungssymbol oder das Wort Refresh, um die Felder des Objekts vom ServiceNow v2 (Beta) 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 SELECT-Anweisung in der Query String hinzugefügt werden. Du kannst 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, kannst du das Dropdown-Menü verwenden, um das Paging-Limit und das Feld für die Eingabe eines Offsets festzulegen. 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: Klicke hier, 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: Klicke hier, 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.

  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 Bedingungsklausel wird zum Textfeld Abfragezeichenfolge hinzugefügt.

• Alle entfernen: Klicken Sie, um alle eingegebenen Bedingungsklauseln 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 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).

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

• 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 (Beta)-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 (Beta)-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf das gleiche 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 beliebigen 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 (Beta)-Aktivität Abfrage schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten, Transformationen oder Skripte 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 v2 (Beta) Query-Aktivitäten können als Quelle mit diesen Operationsmustern 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, 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 die Operation bereit und führen Sie sie aus und überprüfen Sie das Verhalten durch Überprüfung der Operationsprotokolle.