Wie die CSV-Datei aussehen muss
Abschnitt betitelt „Wie die CSV-Datei aussehen muss“Die erste Zeile enthält die vier Spaltenüberschriften in dieser Reihenfolge, getrennt durch Kommas oder Semikolons:
Title,Description,Source,DestinationJede weitere Zeile ist ein Auftrag. Eine Datei in einem anderen Aufbau wird abgelehnt, bevor etwas importiert wird. Die Datei selbst kann einen beliebigen Namen haben.
| Spalte | Was sie enthält |
|---|---|
| Title | Pflichtfeld. Der Titel des neuen Auftrags. Zeilen mit demselben Titel werden nummeriert, etwa Finance 01 und Finance 02, damit sich ihre Aufträge unterscheiden lassen. |
| Description | Optionaler Text für die Beschreibung des Auftrags. |
| Source | Die Quelle des Auftrags, so geschrieben, wie es der Quelltyp des Import-Auftrags erwartet: eine Bibliotheks-URL für SharePoint-Bibliothek, ein UNC-Pfad oder Laufwerk für Dateifreigabe, eine E-Mail-Adresse (UPN) für OneDrive. |
| Destination | Das Ziel des Auftrags, so geschrieben, wie es der Zieltyp des Import-Auftrags erwartet: der Name eines Teamordners für Nextcloud-Teamordner, ein Nextcloud-Benutzername oder eine E-Mail-Adresse für Nextcloud-Benutzer. |
Ein Beispiel für Dateifreigaben in Teamordner
Title;Description;Source;Destination
Finance archive;Old finance share;\\fileserver\finance;Finance
HR documents;;\\fileserver\hr;HR
- Komma oder Semikolon: dasjenige, das in der ersten Zeile häufiger vorkommt. Eine Tabelle, die in einem Land, in dem Dezimalzahlen mit Komma geschrieben werden, als CSV gespeichert wird, verwendet Semikolons, und das ist in Ordnung.
- Anführungszeichen: Ein Wert, der das Trennzeichen enthält, wird in doppelte Anführungszeichen gesetzt, so wie es Tabellenkalkulationen beim Speichern als CSV tun.
- Überschriften: Die Namen sind festgelegt, nicht aber ihre Groß- und Kleinschreibung. Ein Trennzeichen nach der letzten Überschrift wird toleriert, eine zusätzliche Spalte nicht.
- Leere Zeilen werden übersprungen. Eine Zeile ohne Title stoppt den Import, bis sie einen erhält.
- Eine Art pro Datei: Jede Zeile wird mit dem einen Quelltyp und dem einen Zieltyp des Import-Auftrags gelesen, daher kann eine Datei Dateifreigaben und SharePoint-Bibliotheken nicht mischen. Legen Sie pro Art einen Import-Auftrag an.
- Keine Spalte für die Gruppe: Jeder Auftrag, den eine Datei erzeugt, wird in der eigenen Gruppe des Imports abgelegt, die nach der Importgruppe unter Job – Vorgaben benannt ist. Um eine Liste auf mehrere Gruppen zu verteilen, teilen Sie sie in eine Datei pro Gruppe auf oder führen Sie die Aufträge anschließend mit Gruppen verwalten zusammen und verschieben Sie sie.
Den Importauftrag für eine CSV-Datei anlegen
Abschnitt betitelt „Den Importauftrag für eine CSV-Datei anlegen“- Öffnen Sie auf der Registerkarte Aufträge den Eintrag Neuer Auftrag und wählen Sie Auftragsimport.
- Wählen Sie unter Importieren aus die Option CSV in Nextcloud Files.
- Wählen Sie die Datei mit Datei auswählen: Wählen Sie sie aus Nextcloud Files aus, laden Sie eine hoch – ziehen Sie sie von Ihrem Computer auf die Auswahl oder verwenden Sie Datei hochladen – oder lassen Sie mit Hier neue CSV-Datei erstellen die Datei
Import01.csvmit den Überschriften und einer Beispielzeile anlegen, bereit zum Ausfüllen. Auch das Einfügen des internen Links der Datei aus ihrem Menü Teilen funktioniert. - Legen Sie unter Quelle – Vorgaben und Ziel – Vorgaben den Quelltyp und den Zieltyp fest, für die die Zeilen geschrieben sind, sowie die Einstellungen, die jeder neue Auftrag erhält.
- Wählen Sie Speichern und CSV jetzt importieren.
Datei öffnen öffnet die CSV-Datei in Nextcloud Files in einem neuen Tab, sodass sie online bearbeitet werden kann. Nachdem Sie sie dort gespeichert haben, liest Vorschau aktualisieren sie erneut ein.
In der Auftragstabelle und auf der Übersichtskarte des Importauftrags ist als Quelle der Speicherort der CSV-Datei in Nextcloud Files angegeben, etwa /Imports/Import01.csv – nicht ihr Link.
Die Prüfung und die Vorschau
Abschnitt betitelt „Die Prüfung und die Vorschau“Sobald die Datei verknüpft ist, liest der Dialog sie ein und zeigt:
- wo sie liegt und wann sie zuletzt geändert wurde,
- Gefunden: … mit der Anzahl der enthaltenen Aufträge,
- eine Vorschau der ersten Zeilen, in der jeder Wert markiert ist, der nicht zu seiner Spalte passt,
- eine Warnung, die die erste fehlerhafte Zeile nennt und angibt, wie viele Zeilen insgesamt einen Fehler aufweisen.
Werte, die nicht zu ihrem Typ passen, werden trotzdem importiert
Eine Zeile, deren Source oder Destination nicht zu den Typen des Importauftrags passt – eine Website, wo eine Bibliothek erforderlich ist, ein UNC-Pfad, der keiner ist, ein Benutzername mit Zeichen, die Nextcloud nicht zulässt –, wird dennoch importiert, ihr Auftrag wird jedoch als Nicht validiert angelegt und kann erst auf Bereit gesetzt werden, wenn er korrigiert ist. Bei einem Import vom Typ Analyse zählt nur die Source: Ein Analyseauftrag schreibt nirgendwohin, daher wird seine Destination geprüft, sobald der Auftrag auf eine Migration umgestellt wird. Eine Datei ohne die richtigen Überschriften oder mit einer Zeile ohne Title wird überhaupt nicht importiert.
Die Datei importieren
Abschnitt betitelt „Die Datei importieren“Speichern und CSV jetzt importieren speichert den Importauftrag und importiert die Datei anschließend als Lauf dieses Auftrags, so wie SMART Migration ihn ausführen würde: Der Auftrag wird auf Läuft gesetzt, eine Zeile im Laufverlauf und das zugehörige Protokoll werden geschrieben, und beide enden mit Abgeschlossen. Eine Zusammenfassung gibt dann an, wie viele Aufträge angelegt wurden, wie viele validiert sind und auf Bereit gesetzt werden können, wie viele nicht validiert sind und warum und in welcher Gruppe sie sich befinden, mit einem Weg zum Lauf.
Ein CSV-Importauftrag wird nie auf Bereit gesetzt und hat weder Zeitplan noch Wiederholung noch Priorität: Er wird aus dem Dialog ausgeführt, und zwar jedes Mal, wenn Speichern und CSV jetzt importieren gewählt wird. Jeder Import legt neue Aufträge an; wird dieselbe Datei zweimal importiert, entstehen die Aufträge doppelt.
Siehe auch