> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/web/containers/user-guides-for-browser-side-platform/container/branches.md).

# Branches

## Présentation de la nouvelle fonctionnalité « Branches »

Prêt à passer à la vitesse supérieure avec votre expérience TMS ? Nous sommes ravis de vous présenter notre dernière fonctionnalité : **Branches**. Cet outil puissant est conçu pour améliorer l’efficacité de votre équipe en permettant à plusieurs utilisateurs de travailler simultanément sur un même projet sans se gêner. Imaginez un espace de travail où vous pouvez modifier des éléments en toute confiance, les tester de manière isolée et les fusionner facilement, tout en préservant votre projet Main. Découvrons ensemble pourquoi cette fonctionnalité change la donne.

## Qu’est-ce que « Branches » ?

Les Branches vous permettent de créer un environnement de travail distinct et cloisonné, un espace sécurisé où vous travaillez de votre côté. Vous pouvez apporter des modifications sans craindre de ralentir le travail de vos collègues. Lorsque vous êtes prêt, il vous suffit de fusionner votre travail dans le projet Main en toute confiance, sachant que tout est parfaitement cohérent.

### **Principaux avantages**

* **Travaillez de manière indépendante :** Fini d’attendre que vos collègues terminent leurs tâches. Avec Branches, chacun peut contribuer simultanément sans conflit.
* **Réduisez les erreurs :** En isolant les modifications, vous évitez que des éléments inachevés soient déployés en production. Testez et validez vos modifications dans un environnement sécurisé avant de les fusionner.
* **Fusion simplifiée :** Notre interface intuitive facilite les fusions. Consultez les modifications côte à côte grâce à notre outil de comparaison, pour vous assurer que rien ne passe entre les mailles du filet.

### :heart: Pourquoi vous allez adorer Branches :heart:

**Dites adieu aux interruptions dans votre workflow !**

Auparavant, lorsque deux utilisateurs travaillaient sur le même compte, leurs modifications se chevauchaient, ce qui pouvait entraîner des conflits lors de la génération du container. Cela provoquait souvent des erreurs qui retardaient le processus de déploiement ou, pire encore, la mise en ligne de travaux inachevés. Avec Branches, votre workflow sera plus fluide et mieux maîtrisé. Votre équipe peut désormais se concentrer sur ce qu’elle fait le mieux, sans avoir à gérer des modifications conflictuelles.

### **Une expérience utilisateur fluide**

* **Indicateurs visuels :** Vous savez facilement dans quel environnement vous vous trouvez. Lorsque vous travaillez sur le Main (votre container web réel), tous les éléments du menu sont rouge cerise.\
  Passez à une Branch et tout devient bleu, indiquant que vous êtes dans un espace sécurisé pour apporter des modifications.
* **Création de Branch en toute simplicité :** Que vous commenciez un nouveau projet ou non, créer une Branch ne prend qu’un clic. Notre panneau intuitif vous guide tout au long du processus, du choix du nom de votre Branch jusqu’à l’édition.
* **Notifications en temps réel :** Restez informé des modifications apportées au Main pendant que vous travaillez sur une Branch. Vous recevrez une notification vous proposant de mettre à jour votre Branch ou de poursuivre votre travail : vous gardez ainsi le contrôle à tout moment.

### Glossaire

* **Main :** votre container habituel, considéré comme le « parent » dans le contexte d’une Branch
* **Branch :** une duplication de votre Main qui vous permet de travailler sans modifier la configuration de votre Main
* **Fusion :** action qui consiste à rendre les modifications de votre Branch actives dans votre container Main

## Comment cela fonctionne-t-il ?

### **Création d’une Branch**

Pour ouvrir l’interface de création d’une Branch, utilisez le bouton du fil d’Ariane (qui indique « Main » lorsque vous êtes dans votre container habituel, ou le nom de la Branch si vous vous trouvez dans une Branch).\
La liste de vos Branches s’affiche. Cliquez sur « Create new branch ».\
Il vous suffit de définir un nom pour la Branch. Vous pouvez également ajouter une description si nécessaire.\
Vous pouvez créer jusqu’à 5 Branches par container !

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-3cb42a1be532147c914394335276629182dacd25%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-38e1a9ec8cb30cd195b0455fd39351438d2a4263%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-3a2a16a70206085831375ea3cc1ea90dbb698209%2FCapture%20d'%C3%A9cran%202024-11-21%20180202.jpg?alt=media" alt=""><figcaption></figcaption></figure>

Après l’enregistrement, vous serez redirigé vers votre nouvel environnement Branch.

Une fois votre Branch créée, toutes les modifications que vous apportez sont isolées dans cet environnement. La couleur bleue des éléments de navigation indique que vous êtes dans une Branch.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-d86855f2d008467e611f30a0da8fb2c04dbfe778%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Vous pouvez modifier n’importe quel élément comme dans un container normal.

{% hint style="warning" %}
**Limites**

-Les règles ne peuvent pas être supprimées définitivement dans une Branch ; seule l’action « Archive » est possible.\
-Les anciens formats d’événements (tc\_events obsolète) ne peuvent pas être supprimés dans une Branch

Soyez prudent lorsque vous modifiez votre WebDatalayer : cela peut avoir un impact sur l’ensemble de votre site.

Si vous créez une internalvar dans votre Branch, vous devez également la lier au Main, car les internalvars ne sont pas fusionnées.
{% endhint %}

### **Comparaison de la Branch avec le Main**

Vous pouvez à tout moment avoir une vue claire du travail effectué dans chaque Branch.\
Cliquez simplement sur le lien « See changes ».

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-b3509146a8cecbdb2e3ce2ec451ba21c1241edd1%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

