IntegrationHub -Import

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 11 Minuten Lesedauer
  • Automatisieren Sie Datenimportaufgaben über eine konsolidierte Schnittstelle, die eine 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, Daten aus externen Quellen zu importieren und in ServiceNow -Tabellen zu transformieren. Sie können Ihre Datenimporte über eine einzige Schnittstelle konfigurieren, ausführen und planen.

    Sie können direkt über App Engine Studio auf IntegrationHub - Import zugreifen, um Datenintegrationen für Ihre benutzerdefinierten Anwendungen zu erstellen. Weitere Informationen finden Sie unter Daten in App Engine Studio hinzufügen.

    Vorteile

    Die Verwaltung Ihrer Importe über IntegrationHub bietet diese Vorteile.
    • Konsolidiert mehrere Datenintegrationsfunktionen in einer einzigen Umgebung, sodass nicht mehr mehrere Formulare in der gesamten Plattform erstellt und verwaltet werden müssen.
    • Ermöglicht 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 bei Bedarf manuell zu importieren.
    • Stellt Nutzungsinformationen zu ausgeführten Datenimporten und Details zu importierten Zeilen, Aktualisierungen und Fehlern bereit.

    Übersicht über den Importvorgang

    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 IntegrationHubverwendet die Datenquelle eine Excel-Datei, eine CSV-Datei oder eine Datenstrom-Aktion, um Daten aus einer externen Quelle abzurufen. Eine Datenstrom-Aktion 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. Beim Erstellen einer Datenzuordnung wird beschrieben, 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 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 -Importumgebung

    Die IntegrationHub Importumgebung enthält die folgenden Schnittstellen.

    • Zielseite
    • Quellkonfiguration
    • Zuordnen zu Ziel
    • Importe planen
    • Ausführungsdetails

    In den folgenden Abschnitten werden die einzelnen Schnittstellen ausführlicher erläutert.

    Zielseite

    Erstellen und greifen Sie über die -Zielseite auf Integrationen zu.

    Abbildung : 1. Benutzeroberfläche der Zielseite
    Benutzeroberfläche für die Zielseite des IntegrationHub-Imports.
    Die Zielseite enthält die folgenden Komponenten.
    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, um mit dem Erstellen einer neuen Integration zu beginnen.

    Quellkonfiguration

    Definieren Sie eine Datenquelle für einen Import über die Quellkonfigurationsseite. Die Datenquelle muss eine Excel-Datei, eine CSV-Datei oder eine Datenstrom-Aktion sein.

    Abbildung : 2. Benutzeroberfläche des Quellkonfigurationsabschnitts
    Benutzeroberfläche für den Konfigurationsabschnitt der IntegrationHub-Importquelle.
    Der Quellkonfigurationsabschnitt enthält die folgenden Komponenten.
    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 Datenstrom-Aktion als Datenquelle aus. Zeigt aktive Datenströme an, die nach Spoke geordnet und alphabetisch aufgelistet sind.
    2. Datei-Upload oder Verbindungsabschnitt (der Verbindungsabschnitt wird nicht angezeigt)

    Wenn die Datenquelle eine Excel- oder CSV-Datei ist, wird hier der Abschnitt „Datei hochladen“ angezeigt. Sie können eine Datei nach ziehen oder durchsuchen, um sie hochzuladen. Akzeptiert XLSX-, XLS-, CSV- und ZIP-Dateien.

    Wenn die Datenquelle eine Datenstromaktion ist, wird hier der Abschnitt Verbindung angezeigt. Für Datenstrom-Aktionen, die einen Verbindungsalias verwenden, können Sie den Standardverbindungsalias mit einem der Aliasse der untergeordneten Elemente überschreiben. Wählen Sie den Verbindungsalias aus dem Menü aus. Weitere Informationen finden Sie unter Aliasse 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 Datenstrom-Aktion über Eingaben verfügt. Datenstrom-Aktionen mit Eingaben haben eindeutige Eingaben, daher hängen die hier angezeigten Felder von der ausgewählten Datenstrom-Aktion und ihrer Konfiguration ab. Alle bereits von den Spoke-Eingaben konfigurierten Standardwerte sind vorausgefüllt.
    4. Vorschau der Quelldatenstruktur
    Abschnitt, der die Struktur der Quelldaten zeigt. Für eine Excel- oder CSV-Datei zeigt die Vorschau die Spaltenkopfzeilen an. Für eine Datenstrom-Aktion 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 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.

    Zuordnen zu Ziel

    Wählen Sie die Zieltabellen aus, und legen Sie fest, wie die Quelldaten ihnen zugeordnet werden. Ordnen Sie Daten zu, indem Sie Datenpillen aus der Quelle zum Ziel ziehen, die Pillenauswahlverwenden oder Automatische Zuordnung wählen. Transformieren Sie die Daten in den Zieltabellen, indem Sie Transformationsfunktionen anwenden.

    Der Abschnitt Map to target (Zu Ziel zuordnen) besteht aus zwei Teilen. Wählen Sie im ersten Teil die Zieltabellen aus. Ordnen Sie im zweiten Teil die Daten den Zieltabellen zu.

    Abbildung : 3. Benutzeroberfläche für Tabellenauswahl
    Benutzeroberfläche für den IntegrationHub-Tabellenauswahlabschnitt.

    Der Tabellenauswahlabschnitt enthält die folgenden Komponenten.

    1. Fügen Sie eine Tabelle hinzu
    Schaltfläche zum Hinzufügen von Zieltabellen.
    2. Einstellungen umwandeln

    Schaltfläche zum Konfigurieren der Transformationseinstellungen für Ihre Integration. Sie können die Batch-Größe und die Behandlung 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 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 die Angabe, 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 anzeigen oder bearbeiten können, um die Business Rules der Tabelle beim Import auszuführen und den Import synchron auszuführen.
    • Zuordnung bearbeiten: Öffnet den Abschnitt „Datenzuordnung“, in dem Sie Ihre Datenzuordnung erstellen oder bearbeiten können.
    • Tabellenkonfiguration: Öffnet Tabellen-Generator, in dem 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: Überprüft, ob Änderungen amZielentitätsschemavorhanden 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 das Zielentitätsschema aktualisieren oder Abbrechen auswählen 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.
    Abbildung : 4. Benutzeroberfläche für Datenzuordnung
    Benutzeroberfläche für den IntegrationHub-Abschnitt „Importdatenzuordnung“.

    Der Datenzuordnungsabschnitt enthält die folgenden Komponenten.

    1. Name der Zieltabelle
    Name der Zieltabelle, die Sie derzeit zuordnen.
    2. Quelldatenabschnitt
    Abschnitt, in dem die Quelldaten als Datenpillen angezeigt werden. 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 neben dem Quellfeldnamen ein kleines Häkchensymbol ( Häkchensymbol) angezeigt. Wenn Sie den Cursor auf das Häkchen bewegen, werden im Tooltip die Zielfelder aufgelistet, denen das Quellfeld zugeordnet wurde, und zwar bis zu fünf Felder.
    3. Datenabschnitt der Zieltabelle
    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. Passen Sie den Umschalter an
    Umschalter, um Felder anzugeben, in denen das System nach übereinstimmenden Daten suchen und, falls vorhanden, vorhandene Datensätze aktualisieren soll, anstatt neue zu erstellen. In dieser Abbildung ist der Umschalter Abgleich für das Feld „Benutzer-ID“ aktiviert. Wenn ein Datensatz in den Quelldaten eine Benutzer-ID hat, die der Benutzer-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 Rules der Tabelle beim Import 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. Symbol für Transformationsfunktion
    Schaltfläche zum Öffnen der Liste der verfügbaren Transformationsfunktionen. Verwenden Sie Transformationsfunktionen, um Ihre Daten zu ändern oder zu modifizieren. Beispielsweise entfernt die Transformationsfunktion Trim Leerzeichen am Anfang und Ende einer Eingabezeichenfolge.

    Importe planen

    Führen Sie einen Import sofort aus, oder planen Sie die Ausführung zu einem bestimmten Zeitpunkt, in regelmäßigen Abständen oder nach einem übergeordneten Import. Planen Sie große Importe so, dass sie gleichzeitig ausgeführt werden, um die Verarbeitungszeit zu reduzieren.

    Abbildung : 5. Benutzeroberfläche des Abschnitts „Zeitplanimporte“.
    Benutzeroberfläche für den Abschnitt „IntegrationHub-Importzeitplanimporte“.

    Der Abschnitt „Zeitplanimporte“ enthält die folgenden 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 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. 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, um den Import einmal auszuführen.

    Ausführungsdetails

    Zeigen Sie Details für jeden Import an, z. B. Ausführungszeit und -datum sowie Ausführungskontext. Öffnen Sie die Ausführungsdatensätze des Imports, um den Importstatus und die importierten Zeilen, Fehler und Protokolle anzuzeigen.

    Abbildung : 6. Benutzeroberfläche des Abschnitts „Ausführungsdetails“.
    Benutzeroberfläche für den IntegrationHub-Abschnitt „Importausführungsdetails“.

    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 Import Set-Nummer 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 „Import Set-Zeilen“ unten auf der Seite angezeigt. Wenn Sie beispielsweise auf die Karte Ausstehend klicken, werden die ausstehenden Zeilen angezeigt. Durch Klicken auf Gesamtzahl der importierten Zeilen oder Auswahl aufheben werden die Filter gelöscht.
    Hinweis:
    Die Kartenfilterung ist nur für Import Set-Zeilen verfügbar. Um die gefilterte Liste anzuzeigen, stellen Sie sicher, dass Sie sich auf der Registerkarte „Import Set-Zeilen“ befinden.
    3. Karte „Partitionen“.
    Grafische Ansicht der Import Set-Partitionen. 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 „Ausführungsdetails“ für zusätzliche Filter verwenden. Wenn Sie den Partitionsfilter mit den Kartenfiltern kombinieren, verwendet das System einen AND-Vorgang zum Filtern. Wenn Sie beispielsweise auf eine Partition klicken und dann auf die Karte „Fehler“ klicken, werden auf der Registerkarte „Import Set-Zeilen“ nur die Fehler für diese Partition angezeigt.
    4. Partitionslistenansicht
    Option zum Anzeigen der Details für jede Partition, einschließlich der Import Set-Nummer sowie des Typs und Status für jeden Import Set-Auftrag. Die Partitionslistenansicht wird nur für gleichzeitige Importsätze angezeigt. Die Partitionslistenansicht bietet die gleichen Filterfunktionen wie die Karte „Partitionen“, sodass Sie beide zum Filtern einer Partition verwenden können.
    5. Importdetails
    Abschnitt mit den Import Set-Zeilen, ausgehenden HTTP-Anforderungen, dem Verlauf der Aktionsausführung, den Importprotokollen und den Fehlern für jeden Ausführungsdatensatz.

    IntegrationHub Importbedingungen

    Importe in IntegrationHub haben diese Komponenten.
    Datenquelle
    Eine Datenquelle ist ein Konfigurationsdatensatz, der den Typ der zu importierenden Daten und den Endpunkt definiert, an dem sie von Ihrer Instanz abgerufen werden kann.
    Datenstromaktion
    Eine Datenstrom-Aktion ist eine Aktion, die REST-, SOAP- oder JDBC-Anforderungen von Flow Designer an APIs sendet und einen Stream von Antwortdaten zurückgibt. Verwenden Sie Datenstrom-Aktionen, 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 umgewandelt 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 enthält 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 Import Set-Bereitstellungstabelle.

    Design Überlegungen

    Befolgen Sie diese Richtlinien, um die Vorteile von Importen von IntegrationHub zu nutzen.

    Alle IntegrationHub -Importe aus IntegrationHuberstellen
    Nur Integrationen, die in der IntegrationHub Importumgebung erstellt wurden, sind dort zugänglich. Sie können beispielsweise keine Datenquelle und Zuordnung über Plattformformulare konfigurieren, sondern den Import in IntegrationHubplanen. Nur in IntegrationHub erstellte Integrationen werden auf der Zielseite angezeigt.
    Ändern Sie Konfigurationsdatensätze nicht außerhalb von IntegrationHub
    Durch das direkte Ändern von Konfigurationsdatensätzen kann sich ändern, 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 in der Importschnittstelle IntegrationHub.
    Ändern Sie keine Datenstromaktionen, die in Datenquellen verwendet werden
    Durch das Ändern von Datenstromaktionen, die als Datenquellen verwendet werden, kann sich die Zuordnung von Quelle zu Ziel ändern. Wenn sich die Ausgabe für eine Datenstrom-Aktion ändert, wird auf der Seite „Zu Ziel zuordnen“ eine Warnung angezeigt, dass sich das komplexe Objektschema geändert hat. Möglicherweise müssen Sie die Zuordnung neu konfigurieren.