# Branches

## Présentation de la nouvelle fonctionnalité "Branches"

Êtes-vous prêt à faire passer votre expérience TMS au niveau supérieur ? 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 le même projet sans empiéter sur le travail des autres. Imaginez un espace de travail où vous pouvez apporter des modifications en toute confiance, les tester de manière isolée et les fusionner de façon fluide — tout en gardant votre projet Main intact. Découvrons ensemble ce qui fait de cette fonctionnalité un véritable atout.

## Qu’est-ce que "Branches" ?

Branches vous permet de créer un environnement de travail séparé et partitionné — un espace sûr où votre travail vous appartient. Vous pouvez apporter des modifications sans craindre de perturber l’avancement de vos collègues. Quand vous êtes prêt, il vous suffit de fusionner votre travail dans le projet Main en toute confiance, en sachant que tout s’aligne parfaitement.

### **Principaux avantages**

* **Travailler de manière autonome :** Plus besoin d’attendre que vos collègues terminent leurs tâches. Avec Branches, chacun peut contribuer simultanément sans conflit.
* **Réduire les erreurs :** En isolant les modifications, vous pouvez éviter que le redouté « travail inachevé » soit déployé en production. Testez et validez vos changements dans un environnement sécurisé avant de les fusionner.
* **Fusion simplifiée :** Notre interface intuitive rend la fusion très simple. Visualisez les modifications côte à côte avec notre comparateur de diff, afin que rien ne passe entre les mailles du filet.

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

**Dites adieu aux interruptions de flux de travail !**

Auparavant, si 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 bloquaient le processus de déploiement, ou pire encore — du travail inachevé mis en ligne. Avec Branches, vous bénéficierez d’un flux de travail plus fluide et mieux maîtrisé. Votre équipe peut désormais se concentrer sur ce qu’elle fait de mieux, sans la contrainte de gérer des modifications conflictuelles.

### **Une User Experience fluide**

* **Indicateurs visuels :** Il est facile de savoir où vous vous trouvez. Lorsque vous travaillez sur le Main (votre web container réel), tous les éléments du menu sont rouge cerise.\
  Passez sur une Branch, et tout devient bleu, indiquant que vous êtes dans une zone sûre pour effectuer des modifications.
* **Création de Branch sans effort :** Que vous démarriez un nouveau projet ou que vous en créiez un nouveau, une Branch est à portée de clic. Notre panneau intuitif vous guide tout au long du processus, du nommage de votre Branch jusqu’à l’édition immédiate.
* **Notifications en temps réel :** Restez informé de toute modification apportée au Main pendant que vous travaillez sur une Branch. Vous recevrez une invite proposant de mettre à jour votre Branch ou de continuer à travailler — pour garder le contrôle à tout moment.

### Glossaire

* **Main :** votre container habituel, considéré comme "parent" dans le contexte d’une Branch
* **Branch :** une duplication de votre Main pour travailler sans impacter la configuration de votre Main
* **Merge :** action consistant à intégrer les modifications de votre Branch en ligne dans votre container Main

## Comment ça marche ?

### **Création de Branch**

Pour ouvrir l’interface de création de Branch, utilisez le bouton dans le menu fil d’Ariane (identifié comme "Main" lorsque vous êtes sur votre container habituel, ou par le nom de la Branch si vous êtes dans le contexte Branch).\
La liste de vos branches s’affichera. Cliquez sur "Create new branch".\
Définissez simplement un nom de Branch, vous pouvez aussi ajouter une description si nécessaire,\
Vous pouvez créer jusqu’à 5 Branches pour chaque container !

<figure><img src="/files/eeb88d132d1c1cde840ca56ae1555b1221900457" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/37a8752cab4ee517c3cd14664c7fbb799f0778e9" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/8aa63a989ae1d14b851bbfcdaee35feaf0300a76" alt=""><figcaption></figcaption></figure>

À 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 montre que vous êtes dans une Branch.

<figure><img src="/files/fe61553cfc8a44fdefdd6b9367e4f082d0644af7" alt=""><figcaption></figcaption></figure>

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

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

-Les Rules 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ètes) ne peuvent pas être supprimés dans une Branch

Faites attention à vos modification(s) du WebDatalayer, cela peut impacter 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 Branch avec le Main**

À tout moment, vous pouvez avoir une vue claire du travail effectué sur chaque Branch.\
Cliquez simplement sur le lien "See changes"

<figure><img src="/files/3d90fc18cbd32aa60d547beefe49daa0ac73c89a" alt=""><figcaption></figcaption></figure>

La fenêtre contextuelle "Comparison" s’affichera :

<figure><img src="/files/bf6b2097a487053a8dff16ec4158f2b84d4d4fb9" alt=""><figcaption></figcaption></figure>

Vous pouvez déplier les éléments pour obtenir des détails

<figure><img src="/files/c46223956d1bbc0361d3773436c18a704c4fd785" alt=""><figcaption></figcaption></figure>

### **Édition d’une Branch existante**

Pour accéder à une Branch existante, cliquez sur l’icône "pen".\
**Cette fenêtre contextuelle est également utile pour revenir à votre container Main.**

