Erstellen Sie eine Datenquelle vom Typ REST (IntegrationHub).
Erstellen Sie einen Datenquellendatensatz vom Typ REST (IntegrationHub), um zu definieren, welche Daten ein Importsatz aus einer REST-API importieren soll.
Vorbereitungen
Prozedur
- Navigieren zu Alle > System-Importsätze > Administration > Datenquellen.
- 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 Import Set-Bereitstellungstabelle. Tabellenname für Importsatz Now Platform verwendet die von Ihnen eingegebene Bezeichnung, um einen eindeutigen Tabellennamen zu erstellen. Dadurch wird eine Namespacekollision mit einer bereits vorhandenen Tabelle verhindert. Typ REST (IntegrationHub). Format Eines der folgenden Formate: Benutzerdefiniert (nach Skript analysieren), JSON oder XML. Batch-Import verwenden Wenn diese Option ausgewählt ist, wird angegeben, dass das Laden von Daten in Batches erfolgen soll, wenn Sie auf Datenladen oder Testladen von 20 Datensätzenklicken. Batchgröße Gibt an, wie groß die Batches sein sollen. Wird nur angezeigt, wenn das Feld Batch-Import verwenden ausgewählt ist. Die Eigenschaften glide.import_set_load_usebatch und glide.import_set_load_batch_size wirken sich auf diese Felder aus. Die Prioritäten für die Eigenschaften und Felder lauten wie folgt: Wenn die Eigenschaft festgelegt ist, verwenden Sie den Eigenschaftswert. Wenn nicht, verwenden Sie den Feldwert. Wenn keine der beiden Eigenschaften festgelegt ist, verwenden Sie die Standard-Batch-Größe von 1000.- Beispiel: Wenn glide.import_set_load_usebatch = true und glide.import_set_load_batch_size = 200, verwenden Sie unabhängig von den Feldwerten 200 als Batch-Größe.
- Beispiel: Wenn glide.import_set_load_usebatch = true und die Eigenschaft glide.import_set_load_batch_size nicht festgelegt ist, verwenden Sie die Standard-Batch-Größe von 1000.
- Beispiel: Wenn die Eigenschaft glide.import_set_load_usebatch nicht festgelegt ist und das Feld Batch-Import verwenden = trueist, verwenden Sie den Feldwert Batch-Größe (oder den Standardwert 1000, wenn der Feldwert Batch-Größe nicht festgelegt ist).
- Beispiel: Wenn die Eigenschaft glide.import_set_load_usebatch = false und das Feld Batch-Import verwenden = true ist, verwenden Sie keinen Batch-Import, da die Eigenschaft auf false 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 Datenquellen-Anforderungsaktion in IntegrationHubzu erstellen/konfigurieren. Nachdem die Anforderungsaktion in IntegrationHubveröffentlicht wurde, können Sie sie im Datensatz „Datenquelle“ als Anforderungsaktion auswählen. Weitere Informationen finden Sie unter Definieren Sie Aktionseigenschaften.
Paginierung unterstützen Ausgewählt, um die Paginierung für die Anforderungsaktion zu aktivieren. Durch die Paginierung können Sie den Verarbeitungsaufwand reduzieren, indem Sie eine bestimmte Anzahl von Datensätzen gleichzeitig verarbeiten, 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 einen Grenzwert von 50 ein. Offset Anfänglicher Offset für die Paginierung. Der Offset ist die Startdatensatznummer. Um beispielsweise 50 Datensätze gleichzeitig zu verarbeiten, beginnend mit dem ersten Datensatz, geben Sie ein Limit von 50 und einen Offset von 0 ein. Analyseskript Geben Sie das Skript ein, das zum Analysieren einer einzelnen Eingabezeile verwendet wird. In dieser Funktion sind drei Parameter verfügbar: - Zeile: Die aktuelle Zeile, die vom Skript analysiert werden soll
- lineNumber: Die Zeilennummer der aktuellen Zeile in der gesamten Payload der Antwort
- result: Ausgabeergebnis
Pfad für jede Zeile Der Pfadausdruck, der zum Auswählen von JSON-Objekten verwendet wird, die in der Import Set-Tabelle zu Zeilen werden. Der Pfad für JSON-Objekte muss // sein. 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 bei JSON, dass durch Auswahl dieser Option nur Objekte und keine Arrays erweitert werden. Informationen zur Unterstützung von verschachtelten 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 in der Importtabelle zu Zeilen werden. Die untergeordneten Elemente der ausgewählten Knoten werden zu den Spalten in den Zeilen. - Klicken Sie auf Absenden.