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.
Importe über verwalten IntegrationHub Vereinfacht den Prozess des Imports von Daten aus externen Quellen und der Umwandlung in ServiceNow Tabellen. Sie können Ihre Datenimporte über eine einzige Schnittstelle konfigurieren, ausführen und planen.
Sie können auf zugreifen IntegrationHub– Direkt über importieren App Engine Studio Zum Erstellen von Datenintegrationen für Ihre anwenderdefinierten Anwendungen. Weitere Informationen finden Sie unter Daten werden in App Engine Studio hinzugefügt .
Vorteile
- Konsolidiert mehrere Datenintegrationsfähigkeiten in einer einzigen Umgebung, wodurch die Erstellung und Verwaltung mehrerer Formulare auf der gesamten Plattform entfällt.
- Ermöglicht Ihnen die Verwaltung mehrerer Integrationen über eine einzige Schnittstelle.
- Führt Sie durch die Konfiguration von Datenquellen und Zieltabellen.
- Ermöglicht Ihnen das Zuordnen und Transformieren von Daten über eine einzige vereinfachte Schnittstelle.
- Ermöglicht es Ihnen, Datenimporte zu planen oder Daten bei Bedarf manuell zu importieren.
- Stellt Nutzungsinformationen zur Ausführung von Datenimporten und Details zu importierten Zeilen, Updates und Fehlern bereit.
Übersicht über den Importprozess
Es gibt drei Schritte zum Importieren von Daten.
- 1. Konfigurieren Sie eine Datenquelle.
- Die Datenquelle gibt an, wie und wo die zu importierenden Daten abgerufen werden sollen. In IntegrationHub, Die Datenquelle verwendet 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 transformieren möchten. Nachdem Sie die Zieltabellen ausgewählt haben, können Sie angeben, wie die Quelldaten in sie umgewandelt werden sollen. Durch das Erstellen einer Datenzuordnung wird beschrieben, wie die Daten transformiert werden. Die Daten werden erst umgewandelt, 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 bestimmt haben, können Sie den Import ausführen. Sie können den Import auch so planen, dass er später ausgeführt wird. 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 umgewandelt.
Weitere Informationen zur Funktionsweise des Datenimports finden Sie unter Importsätze .
IntegrationHub Umgebung importieren
Die IntegrationHub Die Importumgebung enthält die folgenden Schnittstellen.
- Zielseite
- Quellenkonfiguration
- Dem Ziel zuordnen
- Importe planen
- Ausführungsdetails
In den folgenden Abschnitten werden die einzelnen Schnittstellen detaillierter erläutert.
Zielseite
Erstellen Sie Integrationen, und greifen Sie über die Zielseite darauf zu.
- 1. Liste der Integrationen
- Integrationen, die über erstellt wurden IntegrationHub Die Importschnittstelle ist hier zugänglich.
- 2. Schaltfläche „neue Integration erstellen“
- Schaltfläche, um mit der Erstellung einer neuen Integration zu beginnen.
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 Datenquelltyps. Es 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 an, die nach Spoke organisiert und alphabetisch aufgelistet sind.
- 2. Datei-Upload oder Abschnitt „Verbindung“ (der 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 überziehen oder durchsuchen, um sie hochzuladen. Akzeptiert XLSX-, XLS-, CSV- und ZIP-Dateien.
Wenn es sich bei der Datenquelle um eine Datenstromaktion handelt, wird hier der Abschnitt „Verbindung“ angezeigt. Für Datenstromaktionen, die einen Verbindungsalias verwenden, können Sie den Standardverbindungsalias mit einem der untergeordneten Aliasse überschreiben. Wählen Sie den Verbindungsalias aus dem Menü aus. Weitere Informationen finden Sie unter Erstellen Sie einen Alias für Verbindungen und Anmeldeinformationen .
- 3. Konfigurationsabschnitt
- Abschnitt zum Konfigurieren der ausgewählten Datenquelle. Die verfügbaren Felder hängen vom Typ der Datenquelle ab, die Sie verwenden.
- Für eine 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 dafür ein. Dieser Abschnitt wird nur angezeigt, wenn die Datenstromaktion Eingaben enthält. Datenstromaktionen mit Eingaben haben eindeutige Eingaben, sodass die hier angezeigten Felder davon abhängen, welche Datenstromaktion ausgewählt ist und welche Konfiguration sie hat. Alle Standardwerte, die bereits von den Spoke-Eingaben konfiguriert wurden, sind vorab ausgefüllt.
- 4. Vorschau der Quelldatenstruktur
- Abschnitt, der die Struktur der Quelldaten anzeigt. Bei einer Excel- oder CSV-Datei werden in der Vorschau die Spaltenüberschriften angezeigt. Bei einer Datenstromaktion wird die Ausgabe des komplexen Objekts angezeigt.
- 5. Eigenschaftenschaltfläche
- 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 ausgewählt werden, wenn die Integration erstellt wird.
- 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 in den Vorschaubereich der 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 bestimmen Sie, wie die Quelldaten ihnen zugeordnet werden. Ordnen Sie Daten zu, indem Sie Datenpillen aus der Quelle in das Ziel ziehen, mithilfe der Pillenauswahl oder auswählen Automatisch Zuordnen . Transformieren Sie die Daten in den Zieltabellen, indem Sie Transformationsfunktionen anwenden.
Der Abschnitt „Zuordnung zu Ziel“ besteht aus zwei Teilen. Wählen Sie im ersten Teil die Zieltabellen aus. Ordnen Sie die Daten im zweiten Teil den Zieltabellen zu.
Der Abschnitt „Tabellenauswahl“ enthält diese Komponenten.
- 1. Fügen Sie eine Tabelle hinzu
- Schaltfläche zum Hinzufügen von Zieltabellen.
- 2. Transformationseinstellungen
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 ein Skript vor oder nach der Integration ausführen. Weitere Informationen finden Sie unter Transformationseinstellungen.
Die Transformationseinstellungen Schaltfläche wird erst angezeigt, wenn Sie mindestens eine Zieltabelle hinzugefügt haben.
- 3. Zieltabellen-Karten
- Jede Karte hat den Namen der Zieltabelle, ihre Erstellungsdetails und gibt an, ob sie zugeordnet wurde. Wählen Sie die Karte aus, um die Datenzuordnungsschnittstelle zu öffnen.
- 4. Dropdown-Liste der Zieltabellen
- Liste der Optionen für die Zieltabelle. Enthält Folgendes.
- Eigenschaften : Öffnet das Fenster „Zuordnungseigenschaften“, in dem Sie die Optionen anzeigen oder bearbeiten können, um die Geschäftsregeln der Tabelle beim Importieren auszuführen und den Import synchron auszuführen.
- Bearbeiten Sie die Zuordnung : Öffnet den Abschnitt „Datenzuordnung“, in dem Sie Ihre Datenzuordnung erstellen oder bearbeiten können.
- Tabellenkonfiguration : Wird Geöffnet Tabellen-Generator Wo Sie die Zieltabelle konfigurieren können. Diese Option ist nur verfügbar, wenn Sie haben Tabellen-Generator Installiert. Weitere Informationen finden Sie unter Table Builder.
- Erneut Validieren : Überprü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. Wenn Sie die Zieltabellenkarte auswählen, wird ein Fenster geöffnet, in dem Sie können Aktualisieren Das Zielentitätsschema oder Abbrechen Um das Schema unverändert zu lassen. Validieren Sie Ihre Tabelle erneut, wenn Sie die Konfiguration der Zieltabelle bearbeiten.
- Löschen : Löscht die Zieltabelle aus der Integration.
Der Abschnitt „Datenzuordnung“ enthält diese Komponenten.
- 1. Name der Zieltabelle
- Name der Zieltabelle, der Sie derzeit zuordnen.
- 2. Abschnitt mit Quelldaten
- Abschnitt, der die Quelldaten als Datenpillen anzeigt. Um die Daten zuzuordnen, 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 ein kleines Häkchensymbol (
) Wird neben dem Quellfeldnamen angezeigt. Wenn Sie den Cursor auf das Häkchen bewegen, listet der Tooltip die Zielfelder auf, denen das Quellfeld zugeordnet wurde, bis zu fünf Felder. - 3. Abschnitt mit Zieltabellendaten
- Abschnitt, in dem angezeigt wird, 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 auswählen Fügen Sie ein Feld hinzu Schaltfläche. Für Auswahl- und Referenzfelder können Sie angeben, welcher Spalte Daten zugeordnet werden sollen, oder Sie können die Standardanzeigespalte verwenden.
- 4. Umschalter für Übereinstimmung
- Umschalter, um Felder anzugeben, in denen das System nach übereinstimmenden Daten suchen und vorhandene Datensätze aktualisieren soll, anstatt neue zu erstellen. In diesem Bild die Übereinstimmung Der Umschalter ist für aktiviert Anwender-ID Feld. Wenn ein Datensatz in den Quelldaten eine Anwender-ID hat, die der Anwender-ID für einen Datensatz in der Zieltabelle entspricht, aktualisiert das System den vorhandenen Datensatz in der Zieltabelle, anstatt einen neuen zu erstellen.
- 5. Schaltfläche „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 „Automatische Zuordnung“
- 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. Symbol für Transformationsfunktion
- Schaltfläche zum Öffnen der Liste der verfügbaren Transformationsfunktionen. Verwenden Sie Transformationsfunktionen, um Ihre Daten zu ändern oder zu ändern. Beispielsweise entfernt die Transformationsfunktion „Beschneiden“ 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 Abständen oder nach einem übergeordneten Import ausgeführt wird. Planen Sie große Importe so, dass sie gleichzeitig ausgeführt werden, um die Verarbeitungszeit zu reduzieren.
Der Abschnitt „Importe planen“ enthält diese Komponenten.
- 1. Geplante Importe
- Liste der Importzeitpläne. Jeder Importzeitplan wird in einer eigenen Schaltfläche angezeigt.
- 2. Schaltfläche „Import planen“
- Schaltfläche zum Erstellen eines Importzeitplans.
- 3. Abschnitt „Ausführungen“
- Abschnitt mit Informationen zu ausgeführten Importen. Enthält Links zu Ausführungsdatensätzen, Ausführungskontextdatensätzen und geplanten Importdatensätzen. Dieser Abschnitt wird erst 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. Geplante Importdatensätze
- 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 und Ausführungskontext. Öffnen Sie die Ausführungsdatensätze des Imports, um den Importstatus und die importierten Zeilen, Fehler und Protokolle anzuzeigen.
Der Abschnitt „Ausführungsdetails“ enthält diese 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 Datums der Aktualisierung.
- 2. Ausführungsdetails
Abschnitt mit Karten, der die Gesamtzahl der importierten, verarbeiteten, ausstehenden oder übersprungenen Zeilen und die Anzahl der aufgetretenen Fehler anzeigt. Wenn der Import gleichzeitig verarbeitet wird, enthält dieser Abschnitt auch eine Partitionskarte. 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. Klicken Sie beispielsweise auf Ausstehend Karte zeigt die ausstehenden Zeilen an. Klicken Sie Auf Gesamtzahl der importierten Zeilen Oder Löschen Sie Die Auswahl Löscht die Filter.Hinweis: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 deren Details anzuzeigen. Sie können auch die Karten „Ausführungsdetails“ für zusätzliche Filterung verwenden. Wenn Sie den Partitionsfilter mit den Kartenfiltern kombinieren, verwendet das System einen UND-Vorgang 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 und des Typs und Status für jeden Importsatzauftrag. Die Listenansicht „Partitionen“ wird nur für gleichzeitige Importsätze angezeigt. Die Listenansicht „Partitionen“ bietet die gleichen Filterfunktionen wie die Karte „Partitionen“, sodass Sie entweder zum Filtern einer Partition verwenden können.
- 5. Importdetails
- Abschnitt mit Details zu den Importsatzzeilen, ausgehenden HTTP-Anforderungen, Aktionsausführungsverlauf, Importprotokollen und Fehlern für jeden Ausführungsdatensatz.
IntegrationHub Begriffe importieren
- Datenquelle
- A Datenquelle Ist ein Konfigurationsdatensatz, der den Typ der zu importierenden Daten und den Endpunkt definiert, an den Ihre Instanz sie abrufen kann.
- Datenstromaktion
- A Datenstromaktion Ist eine Aktion, die REST-, SOAP- oder JDBC-Anforderungen von sendet Workflow-Studio An APIs und gibt einen Stream von Antwortdaten zurück. Verwenden Sie Datenstromaktionen, um Daten mit mehr als 10 MB abzurufen, oder wenn Sie mit APIs arbeiten, die paginierte Ergebnisse zurückgeben.
- Zieltabelle
- A Zieltabelle Ist die Tabelle, in die Ihre Quelldaten umgewandelt werden sollen.
- Funktion umwandeln
- A Transformationsfunktion Ist eine Funktion, die Ihre Daten ändert oder ändert. Zum Beispiel eine Funktion, die eine Eingabezeichenfolge in alle Großbuchstaben umwandelt.
- Ausführung
- Ein Ausführung Ist ein Laufzeitdatensatz, der die Ausführungsdetails für einen einzelnen Import enthält. Jede Ausführung stellt Importdetails für ein bestimmtes Ziel bereit, 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 von angebotenen Vorteile zu erzielen IntegrationHub Importe.
- Alle erstellen IntegrationHub Importe aus innerhalb IntegrationHub
- Nur Integrationen, die in erstellt wurden IntegrationHub Importumgebung ist dort zugänglich. Beispielsweise können Sie eine Datenquelle und eine Zuordnung nicht über Plattformformulare konfigurieren, aber dann den Import von innerhalb planen IntegrationHub. Nur Integrationen, die in erstellt wurden IntegrationHub Wird auf der Zielseite angezeigt.
- Ändern Sie Konfigurationsdatensätze außerhalb von nicht IntegrationHub
- Das direkte Ändern von Konfigurationsdatensätzen kann sich ändern, ob und wie Daten importiert und zugeordnet werden. Wenn Sie die Konfiguration der Datenquelle, die Zuordnung oder den Importzeitplan ändern müssen, tun Sie dies innerhalb von IntegrationHub Importschnittstelle.
- Vermeiden Sie das Ändern von Datenstromaktionen, die in Datenquellen verwendet werden
- Das Ändern von Datenstromaktionen, die als Datenquellen verwendet werden, kann die Zuordnung von Quelle zu Ziel ändern. Wenn sich die Ausgabe für eine Datenstromaktion ändert, wird auf der Seite „Zielzuordnung“ eine Warnung angezeigt, dass sich das komplexe Objektschema geändert hat. Möglicherweise müssen Sie die Zuordnung neu konfigurieren.