<figure><img src="/files/b707025c25b925f424f6ee868788f4cb889db44b" alt=""><figcaption></figcaption></figure>

Modifier tout élément comme si vous étiez dans un container classique.

### Mise à jour de Branch

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

<figure><img src="/files/2039199e7edbce6fd647e5066b549b032b0a02ce" alt=""><figcaption></figcaption></figure>

Au clic, la fenêtre contextuelle "Update" s’affichera, avec un comparateur de diff.\
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 maintenant, cliquez sur cancel.

<figure><img src="/files/42ba223bbe72f7e352a485334d4e5e5d6af9f269" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Faites attention aux éléments portant le libellé "conflict"\
Cela signifie qu’il y a des modification(s) à la fois sur le Main et sur la Branch

Par défaut, ils ne sont pas cochés. Prenez le temps de comparer et choisissez si vous souhaitez conserver la modification de la Branch ou celle du Main
{% endhint %}

<figure><img src="/files/5a0d8528bfc5afe5db5972a6c4f0fbf91e700340" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Nous vous recommandons d’intégrer toutes les modifications du Main dans votre Branch. Si vous refusez de mettre à jour certains éléments, cela peut impacter le container Main lors de la fusion.
{% endhint %}

### QA & test de Branch

Vous pouvez générer votre Branch comme un container normal.

Une fois votre Branch fusionnée, vous pouvez effectuer votre assurance qualité de 2 façons différentes : déployer votre Branch dans votre environnement UAT, ou utiliser notre extension Chrome "Commanders Act Tag Assistant"

#### Tester sur votre environnement UAT

Quand vous êtes prêt, déployez vos modifications dans votre environnement UAT, en vous assurant que tout fonctionne parfaitement avant la fusion.

Il existe une différence principale pour les containers Branch à l’étape de déploiement : le déploiement sur l’environnement Production n’est pas autorisé.\
C’est pourquoi l’étape de déploiement a été renommée "QA - Merge" dans le contexte Branch !

L’option de déploiement UAT enverra la version de votre Branch sur l’URL UAT du container Main.

Cela signifie que vous pouvez tester votre Branch directement sur votre site UAT sans intervention IT.

<figure><img src="/files/e2072d260d6551b82dd89c972ca8ac75b9e67c08" alt=""><figcaption></figcaption></figure>

#### Tester avec notre plugin

Notre Commanders Act Assistant est compatible avec Branches !

Téléchargez-le depuis le Chrome Extension Store ; une fois installé dans votre navigateur, vous pouvez utiliser le bouton "preview" pour tester votre Branch sur votre site web.

<figure><img src="/files/7bc862087baa2a67272418334dd9e522dc42a981" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/b62a3aa541876775f694ef84e441333302a91db1" alt="" width="488"><figcaption></figcaption></figure>

Pour une documentation détaillée sur notre plugin, veuillez [lire la page suivante](/fr/fonctionnalites/sources/sources-catalog/web/containers/user-guides-for-browser-side-platform/container/plugin-commanders-act-assistant.md)

### Fusionner la Branch

Prêt à intégrer vos modifications de la Branch dans le Main ? Utilisez notre fonctionnalité “Merge”, où vous pouvez examiner les différences, voir une comparaison détaillée et effectuer la fusion sans effort.

<figure><img src="/files/be3c1f380839e042ed152196337d985897383296" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Merge ne prend pas en compte les versions de génération. L’interface de fusion affichera toujours les dernières mises à jour de votre Branch
{% endhint %}

<figure><img src="/files/9a4263947a7536f8a4d7b7bdc70aaea12c5cc7e1" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Si votre Branch n’est pas à jour, Merge sera bloqué.
{% endhint %}

Prenez le temps de mettre à jour votre Branch maintenant avec les dernières modifications du Main !

<figure><img src="/files/f99b8808109b5f3bc1aee4c852a1b91e7e859f8e" alt=""><figcaption></figcaption></figure>

### Après la fusion

Une fois que vous avez fusionné votre Branch, **la Branch sera supprimée** et vous serez redirigé vers votre Main

Toutes les modifications provenant des Branches sont désormais consignées dans votre Main avec le préfixe \[Branch\*]

<figure><img src="/files/d3b3ed1c6441cb10cc8f26610933677e08580732" alt=""><figcaption></figcaption></figure>

À tout moment après la fusion, vous pouvez consulter tous les journaux de modifications de la Branch fusionnée dans l’historique des modifications de votre Main.

{% hint style="success" %}
N’oubliez pas de régénérer votre container Main pour mettre vos changements 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.

Si vous souhaitez gérer ces droits d’accès de manière plus fine, vous pouvez utiliser les droits dédiés dans Profile Management, Custom Profile.

<figure><img src="/files/e30dd662c3e9df236fe217538e7600948137c486" alt=""><figcaption></figcaption></figure>

## Vers l’avenir

**Pérennisez votre flux de travail**

Bien que le déploiement direct en production depuis une Branch ne soit pas disponible, notre nouveau plugin QA (actuellement en développement) vous offrira une autre façon de tester vos Branches, même dans un environnement de production.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.
