Zum Hauptinhalt springen
Aktualisieren Sie einen vorhandenen Datenkatalog, indem Sie eine neue CSV-Datei hochladen — entweder über die Vantage UI oder indem Sie die Datei in einem per SFTP verbundenen freigegebenen Ordner ablegen.

CSV-Format

Beachten Sie beim Vorbereiten einer CSV-Datei für den Upload die folgenden Regeln:
  • Spalten müssen durch Kommas getrennt sein.
  • Zwischen einem Spaltennamen und dem trennenden Komma sind keine Leerzeichen zulässig.
  • Werte, die Kommas enthalten und als Literal behandelt werden sollen, müssen in doppelte Anführungszeichen gesetzt werden.
  • Anführungszeichen innerhalb von String-Werten müssen verdoppelt werden, und der gesamte String-Wert muss ebenfalls in doppelte Anführungszeichen gesetzt werden.
Sie können Microsoft Excel zum Bearbeiten der CSV-Datei verwenden.
Die CSV-Datei darf nicht größer als 100 MB sein.
Beim Aktualisieren eines Datenkatalogs Document Issuer Companies oder Document Receiver Companies müssen die Spalten Company ID und Country ausgefüllt werden. Leere Werte in diesen Spalten führen dazu, dass die Aktualisierung fehlschlägt.

Beispiel: Wert mit einem Komma

Id,VATID,BusinessUnitId,IBAN,BankAccount,BankCode,Name,ZIP,Street,City,State,CountryCode
"999,9",GB_fake01,01,123456678,PPPCCC,CB3 AAA,CAMBRIDGESHIRE COUNTY COUNCIL,PO Box 123456,str1,Cambridge,East,GB
"0,1",GB_fake02,01,123487654,CCCPPP,AAA BB3,Random Company Inc.,PO Box 45678,str2,Oxford,South East England,GB

Beispiel: Wert mit Anführungszeichen

Id,VATID,Name,ZIP,Street,City,State,CountryCode
1,GB_fake01,"CAMBRIDGESHIRE ""COUNTY COUNCIL""",22313,str1,Cambridge,East,GB
2,GB_fake02,Random Company Inc.,22314,str2,Oxford,South East England,GB

Aktualisieren über die Benutzeroberfläche

1

CSV auswählen und hochladen

Wählen Sie auf der Registerkarte Datenkataloge den Katalog aus der Liste aus und klicken Sie im Bereich über der Liste auf Aktualisieren. Ziehen Sie die CSV-Datei auf die Seite, oder klicken Sie oben auf dem Bildschirm auf Durchsuchen.
Der Name der CSV-Datei muss mit dem Namen des Datenkatalogs übereinstimmen. Andernfalls erstellt Vantage stattdessen einen neuen Katalog.
2

Neue Spalten verarbeiten (falls vorhanden)

Wenn Vantage neue Spalten in der CSV-Datei erkennt, wählen Sie eine der folgenden Optionen:
  • Hinzufügen — fügt die neuen Spalten hinzu und aktualisiert den Datenkatalog.
  • Überspringen — ignoriert die neuen Spalten, aktualisiert den Datenkatalog aber dennoch.
Sie können die Spalteneigenschaften nur für neue Spalten bearbeiten.
Nach erfolgreicher Aktualisierung zeigt ein Dialogfeld die Anzahl der aktualisierten Datensätze sowie alle hinzugefügten oder entfernten Spalten an.

Über einen freigegebenen Ordner aktualisieren

Stellen Sie zunächst über SFTP eine Verbindung zum freigegebenen Ordner her.
1

Einen SFTP-Client installieren

Installieren und starten Sie einen beliebigen SFTP-Client (z. B. FileZilla oder WinSCP).
2

Den Pfad des freigegebenen Ordners kopieren

Wählen Sie auf der Registerkarte Datenkatalog den Katalog aus und öffnen Sie das Dialogfeld Settings. Kopieren Sie den Pfad aus dem Feld Folder to upload CSV.
Dialogfeld für Datenkatalog-Einstellungen mit hervorgehobenem Pfad „Folder to upload CSV“
3

Im SFTP-Client verbinden

Fügen Sie den Pfad in das Feld Host Ihres SFTP-Clients ein und klicken Sie auf Connect.
FileZilla-SFTP-Client mit aus den Datenkatalog-Einstellungen übernommenem Host-Wert
4

Dem Host vertrauen

Klicken Sie im Bestätigungsdialog auf OK, um dem Host zu vertrauen. Der Ordner Catalogs wird im Remote-Ordnerbereich des SFTP-Clients angezeigt.
Um einen Datenkatalog zu aktualisieren, geben Sie der CSV-Datei denselben Namen wie dem Datenkatalog und legen Sie sie im Ordner Catalogs ab.
Vantage überprüft den Ordner Catalogs alle 20 Sekunden und aktualisiert jeden Datenkatalog, dessen Name mit einer CSV-Datei im Ordner übereinstimmt.
Wenn ein Datenkatalog über den freigegebenen Ordner aktualisiert wird, werden vorhandene Datensätze durch die neuen ersetzt.

Ergebnisse der Aktualisierung

DateistatusErgebnis
Alle Datensätze sind gültigDer Katalog wird aktualisiert; die Datei wird aus Catalogs gelöscht.
Einige Datensätze sind leerLeere Datensätze werden ignoriert; gültige Datensätze werden importiert; die Datei wird aus Catalogs gelöscht.
Einige Spalten fehlenFehlende Spalten werden ignoriert; vorhandene Spalten werden importiert; die Datei wird aus Catalogs gelöscht.
Die Datei enthält neue SpaltenNeue Spalten werden zum Katalog hinzugefügt; die Datei wird aus Catalogs gelöscht.
Datensätze liegen im falschen Format vorDer Katalog wird nicht aktualisiert; die Datei wird in Catalogs-exception verschoben.
Die Datei kann nicht geöffnet werden oder der Name stimmt nicht mit einem Katalog übereinDer Katalog wird nicht aktualisiert; die Datei wird in Catalogs-exception verschoben.