Importer des tâches depuis un fichier CSV

Format attendu du fichier CSV

La première ligne contient les quatre en-têtes de colonne, dans cet ordre, séparés par des virgules ou des points-virgules :

Title,Description,Source,Destination

Chaque ligne suivante correspond à une tâche. Un fichier présentant une autre structure est refusé avant toute importation. Le fichier lui-même peut porter n'importe quel nom.

Colonne	Contenu
Title	Obligatoire. Le titre de la nouvelle tâche. Les lignes portant le même titre sont numérotées, par exemple Finance 01 et Finance 02, afin de pouvoir distinguer leurs tâches.
Description	Texte facultatif, pour la description de la tâche.
Source	La source de la tâche, écrite selon le format attendu par le type de source de la tâche d'import : une URL de bibliothèque pour Bibliothèque SharePoint, un chemin UNC ou un lecteur pour Partage de fichiers, une adresse e-mail (UPN) pour OneDrive.
Destination	La destination de la tâche, écrite selon le format attendu par le type de destination de la tâche d'import : le nom d'un dossier d'équipe pour Dossier d'équipe Nextcloud, un nom d'utilisateur ou une adresse e-mail Nextcloud pour Utilisateur Nextcloud.

Un exemple pour des partages de fichiers vers des dossiers d'équipe

Title;Description;Source;Destination

Finance archive;Old finance share;\\fileserver\finance;Finance

HR documents;;\\fileserver\hr;HR

Virgule ou point-virgule : le séparateur retenu est celui que la première ligne utilise le plus. Une feuille de calcul enregistrée au format CSV dans un pays où les décimales s'écrivent avec une virgule utilise des points-virgules, ce qui ne pose aucun problème.
Guillemets : une valeur contenant le séparateur est placée entre guillemets doubles, comme le font les tableurs lorsqu'ils enregistrent au format CSV.
En-têtes : les noms sont imposés, mais pas leur casse. Un séparateur après le dernier en-tête est toléré ; une colonne supplémentaire ne l'est pas.
Les lignes vides sont ignorées. Une ligne sans Title bloque l'importation tant qu'elle n'en a pas.
Un seul type par fichier : chaque ligne est lue avec l'unique type de source et l'unique type de destination de la tâche d'import ; un fichier ne peut donc pas mélanger partages de fichiers et bibliothèques SharePoint. Créez une tâche d'import par type.
Pas de colonne Groupe : toutes les tâches créées par un fichier sont classées dans le groupe propre à l'importation, nommé d'après le Groupe d'import défini dans Tâche par défaut. Pour répartir une liste sur plusieurs groupes, divisez-la en un fichier par groupe, ou fusionnez et déplacez les tâches ensuite avec Gérer les groupes.

Créer la tâche d'import pour un fichier CSV

Dans l'onglet Tâches, ouvrez Nouvelle tâche et choisissez Import de tâches.
Dans Importer depuis, choisissez CSV dans Nextcloud Files.
Sélectionnez le fichier avec Choisir un fichier : choisissez-le dans Nextcloud Files, téléversez-en un — en le faisant glisser depuis votre ordinateur sur le sélecteur, ou avec Téléverser un fichier — ou laissez Créer un nouveau fichier CSV ici créer Import01.csv avec les en-têtes et une ligne d'exemple, prêt à être complété. Vous pouvez aussi coller le lien interne du fichier, obtenu depuis son menu Partage.
Dans Source par défaut et Destination par défaut, définissez le type de source et le type de destination pour lesquels les lignes sont rédigées, ainsi que les paramètres attribués à chaque nouvelle tâche.
Choisissez Enregistrer et importer le CSV maintenant.

Ouvrir le fichier ouvre le fichier CSV dans Nextcloud Files dans un nouvel onglet, afin de pouvoir le modifier en ligne. Une fois le fichier enregistré, Actualiser l'aperçu le relit.

Dans le tableau des tâches et sur la carte récapitulative de la tâche d'import, sa source est l'emplacement du fichier CSV dans Nextcloud Files, par exemple /Imports/Import01.csv — et non son lien.

Vérification et aperçu

Dès que le fichier est lié, la boîte de dialogue le lit et affiche :

son emplacement et la date de sa dernière modification,
Trouvé : … avec le nombre de tâches qu'il contient,
un aperçu de ses premières lignes, où chaque valeur ne correspondant pas à sa colonne est signalée,
un avertissement indiquant la première ligne posant problème, ainsi que le nombre total de lignes concernées.

Les valeurs ne correspondant pas à leur type sont tout de même importées

Une ligne dont la Source ou la Destination ne correspond pas aux types de la tâche d'import — un site là où une bibliothèque est attendue, un chemin UNC qui n'en est pas un, un nom d'utilisateur contenant des caractères non autorisés par Nextcloud — est tout de même importée, mais sa tâche est créée avec le statut Non validée et ne peut pas passer à Prêt tant qu'elle n'a pas été corrigée. Dans un import Analyse, seule la Source est prise en compte : une tâche d'analyse n'écrit nulle part, sa Destination est donc vérifiée lorsque la tâche est convertie en migration. Un fichier sans les bons en-têtes, ou comportant une ligne sans Title, n'est pas importé du tout.

Importer le fichier

Enregistrer et importer le CSV maintenant enregistre la tâche d'import, puis importe le fichier sous forme d'exécution de cette tâche, comme SMART Migration l'exécuterait : la tâche passe à En cours, une ligne de l'historique d'exécution et son journal sont écrits, et tous deux se terminent avec le statut Terminé. Un récapitulatif indique ensuite combien de tâches ont été créées, combien sont validées et prêtes à passer à Prêt, combien ne sont pas validées et pourquoi, ainsi que le groupe dans lequel elles se trouvent, avec un lien vers l'exécution.

Une tâche d'import CSV ne passe jamais à Prêt et n'a ni planification, ni récurrence, ni priorité : elle est exécutée depuis la boîte de dialogue, chaque fois que vous choisissez Enregistrer et importer le CSV maintenant. Chaque import crée de nouvelles tâches ; importer deux fois le même fichier crée les tâches en double.

Voir aussi