Importsätze – Schlüsselkonzepte

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer
  • Erfahren Sie mehr über Importsätze, bevor Sie Daten in Ihre Instanz importieren.

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

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

    Eine Transformationszuordnung bestimmt die Beziehungen zwischen Feldern, die in einer Importsatztabelle angezeigt werden, und Feldern in einer vorhandenen ServiceNow Tabelle, z. B. die Tabelle „Incidents“ oder „Anwender“.

    Importsätze überspringen Datensätze, wenn die Daten in der Instanz mit den zu importierenden Daten übereinstimmen.

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

    Importsätze – 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 sollten nicht manuell hinzugefügt werden. Das manuelle Hinzufügen von Spalten kann sich negativ auf die geplante Bereinigung der Tabelle auswirken und zu einer unvollständigen Bereinigung und zu verwaisten Datensätzen führen.

    Wenn Sie einer Importsatztabelle Spalten hinzufügen müssen, fügen Sie die Spalte zuerst den Eingabedaten hinzu, und wählen Sie dann aus Laden Sie 20 Datensätze Im Test Oder Alle Datensätze Laden Dient zum automatischen Generieren der Spalten in der Importsatztabelle.

    Spalten in einer Importsatztabelle haben möglicherweise nicht denselben Typ wie die Eingabedaten. Beispielsweise kann eine Währungsspalte in einer Importsatztabelle als Zeichenfolgenspalte 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 Eine Reihe von Feldzuordnungen, die die Beziehungen zwischen Feldern in einem Importsatz und Feldern in einer Tabelle definieren, z. B. Incident.

    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.
    Fremddatensatz einfügen Ein Fremddatensatz wird eingefügt, 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 Zieltabellendatensätze beim Transformieren von Importdaten.

    Sie können angeben, ob ein Zielfeld Sollte verwendet werden, um zusammenzufügen, wenn Importsatzdatensätze umgewandelt werden. Wenn die Feldzuordnung Zusammenfügen Die Option ist ausgewählt. Wenn die Importsatzzeile umgewandelt wird, sucht die Instanz nach einem vorhandenen Datensatz in der Zieltabelle, der denselben Wert in hat Zielfeld Als Importsatzzeile Quellfeld .

    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 entsprechen RFC4180 . Dies bedeutet insbesondere, dass doppelte Anführungszeichen nicht in 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 XLS- oder XLSX-Erweiterung haben.
    XML XML-Dateien müssen für jede Datenzeile einen konsistenten XPath aufweisen.
    JSON
    • Für JSON Arrays, der Pfad für jede Zeile muss das Array-Stammelement zweimal angeben, z. B. /Incidents/Incidents .
    • JSON Dateien müssen folgen RFC-4627 . 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änger werden nicht unterstützt.
    Anwenderdefiniert (nach Skript analysieren) Sie können anwenderdefiniertes JavaScript schreiben, um Eingabezeilen in die Liste der Zuordnungen zu analysieren.

    Die ServiceNow® Die Plattform 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 einen 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.
    Anwenderdefiniert (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-Transformatoren

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

    Geplante Bereinigung des Importsatzes

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

    Standardmäßig löscht der Auftrag alle Importsätze, die älter als 7 Tage sind, sowie die zugehörigen Importsatztabellendatensätze. Wenn diese geplante Aufgabe in Ihrer Instanz nicht aktiv ist, aktivieren Sie sie, um die wachsenden Importsatztabellen zu mindern, die Sie möglicherweise haben, insbesondere bei Verwendung wiederkehrender Importe.
    Hinweis:
    Wenn die geplante Bereinigung in Ihrem System derzeit nicht aktiv ist, müssen Sie sicherstellen, dass Ihre Importsatztabellen nicht zu groß sind (> 5 Millionen Datensätze insgesamt für alle Tabellen), bevor Sie diese Bereinigung aktivieren. Wenn die Tabellen zu groß sind, löschen Sie zuerst die Datensätze manuell, bevor Sie fortfahren. Kontakt Kundenservice und Support Um das Löschen 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. Tabellen, die zum Löschen verfügbar sind
    Tabellenlöscher für Importsatz.

    Hinweise zu Verfahren siehe Importsatztabellen löschen.