Contrôle de version pour les solutions

Activez et utilisez le contrôle de version pour les solutions dans Studio Web afin de suivre, de restaurer et de collaborer sur des versions de solutions sans écraser le travail des membres de l'équipe.

Le contrôle des versions améliore la collaboration des équipes, 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 :

• Cloud Workspace: version control is managed via snapshots in the Change history panel.
• Local Workspace: version control is managed via Git in the Version control panel.

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

Version control for solutions is handled within the Change history panel through snapshots. You can think of snapshots as "checkpoints" of the solution at various stages in its development. Snapshots preserve the entire solution state, including its automation projects, resources, and deployment configuration.

Types d’instantanés

Il existe plusieurs types d'instantanés :

• Current version: The current (latest) version of a solution. It appears at the top of the list of snapshots in the Change history panel.
• Instantanés manuels: instantanés créés manuellement par les utilisateurs. Elles ont un nom et une description facultative. Le fait de sélectionner ou de pointer vers un instantané manuel affiche le nom de son auteur et la date de sa création. Ne peut être ouvert qu’en mode lecture seule.
• Instantanés automatiques: instantanés créés automatiquement lorsque vous fermez la solution et toutes les 40 minutes lorsque la solution est ouverte. Les instantanés automatiques ont des noms basés sur l'horodatage (par exemple, « Instantané automatique - 2026-03-14 10:40 UTC »).
• 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 fait de pointer vers un instantané de publication affiche le nom de son auteur et la date de sa création. 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.

Les instantanés automatiques ont des limites de rétention en fonction des droits de votre organisation et peuvent varier en fonction du plan de licence :

• Limite par solution: chaque solution conserve un nombre maximal d'instantanés automatiques. Lorsque cette limite est atteinte, les instantanés les plus anciens sont automatiquement supprimés lorsque de nouveaux sont ajoutés.
• Limite temporelle: les instantanés automatiques antérieurs à une période de rétention configurée sont automatiquement supprimés.

Panneau Historique des modifications

The Change history panel lists all snapshots chronologically, showing their:

• 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 »).

You can use the Filter button to control which types of snapshots appear in the Change history panel.

Lorsque vous sélectionnez un instantané dans le panneau, 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.

Création d'un instantané

Pour créer un nouvel instantané manuel :

1. Ouvrez le panneau Historique des modifications . Assurez-vous que l'option Instantané de la version actuelle est sélectionnée.
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. Select anywhere in the designer or press the Enter key. The new snapshot is created and is added in the Change history panel.

Restauration à partir d'un instantané

One of the main features of snapshots is the ability to restore the solution to a particular point in time. By default, restoring a solution from a snapshot creates a copy of the latest snapshot (that is, Current version) for reference. This ensures that you do not lose any work that you did on the latest version of the solution. You can't restore a snapshot while other people are editing the solution.

Pour restaurer une solution à partir d'un instantané:

1. Ouvrez le panneau Historique des modifications .
2. Point to a manual, auto, or publish snapshot.
3. Sélectionnez le bouton Restaurer . La fenêtre Restaurer l'instantané s'affiche.
4. Sous le champ Titre , saisissez un nom obligatoire pour la copie du dernier instantané.
5. Vous pouvez éventuellement saisir une description des mises à jour apportées à la solution.
6. 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à.

To restore without saving the latest snapshot (the Current version snapshot), turn off the Create a snapshot of the current version toggle in the Restore snapshot window, and then select Restore. In the Discard current snapshot window, select Discard and restore to confirm. The latest version of your solution is deleted.

FAQ

Les instantanés automatiques affectent-ils les performances ?

Non. Les instantanés automatiques sont créés en arrière-plan et ne bloquent pas ou ne ralentissent pas votre travail dans le concepteur.

Puis-je supprimer des instantanés automatiques individuels ?

Non. Les instantanés automatiques sont gérés automatiquement par Studio Web et ne peuvent pas être supprimés individuellement. Les anciens instantanés automatiques sont automatiquement supprimés en fonction de la stratégie de rétention.

Les instantanés automatiques sont-ils pris en compte dans mon stockage ?

Oui. Les instantanés automatiques utilisent le stockage cloud. Les limites de rétention garantissent que l'utilisation du stockage reste limitée.

Les instantanés automatiques sont-ils visibles pour tous ceux qui ont accès à la solution ?

Oui. Comme tous les instantanés, les instantanés automatiques sont disponibles pour toute personne ayant accès à la solution.

Que se passe-t-il des instantanés automatiques sur les solutions partagées ?

Les solutions partagées suivent la même politique d’instantané automatique que les solutions propriétaires. Des instantanés automatiques sont créés pour tout utilisateur qui ouvre et travaille sur la solution, et tous les instantanés sont visibles par toute personne y ayant accès.

Puis-je créer des instantanés automatiques pour les solutions locales ?

Non. Les instantanés automatiques ne sont disponibles que pour les solutions cloud.

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.

As a prerequisite, make sure you are working on a locally saved solution:

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. Select the folder where an existing solution is saved locally or indicate a folder where the new solution is created. Your new local solution opens.
   Important :

   Lorsque vous y êtes invité par votre navigateur, autorisez Studio Web à modifier les fichiers.

