Contrôle de version pour les solutions

Le contrôle de version améliore la collaboration en équipe, permettant à plusieurs utilisateurs d’afficher, de suivre et de restaurer différentes versions d’une solution à tout moment. Cela permet aux développeurs de créer et de tester des automatisations sans écraser le travail des autres.

Le contrôle de version dans Studio Web fonctionne différemment selon le type d'espace de travail :

1. Espaces de travail Cloud: le contrôle de version est géré via des instantanés dans le panneau Historique des modifications .
2. Espaces de travail locaux: le contrôle de version est géré via Git dans le panneau Contrôle de version .

Contrôle de version dans l’espace de travail Cloud

Le contrôle de version des solutions cloud est géré dans le panneau Historique des modifications via des instantanés. Vous pouvez considérer les instantanés comme des « points de contrôle » de la solution les différentes étapes de son développement. Les instantanés conservent l'ensemble de l'état de la solution, y compris ses projets d'automatisation, ses ressources et sa configuration de déploiement.

Il existe trois types d'instantanés :

1. Instantané automatiquement: la version actuelle d’une solution. Il apparaît comme Version actuelle en haut de la liste des instantanés dans le panneau Historique des modifications.
2. Instantanés manuels: instantanés créés manuellement par les utilisateurs. Ils ont un nom et une description facultative. La sélection ou le survol d'un instantané manuel affiche le nom de son auteur et la date de création. Ne peut être ouvert qu’en mode lecture seule.
3. Publier les instantanés: instantanés créés automatiquement chaque fois que la solution est publiée. Leur nom est la version publiée de la solution. Le survol d'un instantané publié affiche le nom de son auteur et la date à laquelle il a été créé. Ne peut être ouvert qu’en mode lecture seule.

Remarque : tous les instantanés, y compris les instantanés manuels, sont disponibles pour toute personne ayant accès à la solution.

Le panneau Historique des modifications répertorie tous les instantanés de manière chronologique, en affichant :

