REST erstellen ( IntegrationHub) Typdatenquelle
Erstellen Sie einen REST (IntegrationHub) Geben Sie den Datenquellendatensatz ein, um zu definieren, welche Daten ein Importsatz aus einer REST-API importieren soll.
Vorbereitungen
Prozedur
- Navigieren zu Alle > System-Importsätze > Administration > Datenquellenan.
- Klicken Sie auf Neu.
-
Füllen Sie das Formular aus.
Feld Beschreibung Name Ein eindeutiger Name für diese Datenquelle. Tabellenbezeichnung für Importsatz Eine Bezeichnung für die zu verwendende Importsatz-Bereitstellungstabelle. Tabellenname für Importsatz Die ServiceNow AI Platform Verwendet die von Ihnen eingegebene Bezeichnung, um einen eindeutigen Tabellennamen zu erstellen. Dies verhindert eine Namespace-Kollision mit einer bereits vorhandenen Tabelle. Typ REST (IntegrationHub) . Format Eines der folgenden Formate: Anwenderdefiniert (nach Skript analysieren), JSON oder XML. Batch-Import verwenden Wenn diese Option ausgewählt ist, wird angegeben, dass beim Laden von Daten Batches erstellt werden sollen, wenn Sie auf klicken Daten laden Oder Testlast 20 Datensätze . Batchgröße Gibt an, wie groß die Batches sein sollen. Wird nur angezeigt, wenn Verwenden Sie Batch-Import Feld ist ausgewählt. Die glide.import_set_load_usebatchUnd glide.import_set_load_batch_sizeEigenschaften wirken sich auf diese Felder aus. Die Prioritätsreihenfolge für die Eigenschaften und Felder lautet wie folgt: Wenn die Eigenschaft festgelegt ist, verwenden Sie den Eigenschaftswert. Wenn nicht, verwenden Sie den Feldwert. Wenn keine der Eigenschaften festgelegt ist, verwenden Sie die Standard-Batch-Größe von 1000.- Beispiel: Wenn glide.import_set_load_usebatch= Wahr Und glide.import_set_load_batch_size= 200 , Verwenden Sie 200 als Batchgröße, unabhängig von den Feldwerten.
- Beispiel: Wenn glide.import_set_load_usebatch= Wahr Und glide.import_set_load_batch_sizeEigenschaft ist nicht festgelegt. Verwenden Sie die Standard-Batch-Größe von 1000.
- Beispiel: Wenn glide.import_set_load_usebatchEigenschaft und nicht festgelegt Verwenden Sie Batch-Import Feld = Wahr , Verwenden Sie Batch-Größe Feldwert (oder der Standardwert 1000, wenn der Batch-Größe Feldwert ist nicht festgelegt)
- Beispiel: Wenn glide.import_set_load_usebatchEigenschaft = falsch und Verwenden Sie Batch-Import Feld = wahr, verwenden Sie keinen Batch-Import, da die Eigenschaft auf „falsch“ festgelegt ist.
Anforderungsaktion Anforderungsaktion für Datenquelle, die zum Abrufen von Daten aufgerufen wird. Sie können nur veröffentlichte Anforderungsaktionen auswählen. Klicken Sie auf den Link im Dialogfeld unten, um eine neue Datenquellenanforderungsaktion in zu erstellen/zu konfigurieren IntegrationHub. Nachdem die Anforderungsaktion in veröffentlicht wurde IntegrationHub, Sie können es als auswählen Anforderungsaktion Im Datenquellendatensatz. Weitere Informationen finden Sie unter Aktionseigenschaften definieren.
Paginierung unterstützen Ausgewählt, um die Paginierung für die Anforderungsaktion zu aktivieren. Paginierung hilft Ihnen, den Verarbeitungsaufwand zu reduzieren, indem eine bestimmte Anzahl von Datensätzen gleichzeitig verarbeitet wird, anstatt alle Datensätze gleichzeitig zu verarbeiten. Grenzwert Maximale Anzahl von Datensätzen pro Seite. Um beispielsweise 50 Datensätze gleichzeitig zu verarbeiten, geben Sie ein Grenzwert Von 50. Offset Der anfängliche Offset, der für die Paginierung verwendet wird. Der Offset ist die Nummer des Startdatensatzes. Um beispielsweise 50 Datensätze gleichzeitig zu verarbeiten, geben Sie ab dem ersten Datensatz einen ein Grenzwert Von 50 und an Offset Von 0. Analyseskript Geben Sie das Skript ein, das zum Analysieren einer einzelnen Eingabezeile verwendet wird. In dieser Funktion sind drei Parameter verfügbar: - Position : Die aktuelle Zeile, die vom Skript analysiert werden soll
- Zeilennummer : Die Zeilennummer der aktuellen Zeile in der gesamten Antwortnutzlast
- Ergebnis : Ausgabeergebnis
Pfad für jede Zeile Der Pfadausdruck, der zum Auswählen von JSON-Objekten verwendet wird, die zu Zeilen in der Importsatztabelle werden. Der Pfad muss sein // Für JSON-Objekte. Arrays verwerfen Ausgewählt, um JSON-Arrays als Wert zu verwerfen. Deaktiviert, um JSON-Arrays als Wert zu serialisieren. Untergeordnete Knotenelemente erweitern Ausgewählt, wenn untergeordnete Elemente des XML-Knotens oder JSON-Objekts in zusätzliche Spalten konvertiert werden sollen. Deaktiviert, wenn der Wert der übergeordneten Spalte ein XML- oder JSON-Fragment sein soll. Beachten Sie für JSON, dass die Auswahl dieser Option nur Objekte erweitert, nicht Arrays. Informationen zur Unterstützung geschachtelter Arrays finden Sie unter Beispiele für JSON-Dateiimport. Daten in einzelner Spalte Ausgewählt, um Daten in einer einzelnen Spalte zu speichern. XPath für jede Zeile XPath-Ausdruck, der die Knoten auswählt, die zu Zeilen in der Importtabelle werden. Die untergeordneten Elemente der ausgewählten Knoten werden zu den Spalten in den Zeilen. - Klicken Sie auf Absenden.