Schlüsselkonzepte für Importsätze

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 4 Minuten Lesedauer
  • Erfahren Sie mehr über Importsätze, bevor Sie Daten in Ihre Instanz importieren.

    Die Importsatztabelle dient als Bereitstellungsbereich für Datensätze, die aus einer Datenquelle importiert wurden.

    Hinweis:
    Importieren Sie Daten nicht in sehr großen Blöcken. Das Erstellen eines sehr großen Importsatzes kann zu Verzögerungen und Systemausfällen führen.

    Eine Transformationszuordnung bestimmt die Beziehungen zwischen Feldern in einer Importsatztabelle und Feldern in einer vorhandenen ServiceNow -Tabelle, z. B. der Tabelle „Incidents“ oder „Benutzer“.

    Beim Importieren von Datensätzen werden Datensätze übersprungen, wenn die Daten in der Instanz mit den importierten Daten übereinstimmen.

    Hinweis:
    Importsätze werden als Benutzersystem ausgeführt und können daher keine Daten zu verschlüsselten Feldern hinzufügen.

    Importsatz-Terminologie

    Tabelle : 1. Wichtige Begriffe
    Benennung Definition
    Importsatztabelle

    Eine Tabelle, die als Bereitstellungsort für Datensätze fungiert, die aus einer Datenquelle importiert wurden, bevor diese Datensätze transformiert werden. Felder in diesen Tabellen werden automatisch basierend auf importierten Daten generiert und dürfen nicht manuell geändert werden.

    Hinweis:
    Spalten in einer Importsatztabelle werden automatisch generiert und dürfen nicht manuell hinzugefügt werden. Das manuelle Hinzufügen von Spalten kann die geplante Bereinigung der Tabelle beeinträchtigen und zu einer unvollständigen Bereinigung sowie zu verwaisten Datensätzen führen.

    Wenn Sie einer Importsatztabelle Spalten hinzufügen müssen, fügen Sie zuerst die Spalte zu den Eingabedaten hinzu, und wählen Sie dann „ Testladen von 20 Datensätzen “ oder „Alle Datensätze laden“ aus, um die Spalten automatisch in der Importsatztabelle zu generieren.

    Spalten in einer Importsatztabelle haben möglicherweise nicht den gleichen Typ wie die Eingabedaten. Beispielsweise kann eine Währungsspalte als Zeichenfolgenspalte in einer Importsatztabelle dargestellt werden, bis sie einer Zieltabellenspalte vom Typ „Währung“ zugewiesen wird.

    Datenquelle Ein Datensatz, der definiert, wo die zu importierenden Daten abgerufen werden sollen. Eine Datenquelle kann auf eine Datei, eine JDBC-kompatible Datenbank oder eine LDAP-Organisationseinheit verweisen.
    Transformation Die Konvertierung von Daten aus einer Importsatztabelle in eine andere Tabelle gemäß den in einer Transformationszuordnung definierten Regeln.
    Transformationszuordnung Ein Satz von Feldzuordnungen, die die Beziehungen zwischen Feldern in einem Importsatz und Feldern in einer Tabelle (z. B. Incident) definieren

    Während der Transformation werden Daten basierend auf der Transformationszuordnung aus der Importsatz-Tabelle in die Zieltabelle kopiert.

    Ein einzelnes Importsatz-Feld kann mehreren Feldern in anderen Tabellen zugeordnet werden.

    Robuster Transformator für Importsatz Extrahieren, transformieren und laden Sie Daten in eine oder mehrere Zieltabellen. Trennen Sie die Transformations- und Verarbeitungsfunktionen, um eine flexiblere Alternative zu Transformationszuordnungen zu bieten.
    Einfügen eines fremden Datensatzes Das Einfügen eines fremden Datensatzes tritt auf, wenn ein Import eine Änderung an einer Tabelle vornimmt, die nicht die Zieltabelle für diesen Import ist.

    Diese Änderung tritt auf, wenn ein Referenzfeld in einer Tabelle aktualisiert wird. Wenn beispielsweise ein Wert für den Anrufer in einem Incident aktualisiert wird, aktualisiert der Import tatsächlich die Tabelle „sys_user“.

    Zusammenfügen Ermöglicht das Aktualisieren vorhandener Zieltabellen-Datensätze beim Transformieren von Importdaten.

    Sie können angeben, ob ein Zielfeld zum Zusammenfügen von verwendet werden soll, wenn Importsatz-Datensätze transformiert werden. Wenn die Option Zusammenfügen der Feldzuordnung ausgewählt ist und die Importsatzzeile transformiert wird, sucht die Instanz nach einem vorhandenen Datensatz in der Zieltabelle, der denselben Wert im Feld Ziel aufweist wie das Quellfeld der Importsatzzeile.

    Wenn ein vorhandener Datensatz mit einem übereinstimmenden Wert in der Zieltabelle gefunden wird, wird dieser Datensatz aktualisiert. Wenn kein übereinstimmender Datensatz gefunden wird, wird ein neuer Datensatz in der Zieltabelle erstellt.

    Unterstützte Importformate

    Sie können Daten aus verschiedenen Dateiformaten oder externen Datenquellen importieren.

    Tabelle : 2. Dateiformate
    Format Einschränkungen
    CSV CSV-Dateien müssen dem vorgeschlagenen CSV-Standard in RFC4180 entsprechen. Dies bedeutet insbesondere, dass keine doppelten Anführungszeichen innerhalb von Feldern angezeigt werden dürfen. Die erste Datenzeile in einer importierten CSV-Datei wird zur Headerzeile und definiert die Spalten für diesen Importsatz.
    Excel Excel-Dateien müssen die Erweiterung XLS oder XLSX aufweisen.
    XML XML-Dateien müssen für jede Datenzeile einen konsistenten XPath aufweisen.
    JSON
    • Bei JSON -Arrays muss der Pfad für jede Zeile das Array-Stammelement zweimal angeben, z. B. /incidents/incidents.
    • JSON -Dateien müssen RFC-4627 entsprechen. Beispielsweise sollte ein einzelnes Komma einen Wert vom folgenden Namen trennen. Namen innerhalb eines Objekts müssen eindeutig sein.
    • Prädikate wie @element, [index]oder text()sowie Achsen wie untergeordnete Elemente, gleichgeordnete Elemente oder Vorgängerelemente werden nicht unterstützt.
    Anwendererdefiniert (nach Skript analysieren) Sie können anwenderdefiniertes JavaScript schreiben, um Eingabezeilen in der Liste der Zuordnungen zu analysieren.

    Die Plattform ServiceNow® kann Daten aus den folgenden externen Datenquellen importieren.

    Tabelle : 3. Externe Datenquellen
    Datenquelle Einschränkungen
    JDBC JDBC-Importe erfordern eine gültige Transformationszuordnung. Einige Netzwerkkonfigurationen erfordern möglicherweise ServiceNow® MID-Server.
    LDAP LDAP-Importe erfordern eine gültige Transformationszuordnung.
    OIDC OIDC-Importe erfordern eine gültige Transformationszuordnung.
    ServiceNow® REST (IntegrationHub) REST-Importe erfordern eine gültige Transformationszuordnung.
    Anwendererdefiniert (nach Skript laden) Anwenderdefinierte Importe erfordern eine gültige Transformationszuordnung.

    Weitere Informationen zu den verschiedenen Datenquellen finden Sie unter Datenquellen.

    Transformationszuordnungen im Vergleich zu robusten Importsatz-Umwandlern

    Sowohl Transformationszuordnungen als auch robuste Importsatz-Umwandler konvertieren Daten. Transformationszuordnungen konvertieren Daten aus der Bereitstellungstabelle in die Zieldatei. Robuste Transformatoren für Importsatz konvertieren Daten aus einer Quelltabelle in einen Nachrichten-Listener. Wenn eine Datenquelle sowohl über eine Transformationszuordnung als auch über einen robusten Importsatz-Umwandler verfügt, verwendet das System den robusten Importsatz-Umwandler anstelle der Transformationszuordnung.

    Geplante Bereinigung des Importsatzes

    Die geplante Aufgabe Import Set Deleter bereinigt jeden Tag um Mitternacht alte Importsatzdaten.

    Standardmäßig löscht die Aufgabe alle Importsätze, die älter als 7 Tage sind, sowie die zugehörigen Datensätze in der Importsatztabelle. Wenn diese geplante Aufgabe in Ihrer Instanz nicht aktiv ist, aktivieren Sie sie, um die möglicherweise vorhandenen Importsatztabellen zu verringern, insbesondere bei der Verwendung wiederkehrender Importe.
    Hinweis:
    Wenn die geplante Bereinigung auf Ihrem System derzeit nicht aktiv ist, müssen Sie sicherstellen, dass Ihre Importsatztabellen nicht zu groß sind (insgesamt mehr als 5 Millionen Datensätze für alle Tabellen), bevor Sie diese Bereinigung aktivieren. Wenn die Tabellen zu groß sind, löschen Sie die Datensätze zuerst manuell, bevor Sie fortfahren. Wenden Sie sich an Kundenservice und Support, um die Löschung dieser Daten zu koordinieren.
    Abbildung : 1. Geplante Skriptausführung
    Importsatzlöscher

    Hinweise zu Verfahren siehe Importsätze löschen.

    Tabellenlöscher für Importsatz

    Sie können eine oder alle der folgenden Importsatztabellen manuell löschen:
    • Computer
    • Anwender
    • Benachrichtigung
    • Standort
    Sie können auch die zugehörigen Transformationszuordnungen löschen oder nur Daten löschen und die Tabellenstruktur beibehalten.
    Abbildung : 2. Zum Löschen verfügbare Tabellen
    Tabellenlöscher für Importsatz.

    Hinweise zu Verfahren siehe Löschen Sie Importsatztabellen.