• Numéro de version et description (par exemple, « v1.1.0 - Formulaire de commentaires inclus).
• Auteur et horodatage (par exemple, « il y a 2 mois par John Doe »).
• Titre (par exemple, « Build stable avant de tester l'intégration NetSuite »).

Lorsque vous sélectionnez un instantané dans le panneau Historique des modifications, vous affichez la solution telle qu'elle existait à ce moment-là. Une bannière temporaire apparaît lorsque vous parcourez un instantané passé, vous informant que vous visualisez une version antérieure de la solution en mode lecture seule.

Pour créer un nouvel instantané manuel :

1. Ouvrez le panneau Historique des modifications. Assurez-vous que l'instantané Version actuelle est sélectionné.
2. Sélectionnez le bouton Créer un instantané dans le coin supérieur droit du panneau.
3. Saisissez un nom pour votre instantané.
4. Vous pouvez également appuyer sur la touche Tab ou sélectionner le champ Ajouter une description pour saisir une description.
5. Cliquez n'importe où dans Studio Web Designer ou appuyez sur la touche Entrée . Le nouvel instantané est créé et ajouté dans le panneau Historique des modifications.

L’une des principales fonctionnalités des instantanés est la possibilité de restaurer la solution à un moment donné. Par défaut, la restauration d’une solution à partir d’un instantané crée une copie du dernier instantané à des fins de référence. Cela garantit que vous ne perdez aucun travail que vous avez effectué sur la dernière version de la solution.

Pour accéder à la fonctionnalité de restauration :

1. Ouvrez le panneau Historique des modifications.
2. Sélectionnez un instantané manuel ou un instantané de publication.
3. Cliquez avec le bouton droit sur l'instantané.
4. Sélectionnez Restaurer l'intégralité de la solution. La fenêtre Restaurer l'instantané s'affiche.
5. Sous le champ Titre , saisissez un nom obligatoire pour la copie du dernier instantané.
6. Vous pouvez éventuellement saisir une description des mises à jour apportées à la solution.
7. Sélectionnez le bouton Restaurer . Une bannière apparaîtra pour vous informer que la solution a été restaurée avec succès à ce moment-là.
8. Vous pouvez également sélectionner Restaurer sans enregistrer pour ignorer la dernière version de la solution.

La sélection de Restaurer sans enregistrer restaure la solution sans enregistrer le dernier instantané. Cela signifie que la dernière version de votre solution est supprimée.

Remarque : actuellement, vous ne pouvez pas restaurer une solution partagée.

Contrôle de version dans l’espace de travail local

Studio Web peut s'intégrer à Git pour permettre un contrôle efficace des versions des solutions enregistrées localement sur votre machine.

Au préalable, assurez-vous que vous travaillez sur une solution enregistrée localement :

1. Ouvrez Studio Web.
2. Accédez à la page Espace de travail local .
3. Ouvrez une solution locale existante via le bouton Ouvrir la solution ou créez-en une nouvelle à partir du bouton Créer une nouvelle . Vous pouvez également sélectionner une solution existante dans la liste des solutions précédemment ouvertes.
4. Sélectionnez le dossier dans lequel une solution existante est enregistrée localement ou indiquez un dossier dans lequel les nouvelles solutions doivent être créées. Votre nouvelle solution locale s’ouvre.
   Important : lorsque vous y êtes invité par votre navigateur, autorisez Studio Web à modifier les fichiers.
5. Ouvrez le panneau de contrôle Version .

La première fois que vous ouvrez le panneau, vous êtes invité à initialiser un référentiel Git local. Cette étape est obligatoire et est effectuée automatiquement en sélectionnant le bouton Initialiser le référentiel . Lorsque vous initialisez un référentiel Git local, Studio Web :

• Crée un fichier .gitignore .msg.
• Effectue une validation initiale avec les fichiers actuels dans la solution.
• Crée une branche locale nommée « master ».

Création et gestion de branches

Sélectionnez le nom de la branche dans le coin supérieur gauche du panneau Contrôle de version pour :

1. Créez une nouvelle branche à partir du bouton Créer une nouvelle branche . Saisissez le nom de la branche, puis sélectionnez Créer. La branche est ajoutée à la liste des branches disponibles.
2. Changez de branche en sélectionnant un nom de branche dans la liste sous Branches locales. La solution se recharge lorsque vous changez de branche.

Valider et transmettre les modifications

Lorsque vous travaillez sur une solution, les modifications que vous apportez sont enregistrées sous Modifications dans le panneau Contrôle de version . Sélectionnez chaque modification dans la liste pour afficher une vue côte à côte des modifications. Les modifications sont mises en évidence comme suit :

• En vert et l'icône + indiquent que quelque chose a été ajouté à un fichier de projet.
• Orange et l'icône / indiquent que le fichier a été modifié.
• Le rouge et l'icône - indiquent que quelque chose a été supprimé d'un fichier de projet.

Pour valider les modifications apportées à votre solution et les transmettre à la branche sur laquelle vous vous trouvez actuellement :

1. Sélectionnez le bouton Valider dans le panneau Contrôle de version .
2. Saisissez un message de validation. Les modifications incluses dans la validation sont affichées sous la section Modifications .
3. Sélectionnez Valider. Votre nouvelle validation s'affiche dans la section Historique des validations .

Afficher l'historique de validation

La section Historique des validations contient toutes vos validations dans l'ordre chronologique à partir de la validation initiale. Chaque validation affiche des informations sur son auteur et la date à laquelle il a été créé.

Sélectionnez une validation dans la liste et consultez la section Modifications pour cette validation spécifique.

Cliquez avec le bouton droit sur une validation et sélectionnez :

• Créez une branche à partir de cette validation pour créer une nouvelle branche locale à partir de cette validation. Donnez un nom à la nouvelle branche et sélectionnez Créer. La nouvelle branche est maintenant active et apparaît dans la liste des branches disponibles.
• Réinitialisez la branche locale à cette validation pour restaurer la branche actuelle à l'état qu'elle était lors de la création de la validation. Les validations plus récentes que cette validation sont automatiquement supprimées de l' historique de validation.