Erstellen Sie eine Dateityp-Datenquelle

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer
  • Erstellen Sie einen Datei Geben Sie den Datenquellendatensatz ein, um zu definieren, welche Daten ein Importsatz importieren soll.

    Vorbereitungen

    Erforderliche Rolle: import_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Weitere Informationen finden Sie unter Dateitypdatenquellen.

    Prozedur

    1. Navigieren zu Alle > System-Importsätze > Administration > Datenquellenan.
    2. Klicken Sie auf Neu.
    3. Füllen Sie das Formular aus.
      Feld Beschreibung
      Name Ein eindeutiger Name für diese Datenquelle.
      Tabellenbezeichnung für Importsatz Eine Bezeichnung für die zu verwendende Importsatz-Bereitstellungstabelle.
      Tabellenname für Importsatz Die ServiceNow AI Platform Verwendet die von Ihnen eingegebene Bezeichnung, um einen eindeutigen Tabellennamen zu erstellen. Dies verhindert eine Namespace-Kollision mit einer bereits vorhandenen Tabelle.
      Typ Datei .
      Format Nur das standardmäßige XML-basierte Dateiformat (.xlsx) wird unterstützt, es sei denn, es wird als „striktes XML-Dokument öffnen“ gespeichert.
      Gezippt Ausgewählt, wenn die Importdatei komprimiert ist.
      Batch-Import verwenden Wenn diese Option ausgewählt ist, wird angegeben, dass beim Laden von Daten Batches erstellt werden sollen, wenn Sie auf klicken Daten laden Oder Testlast 20 Datensätze .
      Batchgröße Gibt an, wie groß die Batches sein sollen. Wird nur angezeigt, wenn Verwenden Sie Batch-Import Feld ist ausgewählt.
      Die glide.import_set_load_usebatchUnd glide.import_set_load_batch_sizeEigenschaften wirken sich auf diese Felder aus. Die Prioritätsreihenfolge für die Eigenschaften und Felder lautet wie folgt: Wenn die Eigenschaft festgelegt ist, verwenden Sie den Eigenschaftswert. Wenn nicht, verwenden Sie den Feldwert. Wenn keine der Eigenschaften festgelegt ist, verwenden Sie die Standard-Batch-Größe von 1000.
      • Beispiel: Wenn glide.import_set_load_usebatch= Wahr Und glide.import_set_load_batch_size= 200 , Verwenden Sie 200 als Batchgröße, unabhängig von den Feldwerten.
      • Beispiel: Wenn glide.import_set_load_usebatch= Wahr Und glide.import_set_load_batch_sizeEigenschaft ist nicht festgelegt. Verwenden Sie die Standard-Batch-Größe von 1000.
      • Beispiel: Wenn glide.import_set_load_usebatchEigenschaft und nicht festgelegt Verwenden Sie Batch-Import Feld = Wahr , Verwenden Sie Batch-Größe Feldwert (oder der Standardwert 1000, wenn der Batch-Größe Feldwert ist nicht festgelegt)
      • Beispiel: Wenn glide.import_set_load_usebatchEigenschaft = falsch und Verwenden Sie Batch-Import Feld = wahr, verwenden Sie keinen Batch-Import, da die Eigenschaft auf „falsch“ festgelegt ist.
      Dateiabrufmethode Die Abrufmethode für diese Datei.
      Dateipfad Der Pfad zur zu importierenden Datei.
      Sie können einen Systemeigenschaftswert in dieses Feld mithilfe des Formats einfügen ${system.property.name} . Wenn die Verbindung hergestellt wird, wird die Variable durch den Wert der angegebenen Eigenschaft ersetzt.
      Hinweis:
      Für Dateien, die mithilfe von HTTP oder HTTPS abgerufen werden, die glide.ds.file.http.variable_replacementDie Eigenschaft muss „wahr“ sein, um die Systemeigenschaftenerweiterung zu verwenden.

      Sie können beispielsweise angeben Dateipfad Wert /Countries.csv?key=${datassource.apikey} . Wenn die Verbindung hergestellt wird, der Wert von datasource.apikeySystemeigenschaft wird als Wert für übergeben keyParameter.

      Hinweis:
      Bei HTTP- und HTTPS-Protokollen wird der Dateipfad automatisch URL-codiert. Geben Sie keinen URL-codierten Dateipfad an, wenn Sie eines dieser Protokolle verwenden.
      CSV-Begrenzungszeichen Das Trennzeichen für die CSV-Datei.
      Analyseskript Das Skript, das zum Analysieren einer einzelnen Eingabezeile verwendet wird. Während Sie das Skript eingeben, zeigt die automatische Skriptvervollständigung die Ihnen zur Verfügung stehenden Auswahlmöglichkeiten an. Weitere Informationen finden Sie unter Dateitypdatenquellen.
      Blattnummer Die Excel-Blattnummer zum Laden von Daten.
      Headerzeile Die Excel-Zeilennummer zum Laden der Spaltenbezeichnungen.
      Pfad für jede Zeile Der Pfadausdruck, der zum Auswählen von JSON-Objekten verwendet wird, die zu Zeilen in der Importsatztabelle werden. Der Pfad muss sein // Für JSON-Objekte.
      Arrays verwerfen Ausgewählt, um JSON-Arrays als Wert zu verwerfen. Deaktiviert, um JSON-Arrays als Wert zu serialisieren.
      Untergeordnete Knotenelemente erweitern Ausgewählt, wenn untergeordnete Elemente des XML-Knotens oder JSON-Objekts in zusätzliche Spalten konvertiert werden sollen. Deaktiviert, wenn der Wert der übergeordneten Spalte ein XML- oder JSON-Fragment sein soll. Beachten Sie für JSON, dass die Auswahl dieser Option nur Objekte erweitert, nicht Arrays. Informationen zur Unterstützung geschachtelter Arrays finden Sie unter Beispiele für JSON-Dateiimport.
      Daten in einzelner Spalte Ausgewählt, um Daten in einer einzelnen Spalte zu speichern.
      XPath für jede Zeile XPath-Ausdruck, der die Knoten auswählt, die zu Zeilen in der Importtabelle werden. Die untergeordneten Elemente der ausgewählten Knoten werden zu den Spalten in den Zeilen.
      SCP-Authentifizierungsmethode Auswahl zur Authentifizierung mit einem Anwendernamen und Passwort oder mit einem öffentlichen Schlüssel.
      Hinweis:
      Sie können sich nicht bei Datenquellen mit einem öffentlich-privaten Schlüsselpaar authentifizieren. Verwenden Sie stattdessen eine Anwendername- und Passwortauthentifizierung.
      Server Name des Servers, von dem die Tabellen importiert werden.
      Port Port, der zum Herstellen einer Verbindung mit dem angegebenen Server verwendet werden soll. Dieses Feld wird angezeigt, wenn Sie HTTP oder HTTPS als Dateiabrufmethode auswählen.
      Anwendername Anwendername für die Authentifizierung auf dem JDBC-Server.
      Passwort Passwort für die Authentifizierung auf dem JDBC-Server.
      Private Schlüsseldatei Schlüsseldatei bei Verwendung von Legacy-SCP-öffentlich-privaten Schlüsseldateien.
      Hinweis:
      • Sie können sich nicht bei Datenquellen mit einem öffentlich-privaten Schlüsselpaar authentifizieren. Verwenden Sie stattdessen die Authentifizierung mit Anwendername und Passwort.
      • Verwenden Sie diese Legacy-Option nicht. Obwohl sie zur Verwendung verfügbar ist, wird sie nicht unterstützt.
      Systemschlüsselspeicher Ausgewählt, um das Zertifikat vom FTPS-Server anhand aller gespeicherten Zertifikate zu validieren. Dieses Zertifikat kann ein beliebiger Typ sein, der von der Instanz unterstützt wird. Wenn nicht ausgewählt, verwendet die Instanz das Java-Standardzertifikat, um den FTPS-Server zu validieren. Dieses Feld ist nur für Datenquellen mit verfügbar Dateiabrufmethode Wert von FTPS . Alle FTPS-Dateiabrufmethoden werden unterstützt, einschließlich Authentifizierungs-TLS, Authentifizierungs-SSL, implizites SSL und implizites TLS.
    4. Klicken Sie auf Absenden.

    Nächste Maßnahme

    Definieren Sie eine Transformationszuordnung für die neue Datenquelle, und führen Sie einen Import aus.