IntegrationHub Import
Automatisieren Sie Datenimportaufgaben über eine konsolidierte Schnittstelle, die eine geführte Schritt-für-Schritt-Experience bietet. Definieren Sie externe Datenquellen, geben Sie Zieltabellen an, ordnen Sie zu, wie Quelldaten zu Zieldaten werden, und planen Sie regelmäßige Importe.
Die Verwaltung von Importen über IntegrationHub vereinfacht den Prozess des Imports von Daten aus externen Quellen und deren Umwandlung in ServiceNow -Tabellen. Sie können Ihre Datenimporte über eine einzige Schnittstelle konfigurieren, ausführen und planen.
Sie können direkt über IntegrationHub auf App Engine Studio - Import zugreifen, um Datenintegrationen für Ihre anwenderdefinierten Anwendungen zu erstellen. Weitere Informationen hierzu finden Sie unter Daten in App Engine Studio hinzufügen.
Vorteile
- Fasst mehrere Datenintegrationsfunktionen in einer einzigen Umgebung zusammen, sodass nicht mehrere Formulare auf der gesamten Plattform erstellt und verwaltet werden müssen.
- Ermöglicht Ihnen die Verwaltung mehrerer Integrationen über eine einzige Schnittstelle.
- Führt Sie durch die Konfiguration von Datenquellen und Zieltabellen.
- Ermöglicht das Zuordnen und Transformieren von Daten über eine einzige vereinfachte Schnittstelle.
- Ermöglicht Ihnen, Datenimporte zu planen oder Daten manuell bei Bedarf zu importieren.
- Stellt Nutzungsinformationen zu ausgeführten Datenimporten und Details zu importierten Zeilen, Aktualisierungen und Fehlern bereit.
Übersicht über den Importvorgang
Das Importieren von Daten erfolgt in drei Schritten.
- 1. Konfigurieren Sie eine Datenquelle.
- Die Datenquelle gibt an, wie und wo die zu importierenden Daten abgerufen werden. In IntegrationHubverwendet die Datenquelle eine Excel-Datei, eine CSV-Datei oder eine Datenstromaktion, um Daten aus einer externen Quelle abzurufen. Eine Datenstromaktion sendet eine REST-, SOAP- oder JDBC-Anforderung an eine API und gibt einen Datenstrom zurück.
- 2. Ordnen Sie die Daten den Zieltabellen zu.
- Die Zieltabellen sind die Tabellen, in die Sie die Daten umwandeln möchten. Nachdem Sie die Zieltabellen ausgewählt haben, können Sie angeben, wie die Quelldaten in sie umgewandelt werden sollen. Das Erstellen einer Datenzuordnung beschreibt, wie die Daten transformiert werden. Die Daten werden erst transformiert, wenn Sie den Import ausführen.
- 3. Führen Sie den Import aus, oder planen Sie ihn.
- Nachdem Sie die Datenquelle konfiguriert und die Datenzuordnung festgelegt haben, können Sie den Import ausführen. Sie können den Import auch für eine spätere Ausführung planen. Wenn der Import ausgeführt wird, werden Daten aus der Quelle gesammelt, in eine Bereitstellungstabelle verschoben und gemäß den Spezifikationen in Ihrer Zuordnung in die Zieltabellen transformiert.
Weitere Informationen zur Funktionsweise des Datenimports finden Sie unter Importsätze.
IntegrationHub Importumgebung
Die Importumgebung IntegrationHub enthält die folgenden Schnittstellen.
- Zielseite
- Quellenkonfiguration
- Dem Ziel zuordnen
- Importe planen
- Ausführungsdetails
In den folgenden Abschnitten werden die einzelnen Schnittstellen ausführlicher erläutert.
Zielseite
Erstellen Sie Integrationen und greifen Sie über die -Zielseite auf Integrationen zu.
- 1. Liste der Integrationen
- Hier können Sie auf Integrationen zugreifen, die über die Importschnittstelle IntegrationHub erstellt wurden.
- 2. Schaltfläche „Neue Integration erstellen“.
- Schaltfläche zum Starten der Erstellung einer neuen Integration.
Quellenkonfiguration
Definieren Sie eine Datenquelle für einen Import über die Quellkonfigurationsseite. Die Datenquelle muss eine Excel-Datei, eine CSV-Datei oder eine Datenstromaktion sein.
- 1. Quelltypauswahl
- Menü zum Auswählen des Datenquellentyps. Sie enthält die folgenden Abschnitte.
- AD-HOC: Wählen Sie eine Excel- oder CSV-Datei als Datenquelle aus.
- SPOKES: Wählen Sie eine Datenstromaktion als Datenquelle aus. Zeigt aktive -Datenströme nach Spoke geordnet und alphabetisch sortiert an.
- 2. Datei-Upload oder Abschnitt „Verbindung“ (Abschnitt „Verbindung“ wird nicht angezeigt)
Wenn die Datenquelle eine Excel- oder CSV-Datei ist, wird hier der Abschnitt „Datei hochladen“ angezeigt. Sie können eine Datei über ziehen oder navigieren, um sie hochzuladen. Akzeptiert XLSX-, XLS-, CSV- und ZIP-Dateien.
Wenn die Datenquelle eine Datenstromaktion ist, wird hier der Abschnitt „Verbindung“ angezeigt. Bei Datenstromaktionen, die einen Verbindungsalias verwenden, können Sie den Standardverbindungsalias mit jedem der Aliasse der untergeordneten Elemente überschreiben. Wählen Sie den Verbindungsalias aus dem Menü aus. Weitere Informationen hierzu finden Sie unter Alias für Verbindungen und Anmeldeinformationen erstellen.
- 3. Konfigurationsabschnitt
- Abschnitt zum Konfigurieren der ausgewählten Datenquelle. Die verfügbaren Felder hängen vom Typ der Datenquelle ab, die Sie verwenden.
- Bei einer Excel-Datei können Sie das Blatt auswählen und angeben, welche Zeilennummer für den Header verwendet werden soll.
- Wählen Sie für eine CSV-Datei das Trennzeichen aus.
- Geben Sie für eine Datenstromaktion hier die Eingaben ein. Dieser Abschnitt wird nur angezeigt, wenn die Datenstromaktion Eingaben enthält. Datenstromaktionen mit Eingaben haben eindeutige Eingaben, daher hängen die hier angezeigten Felder davon ab, welche Datenstromaktion ausgewählt ist und welche Konfiguration sie hat. Alle bereits von den Spoke-Eingaben konfigurierten Standardwerte werden vorab ausgefüllt.
- 4. Vorschau der Quelldatenstruktur
- Abschnitt, der die Struktur der Quelldaten zeigt. Für eine Excel- oder CSV-Datei zeigt die Vorschau die Spalten-Header an. Bei einer Datenstromaktion wird die komplexe Objektausgabe angezeigt.
- 5. Schaltfläche „Eigenschaften“.
- Schaltfläche zum Anzeigen des Namens der Integration, ihrer Beschreibung und des Anwendungsbereichs. Sie können den Namen und die Beschreibung jederzeit bearbeiten. Der Anwendungsbereich kann nicht bearbeitet werden und muss beim Erstellen der Integration ausgewählt werden.
- 6. Schaltfläche „Speichern“.
- Schaltfläche zum Speichern der Quellkonfiguration. Diese Schaltfläche ist nur aktiviert, wenn die Quellkonfiguration aktualisiert wird. Wenn Sie einen Quelltyp auswählen, wird die Struktur der Quelldaten automatisch im Vorschaufenster Quelldatenstruktur geladen. Wenn Sie die Quellkonfiguration bearbeiten, klicken Sie auf Speichern, um die Quelldaten neu zu laden. Die Daten müssen mindestens einmal in der Vorschau angezeigt werden, bevor Sie sie einer Zieltabelle zuordnen können.
Dem Ziel zuordnen
Wählen Sie die Zieltabellen aus, und legen Sie fest, wie ihnen die Quelldaten zugeordnet werden. Ordnen Sie Daten zu, indem Sie Datenpillen aus der Quelle auf das Ziel ziehen, die Pillenauswahl verwenden oder Automatische Zuordnungauswählen. Transformieren Sie die Daten in den Zieltabellen, indem Sie Transformationsfunktionen anwenden.
Der Abschnitt Dem Ziel zuordnen besteht aus zwei Teilen. Wählen Sie im ersten Teil die Zieltabellen aus. Im zweiten Teil ordnen Sie die Daten den Zieltabellen zu.
Der Tabellenauswahlabschnitt enthält die folgenden Komponenten.
- 1. Fügen Sie eine Tabelle hinzu
- Schaltfläche zum Hinzufügen von Zieltabellen.
- 2. Transformieren Sie die Einstellungen
Schaltfläche zum Konfigurieren der Transformationseinstellungen für Ihre Integration. Sie können die Batchgröße und die Verarbeitung leerer Felder angeben, den ausführlichen Modus aktivieren oder vor oder nach der Integration ein Skript ausführen. Weitere Informationen finden Sie unter Einstellungen umwandeln.
Die Schaltfläche „Transformationseinstellungen“ wird erst angezeigt, wenn Sie mindestens eine Zieltabelle hinzugefügt haben.
- 3. Zieltabellenkarten
- Jede Karte enthält den Namen der Zieltabelle, ihre Erstellungsdetails und ob sie zugeordnet wurde. Wählen Sie die Karte aus, um die Datenzuordnungsschnittstelle zu öffnen.
- 4. Dropdown-Liste der Zieltabelle
- Liste der Optionen für die Zieltabelle. Enthält Folgendes.
- Eigenschaften: Öffnet das Fenster „Zuordnungseigenschaften“, in dem Sie die Optionen zum Ausführen der Business-Regeln der Tabelle beim Import und zum synchronen Ausführen des Imports anzeigen oder bearbeiten können.
- Zuordnung bearbeiten: Öffnet den Abschnitt für Datenzuordnungen, in dem Sie Ihre Datenzuordnung erstellen oder bearbeiten können.
- Tabellenkonfiguration: Öffnet Tabellen-Generator, wo Sie die Zieltabelle konfigurieren können. Diese Option ist nur verfügbar, wenn Tabellen-Generator installiert ist. Weitere Informationen finden Sie unter Table Builder.
- Erneut validieren: Prüft, ob Änderungen am Schema der Zielentität vorhanden sind. Wenn Änderungen erkannt werden, zeigt die Zieltabellenkarte eine Meldung an, dass sich das Zielschema geändert hat. Durch Auswahl der Zieltabellenkarte wird ein Fenster geöffnet, in dem Sie das Schema der Zielentität aktualisieren oder Abbrechen können, um das Schema beizubehalten. Validieren Sie Ihre Tabelle erneut, wenn Sie die Konfiguration der Zieltabelle bearbeiten.
- Löschen: Löscht die Zieltabelle aus der Integration.
Der Datenzuordnungsabschnitt enthält die folgenden Komponenten.
- 1. Name der Zieltabelle
- Name der Zieltabelle, die derzeit zugeordnet wird.
- 2. Quelldatenabschnitt
- Abschnitt, in dem die Quelldaten als Datenpillen angezeigt werden. Zum Zuordnen der Daten ziehen Sie die Datenpillen in den Datenabschnitt der Zieltabelle. Sie können auch die Pillenauswahl verwenden. Nachdem Sie ein Quellfeld einem Zielfeld zugeordnet haben, wird neben dem Quellfeldnamen ein kleines Häkchensymbol (
) angezeigt. Wenn Sie den Cursor auf das Häkchen bewegen, listet der Tooltip die Zielfelder auf, denen das Quellfeld zugeordnet wurde, und zwar bis zu fünf Felder. - 3. Abschnitt mit Zieltabellendaten
- Abschnitt, der anzeigt, wie die Quelldaten jedem Feld in der ausgewählten Zieltabelle zugeordnet werden. Sie können alle Felder in der Zieltabelle anzeigen oder einzelne Felder mit der Schaltfläche Ein Feld hinzufügen auswählen. Für Auswahl- und Referenzfelder können Sie angeben, welcher Spalte Daten zugeordnet werden sollen, oder Sie können die Standardanzeigespalte verwenden.
- 4. Wechseln Sie mit dem Umschalter
- Schalten Sie den Schalter um, um Felder anzugeben, in denen das System nach übereinstimmenden Daten suchen und, falls gefunden, vorhandene Datensätze aktualisieren soll, anstatt neue zu erstellen. In dieser Abbildung ist der Umschalter „Übereinstimmen“ für das Feld „Benutzer-ID“ aktiviert. Wenn ein Datensatz in den Quelldaten eine Anwender-ID hat, die mit der Anwender-ID für einen Datensatz in der Zieltabelle übereinstimmt, aktualisiert das System den vorhandenen Datensatz in der Zieltabelle, anstatt einen neuen zu erstellen.
- 5. Schaltfläche für Zuordnungseigenschaften
- Schaltfläche zum Anzeigen oder Bearbeiten der Optionen zum Ausführen der Business-Regeln der Tabelle beim Importieren und zum synchronen Ausführen des Imports.
- 6. Schaltfläche „Automatisch zuordnen“.
- Schaltfläche zum automatischen Zuordnen von Quellentitäten zu ähnlich benannten Zielentitäten.
- 7. Datenpillenauswahl
- Schaltfläche zum Öffnen der Datenpillenauswahl. Sie können die Pillenauswahl verwenden, um Quelldatenpillen Feldwerten in der Zieltabelle zuzuordnen.
- 8. Transformationsfunktionssymbol
- Schaltfläche zum Öffnen der Liste der verfügbaren Transformationsfunktionen. Verwenden Sie Transformationsfunktionen, um Ihre Daten zu ändern. Beispielsweise entfernt die Transformationsfunktion Kürzen Leerzeichen am Anfang und Ende einer Eingabezeichenfolge.
Importe planen
Führen Sie einen Import sofort aus, oder planen Sie ihn so, dass er zu einem bestimmten Zeitpunkt, in regelmäßigen Intervallen oder nach einem übergeordneten Import ausgeführt wird. Planen Sie große Importe so, dass sie gleichzeitig ausgeführt werden, um die Verarbeitungszeit zu verkürzen.
Der Abschnitt „Zeitplanimporte“ enthält die folgenden Komponenten.
- 1. Geplante Importe
- Liste der Importzeitpläne. Jeder Importzeitplan wird auf einer eigenen Schaltfläche angezeigt.
- 2. Planen Sie eine Importschaltfläche
- Schaltfläche zum Erstellen eines Importzeitplans.
- 3. Abschnitt „Ausführungsstatus“.
- Abschnitt mit Informationen zu ausgeführten Importen. Enthält Links zu Ausführungsdatensätzen, Ausführungskontextdatensätzen und Datensätzen für geplante Importe. Dieser Abschnitt wird nur angezeigt, nachdem ein Import ausgeführt wurde.
- 4. Ausführungsdatensätze
- Liste der Ausführungsdatensätze. Jeder Ausführungsdatensatz enthält Informationen zu einer Ausführung, einschließlich der importierten Zeilen, Fehler und Protokollnachrichten.
- 5. Ausführungskontextdatensätze
- Liste der Ausführungskontextdatensätze. Jeder Ausführungskontextdatensatz gibt den nächsten geplanten Import an, der bei der Verarbeitung eines hierarchischen geplanten Imports verwendet werden soll.
- 6. Datensätze für geplante Importe
- Liste der geplanten Importdatensätze. Jeder Datensatz enthält den Namen, die Datenquelle, den Zeitplan und die Partitionsmethode für den geplanten Import.
- 7. Schaltfläche Import ausführen
- Schaltfläche zum einmaligen Ausführen des Imports.
Ausführungsdetails
Zeigen Sie Details für jeden Import an, z. B. Ausführungszeit und -datum sowie den Ausführungskontext. Öffnen Sie die Ausführungsdatensätze des Imports, um den Importstatus sowie die importierten Zeilen, Fehler und Protokolle anzuzeigen.
Der Abschnitt „Ausführungsdetails“ enthält die folgenden Komponenten.
- 1. Ausführungsinformationen
- Abschnitt mit Details zur Ausführung, einschließlich der Nummer des Ausführungsdatensatzes, des Namens des geplanten Imports, der Importsatznummer und des Aktualisierungsdatums.
- 2. Ausführungsdetails
Abschnitt mit Karten, die die Gesamtzahl der importierten, verarbeiteten, ausstehenden oder übersprungenen Zeilen und die Anzahl der aufgetretenen Fehler anzeigen. Wenn der Import gleichzeitig verarbeitet wird, enthält dieser Abschnitt auch eine Karte „Partitionen“. Weitere Informationen finden Sie unter Gleichzeitige Importe.
Sie können auf die Karten klicken, um die Ergebnisse zu filtern. Gefilterte Ergebnisse werden auf der Registerkarte Importsatzzeilen unten auf der Seite angezeigt. Wenn Sie beispielsweise auf die Karte Ausstehend klicken, werden die ausstehenden Zeilen angezeigt. Durch Klicken auf „Insgesamt importierte Zeilen“ oder „Auswahl löschen“ werden die Filter gelöscht.Hinweis:Die Kartenfilterung ist nur für Importsatzzeilen verfügbar. Um die gefilterte Liste anzuzeigen, stellen Sie sicher, dass Sie sich auf der Registerkarte Importsatzzeilen befinden.- 3. Partitionskarte
- Grafische Ansicht der Importsatzpartitionen. Die Partitionskarte wird nur für gleichzeitige Importsätze angezeigt. Sie können auf eine Partition klicken, um ihre Details anzuzeigen. Sie können auch die Karten mit den Ausführungsdetails für zusätzliche Filter verwenden. Wenn Sie den Partitionsfilter mit den Kartenfiltern kombinieren, verwendet das System eine UND-Operation zum Filtern. Wenn Sie beispielsweise auf eine Partition klicken und dann auf die Karte Fehler klicken, werden auf der Registerkarte Importsatzzeilen nur die Fehler für diese Partition angezeigt.
- 4. Partitionslistenansicht
- Option zum Anzeigen der Details für jede Partition, einschließlich der Importsatznummer sowie des Typs und Status für jeden Importsatzauftrag. Die Partitionslistenansicht wird nur für gleichzeitige Importsätze angezeigt. Die Partitionslistenansicht bietet dieselben Filterfunktionen wie die Karte Partitionen, sodass Sie eine Partition mit beiden Filtern filtern können.
- 5. Importieren Sie die Details
- Abschnitt, in dem die Importsatzzeilen, ausgehenden HTTP-Anforderungen, der Verlauf der Aktionsausführung, die Importprotokolle und die Fehler für jeden Ausführungsdatensatz beschrieben werden.
IntegrationHub Importbegriffe
- Datenquelle
- Eine Datenquelle ist ein Konfigurationsdatensatz, der den Typ der zu importierenden Daten und den Endpunkt definiert, an dem Ihre Instanz sie abrufen kann.
- Datenstromaktion
- Eine Datenstromaktion ist eine Aktion, die REST-, SOAP- oder JDBC-Anforderungen von Workflow-Studio an APIs sendet und einen Stream von Antwortdaten zurückgibt. Verwenden Sie Datenstromaktionen, um Daten abzurufen, die größer als 10 MB sind, oder wenn Sie mit APIs arbeiten, die paginierte Ergebnisse zurückgeben.
- Zieltabelle
- Eine Zieltabelle ist die Tabelle, in die Ihre Quelldaten transformiert werden sollen.
- Funktion umwandeln
- Eine Transformationsfunktion ist eine Funktion, die Ihre Daten ändert oder modifiziert. Zum Beispiel eine Funktion, die eine Eingabezeichenfolge in Großbuchstaben umwandelt.
- Ausführung
- Eine Ausführung ist ein Laufzeitdatensatz, der die Ausführungsdetails für einen einzelnen Import enthält. Jede Ausführung von bietet Importdetails für ein bestimmtes Ziel, einschließlich importierter Zeilen, Protokollnachrichten und Fehler.
- Ausführungskontext
- Ein Ausführungskontext ist ein Datensatz, der den nächsten geplanten Import angibt, der bei der Verarbeitung eines hierarchischen geplanten Imports verwendet werden soll.
- Importsatz
- Ein Importsatz ist ein Satz von Laufzeitdatensätzen, die die aus einer Datenquelle importierten Rohdaten enthalten. Das System speichert importierte Datensätze in einer Importsatz-Bereitstellungstabelle.
Design Überlegungen
Befolgen Sie diese Richtlinien, um die Vorteile von IntegrationHub -Importen zu nutzen.
- Alle IntegrationHub -Importe aus in IntegrationHuberstellen
- Nur Integrationen, die in der Importumgebung IntegrationHub erstellt wurden, sind dort zugänglich. Sie können beispielsweise eine Datenquelle und die Zuordnung nicht über Plattformformulare konfigurieren, sondern den Import dann aus IntegrationHubplanen. Auf der Zielseite werden nur Integrationen angezeigt, die in IntegrationHub erstellt wurden.
- Ändern Sie keine Konfigurationsdatensätze außerhalb von IntegrationHub
- Durch eine direkte Änderung von Konfigurationsdatensätzen ändert sich möglicherweise, ob und wie Daten importiert und zugeordnet werden. Wenn Sie die Konfiguration der Datenquelle, der Zuordnung oder des Importzeitplans ändern müssen, tun Sie dies über die Importschnittstelle IntegrationHub.
- Vermeiden Sie das Ändern von Datenstromaktionen, die in Datenquellen verwendet werden
- Durch das Ändern von Datenstromaktionen, die als Datenquellen verwendet werden, kann die Zuordnung von Quelle zu Ziel geändert werden. Wenn sich die Ausgabe für eine Datenstromaktion ändert, wird auf der Seite „Zu Ziel zuordnen“ eine Warnung angezeigt, dass das komplexe Objektschema geändert wurde. Möglicherweise müssen Sie die Zuordnung neu konfigurieren.