5. Open the Version control panel.

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 .
• Effectue une validation initiale avec les fichiers actuels dans la solution.
• Creates a local branch named main.

Remarque :

Le nom de la branche main s'applique uniquement aux référentiels initialisés via Studio Web. Si vous vous connectez à un référentiel existant (créé manuellement ou cloné à distance), Studio Web utilise la branche par défaut existante de ce référentiel. Vous pouvez renommer n'importe quelle branche locale manuellement à tout moment.

Git version control can be enabled or disabled from a dedicated toggle in the Version control panel header. You can have version control enabled for some solutions and disabled for others. If you initialize a new repository, version control is enabled automatically.

.gitignore

Lorsque vous initialisez un référentiel Git local, Studio Web crée automatiquement un fichier .gitignore avec les entrées suivantes:

Fichier	Description
.agent-builder	Artefact d’agent groupé temporaire.
.DS_Store	Fichier de métadonnées de recherche macOS; ne fait pas partie du code source.
*_UiCache.zip	Archive de cache de l’interface utilisateur générée; sortie temporaire.
**/.local	Cache local et répertoires de données temporaires à n’importe quelle profondeur.
*.crswap	Fichiers d'échange temporaire créés lors de la récupération après plantage.
**/.entities/EntitiesBundle.*.zip	Archive de bundle des entités générées.
remote-repository.config.json	Configuration locale de Studio Web pour les connexions au référentiel distant.
.sw-path-marker	Fichier de marqueur Studio Web pour le suivi du chemin de l'espace de travail.
venv/	Répertoire d’environnement virtuel Python.
.venv/	Répertoire d’environnement virtuel Python alternatif.
__pycache__/	Répertoire de cache du code sous-code Python.

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 :

• Créez une nouvelle branche à partir du bouton Créer une nouvelle branche . Entrez le nom de la branche, puis sélectionnez Créer. La branche est ajoutée à la liste des branches disponibles. Si le nom correspond à une branche existante, une erreur en ligne s'affiche dans le champ et la branche n'est pas créée.
• Changez de branche en sélectionnant un nom de branche dans la liste sous Branches locales ou Branches distantes.

Les branches sont regroupées sous des branches locales et des branches distantes.

Changement de branche locale: Studio Web conserve toutes les modifications non validées qui ne sont pas affectées par le changement de branche.

Si un fichier contient des modifications non validées qui sont en conflit avec la branche cible, une boîte de dialogue de confirmation apparaît, vous demandant s’il faut ignorer ces modifications et continuer. Le refus de la boîte de dialogue annule le commutateur et vos modifications ne sont pas affectées.

Un fichier que vous avez supprimé localement reste supprimé après le changement et apparaît toujours sous Modifications en tant que suppression que vous pouvez abandonner. La solution se recharge pour prendre en compte la nouvelle branche.

Basculer vers une branche distante: lorsque vous basculez vers une branche distante suivie, Studio Web vérifie si votre branche locale a dérivé depuis la branche distante:

• Si votre branche locale est à jour ou peut effectuer des opérations propres, le changement se produit immédiatement sans confirmation requise.
• Si le commutateur ignore les validations locales non poussées ou les modifications non validées, une boîte de dialogue de confirmation s'affiche avant que le basculement ne se produise.

Lorsqu'un basculement ou un retour de branche est en cours, le panneau de contrôle Version est temporairement désactivé et affiche le nom de la branche en cours de basculement. Cela empêche d'autres actions, telles que la validation ou la transmission, de s'exécuter jusqu'à ce que le commutateur soit terminé.

Connexion à un référentiel distant

Pour connecter votre référentiel local existant à un référentiel distant :

1. Sélectionnez l’icône des options dans le coin supérieur droit du panneau Contrôle de version .
2. Sélectionnez le bouton Connect to GitHub . La fenêtre d'authentification GitHub apparaît.
3. Authentifiez-vous auprès de GitHub à l'aide du connecteur GitHub Integration Service.
4. Après vous être authentifié avec succès, saisissez l’URL de votre référentiel distant dans le champ URL du référentiel .
5. Sélectionnez le bouton Enregistrer la configuration .
6. Vous pouvez également sélectionner Retour pour revenir au panneau de contrôle de la Version .

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é.
• Red and the - icon indicate that something has been removed from a project file.

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 l'une des options suivantes :
   • Commit to commit your changes without pushing them. Your new commit appears in the Commit history section.
   • Commit & Push to commit your changes and push them to the current branch in the configured remote repository. This option is available only after you connect to a remote repository.

To push commits that you made earlier, select the Push button next to the Commit button in the Version control panel.

If the remote branch has commits that you don't have locally, the push is rejected and the Push rejected window appears. Select Force push to push your local commits anyway.

Important :

Forcer la transmission écrase l'historique de validation du référentiel distant par votre historique local, en contournant les vérifications de sécurité habituelles de Git:

• Réécrit l'historique distant: cette option remplace les validations sur la branche distante par vos validations locales.
• Ignorer les validations: toutes les validations sur le distant qui ne se trouvent pas dans votre branche locale sont supprimées du distant.
• Met à jour le pointeur de la branche: pointe plutôt la branche distante vers votre validation locale.

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éé.

Select a commit from the list to see the Changes section for that particular commit.

Ouvrez le menu contextuel d'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.