Dépôt pour le contrôle du code source

Le dépôt est défini comme un système de gestion de documents qui permet aux utilisateurs de gérer des fichiers et des dossiers via un système de contrôle de version (SVN ou Git).

Remarque : les dépôts ne sont actuellement disponibles que pour les installations sur site basées sur des paquets. Afin d’utiliser la fonctionnalité de dépôt, veuillez vous assurer que le module de dépôt est activé dans les paramètres du projet.

Vue du navigateur du dépôt

Une partie importante du travail sur un projet en tant qu’équipe est le partage de fichiers et de code source. Garder une trace des dernières versions peut parfois être un défi. Par conséquent, OpenProject fournit deux types de systèmes de contrôle de version (Git et Subversion) qui, après avoir été correctement configurés, peuvent être utilisés pour stocker des données pertinentes dans les différents projets.

Dans OpenProject, vous pouvez voir les fichiers sous Dépôt. Gardez à l’esprit que depuis votre site Web OpenProject, vous ne pouvez voir ou télécharger que les fichiers. Pour valider de nouveaux fichiers, vous avez besoin d’un client SVN ou Git.

Pour pouvoir éditer des fichiers et télécharger les versions mises à jour dans le dépôt, vous devez vérifier votre dépôt. Les étapes suivantes supposent que vous avez configuré votre dépôt OpenProject pour qu’il fonctionne avec subversion (mais beaucoup d’options sont très similaires ou identiques lors de l’utilisation de Git). Veuillez vérifier le dépôt et l’enregistrer localement via un client SVN de votre choix.

User-guide_repository

Sous la liste des fichiers, vous pouvez voir les dernières révisions et les commentaires des modifications. Si vous sélectionnez un fichier spécifique, vous verrez la liste de ses révisions.

Vous pouvez créer une comparaison de deux versions pour voir les modifications apportées pour des fichiers spécifiques. Gardez à l’esprit que cette option de comparaison est disponible pour les fichiers simples, donc un fichier spécifique doit être sélectionné, pas un dossier. Astuce : la comparaison ne fonctionne que pour les fichiers texte brut (par exemple, xml, yaml, json, html, etc.) et pas pour les fichiers binaires (pdf, ppt, doc, images, fichiers audio ou archives, etc.).

User-guide-repository3

Travailler avec un client SVN ou Git

Les données contenues dans un dépôt de projet peuvent être téléchargées sur votre ordinateur en utilisant l’un des plusieurs clients, par exemple Tortoise SVN pour Subversion, et le client git ou l’un des clients GUI recommandés pour Git.

Les spécificités du fonctionnement du client de contrôle de version sélectionné peuvent varier. Veuillez vous référer à la documentation de votre logiciel de contrôle de version pour obtenir plus d’informations. Si vous choisissez d’utiliser Tortoise SVN, vous trouverez un bon guide ici. Pour Git, nous recommandons le guide Pro Git.

Référencement des lots de travaux

Dans le message de validation, vous pouvez référencer un ID de lot de travaux (par exemple : #1234). Dans les paramètres du dépôt (Administration -> Paramètres système -> Référentiel), vous pouvez définir des mots-clés qui changent l’état du lot de travaux référencé (p. ex., correctifs #1234 ou fermetures #1234).

Dans n’importe quel champ Textile, vous pouvez référencer les révisions en plaçant un “r” devant le numéro de révision (par exemple : r123).

Configurer les dépôts dans OpenProject

Veuillez consulter notre guide d’administration système comment configurer les dépôts dans OpenProject.

Intégration du dépôt

Consultez notre guide d’installation et d’opérations pour savoir comment intégrer des dépôts dans OpenProject.