Important 

Cette fonctionnalité d’importation est disponible sur notre branche Dev.

Importer des lots de travaux à partir d’un fichier CSV

Vous pouvez créer plusieurs lots de travaux à la fois en téléversant un fichier CSV. Les lots de travaux existants ne sont jamais modifiés par une importation, et aucune notification n’est envoyée pour les lots de travaux qu’elle crée.

Vue d’ensemble

Sujet	Contenu
Avant de commencer	L’autorisation dont vous avez besoin et le modèle à utiliser pour commencer.
Importer un fichier	Comment vérifier d’abord un fichier, puis l’importer.
Référence des colonnes	Toutes les colonnes pouvant être importées et la manière dont leurs valeurs sont mises en correspondance.
Limites	Taille maximale autorisée pour un fichier.
Éléments non importés	Ce que l’importation CSV ne prend actuellement pas en charge.

Avant de commencer

Remarque

Vous devez disposer de l’autorisation Importer des lots de travaux pour importer des lots de travaux dans un projet. Elle peut être attribuée à un rôle dans l’administration des rôles et autorisations, avec l’autorisation Ajouter des lots de travaux dont elle dépend.

Pour ouvrir la page d’importation, accédez aux Paramètres du projet de votre projet et sélectionnez Outil d’importation des lots de travaux dans la barre latérale.

Commencez à partir du modèle. Le lien Télécharger le modèle de la page d’importation vous fournit un fichier CSV contenant les en-têtes de colonnes exacts acceptés par ce projet ainsi que deux lignes d’exemple. Remplacez les exemples par vos propres données, conservez la ligne d’en-tête et enregistrez le fichier au format CSV UTF-8.

Le fichier doit être un fichier .csv encodé en UTF-8 ou UTF-16. La virgule, le point-virgule et la tabulation sont tous acceptés comme séparateurs, et le séparateur est détecté à partir de la ligne d’en-tête. Un fichier exporté par un tableur, quelle que soit la configuration régionale, peut donc être téléversé tel quel. Une valeur contenant le séparateur, un saut de ligne ou un guillemet doit être placée entre guillemets, ce que les tableurs font automatiquement pour vous.

Importer un fichier

1. Sélectionnez le fichier sous Fichier CSV.
2. Laissez l’option Vérifier d’abord le fichier, sans l’importer sélectionnée. Chaque ligne est alors validée et signalée dans le rapport, mais rien n’est créé.
3. Sélectionnez Vérifier le fichier.
4. Consultez le rapport. Si le fichier présente des problèmes, chacun est répertorié avec la ligne concernée, la colonne, la valeur et la nature du problème. Si un fichier présente de nombreux problèmes, la page affiche les 500 premiers. Le téléchargement CSV situé à côté de la liste contient toujours l’ensemble des problèmes, ce qui vous permet de les traiter dans votre tableur.
5. Corrigez le fichier et vérifiez-le de nouveau jusqu’à ce que le rapport n’indique plus aucun problème.
6. Sélectionnez le bouton Importer, qui indique le nombre de lots de travaux qui seront créés, afin de les créer.

Le résumé affiché après une vérification réussie vous indique le nombre de lignes lues, le nombre de comptes mentionnés dans les colonnes Assignee, Accountable et Author, ainsi que les types, statuts, priorités et catégories utilisés dans les lignes. Vous pouvez ainsi vérifier que le fichier a été interprété comme prévu avant toute création.

Une fois l’importation exécutée, le rapport contient des liens vers les lots de travaux créés. Le lien ouvre une vue nommée Importation CSV du suivie de la date et de l’heure de l’exécution, enregistrée de manière privée pour vous. Cette vue apparaît également sous vos propres vues dans la barre latérale du module des lots de travaux. Supprimez-la comme n’importe quelle autre vue lorsque vous n’en avez plus besoin.

Effacer ferme le rapport et réaffiche le formulaire vide. Cette option est proposée à côté du bouton dans tous les états, de sorte qu’un rapport que vous avez fini de consulter ou un fichier refusé ne doit jamais rester affiché sur la page.

Conseil

Le fichier vérifié est conservé pendant quelques heures, vous n’avez donc pas besoin de le téléverser de nouveau lors de l’importation. Si vous revenez ultérieurement au rapport et que le fichier a expiré, téléversez-le de nouveau. Il est vérifié une nouvelle fois avant toute création.

Vous pouvez décocher la case Vérifier d’abord le fichier, sans l’importer pour lancer directement l’importation. Le bouton affiche alors Importer le fichier, de sorte que son libellé indique toujours l’action qui sera effectuée.

Une importation est entièrement réalisée ou entièrement annulée. Si une ligne ne peut pas être créée, rien n’est créé et le rapport répertorie tous les problèmes du fichier au lieu de s’arrêter au premier. Vous êtes enregistré comme auteur de chaque lot de travaux créé par l’importation, sauf si le fichier indique une autre personne dans la colonne Author.

Référence des colonnes

La ligne d’en-tête détermine ce qui est importé. L’ordre des colonnes est libre et seules les colonnes que vous souhaitez renseigner sont nécessaires. Un en-tête qui ne figure pas dans le tableau ci-dessous interrompt l’importation avant la lecture de la moindre ligne, tout comme un même attribut présent deux fois.