La fenêtre modale « Comparison » s’affiche :

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-29f365465964004f05ffc6faf0be04e0c6d572d5%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Vous pouvez déplier les éléments pour en afficher les détails.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-ca69e15a3fc59cd8b7342122ca1f40aa1664b6c9%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### **Modification d’une Branch existante**

Pour accéder à une Branch existante, cliquez sur l’icône en forme de crayon.\
**Cette fenêtre modale permet également de revenir à votre container Main.**

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-f7f35a734caf495cb92bdddbaae45d065dda7567%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Modifiez les éléments comme dans un container habituel.

### Mise à jour d’une Branch

Si votre Branch n’est pas à jour par rapport aux dernières modifications du Main, vous verrez ce message d’avertissement vous invitant à mettre à jour votre Branch.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-432e72d841a3b262df5fc93e51cd0823ef97c3d2%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Lorsque vous cliquez, la fenêtre modale « Update » s’affiche avec un outil de comparaison.\
Vous pouvez conserver ou ignorer les modifications.\
Les éléments cochés seront intégrés à votre Branch.\
Si vous ne souhaitez pas mettre à jour votre Branch tout de suite, cliquez sur Cancel.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-ee394f25bcfb6ed966f998a1d012521c886594b4%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Soyez prudent avec les éléments portant le libellé « conflict ».\
Cela signifie qu’une ou plusieurs modifications ont été apportées à la fois au Main et à la Branch.

Par défaut, elles ne sont pas cochées. Prenez le temps de comparer et de choisir si vous souhaitez conserver la modification de la branche ou celle de la branche principale.
{% endhint %}

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-ddb959187ed1c276ea2c51ba029be84149f5f8b1%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Nous vous recommandons d’intégrer toutes les modifications de la branche principale à votre branche. Si vous choisissez de ne pas mettre à jour certains éléments, cela peut avoir un impact sur le conteneur principal lors de la fusion.
{% endhint %}

### QA et tests de la branche

Vous pouvez générer votre branche comme un conteneur classique.

Une fois votre branche fusionnée, vous pouvez effectuer votre contrôle qualité de deux façons : déployer votre branche dans votre environnement UAT ou utiliser notre extension Chrome « Commanders Act Tag Assistant ».

#### Tester dans votre environnement UAT

Lorsque vous êtes prêt, déployez vos modifications dans votre environnement UAT afin de vérifier que tout fonctionne parfaitement avant la fusion.

Les conteneurs de branche présentent une différence importante au moment du déploiement : le déploiement en environnement de production n’est pas autorisé.\
C’est pourquoi, dans le contexte d’une branche, l’étape de déploiement est renommée « QA - Merge » !

L’option de déploiement UAT déploie la version de votre branche sur l’URL UAT du conteneur principal.

Cela signifie que vous pouvez tester votre branche directement sur votre site UAT sans intervention de l’équipe informatique.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-89cfe2af7a9c7e7de696e1888ea908d8c313fdd1%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Tester avec notre extension

Notre Commanders Act Assistant est compatible avec les branches !

Téléchargez-le depuis le Chrome Web Store. Une fois installé dans votre navigateur, vous pouvez utiliser le bouton « preview » pour tester votre branche sur votre site web.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-53393ce4e26b52771c535711bacfd3326d1f2a9e%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-e2ceae9e6da2668728a2d97108955158192b52e7%2Fimage.png?alt=media" alt="" width="488"><figcaption></figcaption></figure>

Pour consulter la documentation détaillée de notre extension, veuillez [lire la page suivante](https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/web/containers/user-guides-for-browser-side-platform/container/plugin-commanders-act-assistant.md)

### Fusionner une branche

Prêt à intégrer les modifications de votre branche à la branche principale ? Utilisez notre fonctionnalité « Merge » pour examiner les différences, consulter une comparaison détaillée et effectuer la fusion en toute simplicité.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-b3160b0f4c3809847d49ba3ec03da673ee2b790c%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
La fusion ne tient pas compte des versions générées. L’interface de fusion affiche toujours les dernières mises à jour de votre branche.
{% endhint %}

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-2cb83c937b8e5911980c5611ad99c54d320b4b46%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Si votre branche n’est pas à jour, la fusion sera bloquée.
{% endhint %}

Prenez le temps de mettre à jour votre branche dès maintenant avec les dernières modifications de la branche principale !

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-66e844799fe02dc9e1192c338a189fa2f4f6e4f5%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Après la fusion

Une fois votre branche fusionnée, **elle sera supprimée** et vous serez redirigé vers votre branche principale

Toutes les modifications issues des branches sont désormais consignées dans votre branche principale avec le préfixe \[Branch\*]

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-5e961d75443b8568ae2c87721c4726bc8ab243c4%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Après la fusion, vous pouvez à tout moment consulter l’historique de toutes les modifications de la branche fusionnée dans l’historique des modifications de votre branche principale.

{% hint style="success" %}
N’oubliez pas de générer à nouveau votre conteneur principal pour déployer vos modifications en production !
{% endhint %}

## Droits utilisateur personnalisés

Les rôles natifs « Administrator », « Technical » et « Marketing » sont autorisés à créer, modifier et fusionner des branches.

Pour gérer ces droits d’accès de manière plus précise, vous pouvez utiliser les droits dédiés dans Gestion des profils, Profil personnalisé.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-298b427be7cf68b50f8dd3ec6c947c673b43fb9a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Et ensuite

**Préparez votre workflow pour l’avenir**

Bien que le déploiement direct en production depuis une branche ne soit pas disponible, notre nouveau plugin QA (actuellement en cours de développement) vous offrira une autre façon de tester vos branches, y compris dans un environnement de production.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/web/containers/user-guides-for-browser-side-platform/container/branches.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