Colonne	Contenu	Obligatoire	Format et correspondance
Subject	Le nom du lot de travaux	Oui	Texte
Description	La description	Non	Texte. Une valeur contenant des sauts de ligne doit être placée entre guillemets.
Type	Tâche, Jalon, Phase, etc.	Non	Correspondance par nom, sans tenir compte de la casse. Le type doit être activé dans ce projet.
Status	Le statut	Non	Correspondance par nom, sans tenir compte de la casse. Le statut doit exister.
Priority	La priorité	Non	Correspondance par nom, sans tenir compte de la casse. La priorité doit exister et être active.
Category	La catégorie	Non	Correspondance par nom, sans tenir compte de la casse. La catégorie doit exister dans ce projet.
Version	La version	Non	Correspondance par nom, sans tenir compte de la casse. La version doit être ouverte et disponible dans ce projet. Une seule version est prise en charge dans la cellule.
Assignee	La personne assignée	Non	Correspondance avec l’adresse e-mail utilisée par l’utilisateur pour se connecter, sans tenir compte de la casse. L’utilisateur doit être autorisé à se voir attribuer des lots de travaux dans ce projet.
Accountable	Le responsable	Non	Correspondance effectuée de la même manière que pour Assignee.
Author	Personne ayant créé le lot de travaux	Non	Correspondance par adresse e-mail. Laissez la cellule vide ou omettez la colonne pour être enregistré comme auteur.
Start date	La date de début	Non	YYYY-MM-DD, par exemple 2026-03-17.
Finish date	La date de fin	Non	YYYY-MM-DD.
Work	Le travail estimé	Non	Heures sous forme de nombre, par exemple 8 ou 7.5, ou durée telle que 1h 30m.
Remaining work	Le travail restant à effectuer	Non	Saisi de la même manière que Work. Non disponible lorsque la progression est calculée à partir du statut.
% Complete	L’avancement	Non	Un nombre entier de 0 à 100, avec ou sans signe de pourcentage. Non disponible lorsque la progression est calculée à partir du statut.
Created on	Date de création du lot de travaux	Non	YYYY-MM-DDTHH:MM:SSZ, par exemple 2025-11-04T09:30:00Z. Ne doit pas être dans le futur.
Updated on	Date de dernière mise à jour	Non	YYYY-MM-DDTHH:MM:SSZ. Ne doit pas être dans le futur ni antérieure à Created on.

Une valeur qui ne peut pas être mise en correspondance est signalée avec le numéro de la ligne concernée, et le rapport répertorie les valeurs qui auraient été acceptées. Il est ainsi rapide de corriger un type ou un statut mal orthographié.

Les colonnes Created on et Updated on sont prévues pour les lots de travaux provenant d’un autre système et devant conserver leurs dates. La colonne Created on déplace également l’entrée de création dans l’activité du lot de travaux, de sorte qu’une comparaison avec la base de référence portant sur une période antérieure à l’importation se comporte comme elle l’aurait fait à ce moment-là.

Remarque

Les en-têtes de colonnes sont également acceptés dans la langue que vous utilisez dans OpenProject. Un fichier comportant des en-têtes allemands tels que Thema et Zugewiesen an est importé lorsque votre langue est l’allemand. Toutefois, la stabilité des traductions n’est pas garantie. Un fichier importé dans une version d’OpenProject peut donc ne plus être accepté dans une autre. Les en-têtes anglais du tableau ci-dessus fonctionnent toujours, quelle que soit la langue définie. C’est pourquoi le modèle téléchargeable les utilise.

Tout ce que le formulaire de lot de travaux refuserait est également refusé ici, ligne par ligne : un objet manquant, une date de fin antérieure à la date de début, ou un type dont le flux de travail ne comporte pas ce statut.

Une cellule vide signifie « non renseigné », et le lot de travaux est créé avec les valeurs que le projet et le type lui attribueraient. Il n’est pas possible d’indiquer « explicitement vide » dans un fichier CSV. Une valeur définie par défaut ne peut donc pas être effacée en laissant sa cellule vide.

Limites

Un fichier peut contenir jusqu’à 5000 lignes et avoir une taille maximale de 5 Mo par défaut. Répartissez une importation plus volumineuse entre plusieurs fichiers. La page d’importation indique les limites qui s’appliquent à votre instance.

Les deux limites sont configurables. La limite de taille du fichier est celle qui s’applique à toutes les pièces jointes, un administrateur peut donc la modifier sous Administration, Fichiers, Pièces jointes. La limite du nombre de lignes ne se trouve pas dans l’administration : elle est définie pour l’instance à l’aide de la variable d’environnement OPENPROJECT_WORK__PACKAGE__IMPORT__MAX__ROWS, ce qui nécessite un accès au serveur sur lequel l’instance s’exécute.

Éléments non importés

Une importation CSV crée des lots de travaux. À l’heure actuelle, elle n’effectue aucune des opérations suivantes.

• Modifier des lots de travaux existants : chaque ligne crée un nouveau lot de travaux. Il n’est pas possible de cibler un lot de travaux qui existe déjà.
• Créer des hiérarchies : les parents et les enfants doivent être définis après l’importation.
• Créer des relations : les prédécesseurs, les successeurs et les autres types de relations ne sont pas lus.
• Renseigner les champs personnalisés : seules les colonnes répertoriées ci-dessus sont acceptées.
• Définir des observateurs ou des pièces jointes :
• Lire des fichiers de tableur : enregistrez d’abord un fichier .xlsx ou .ods au format CSV.