# Gestion des versions

## Aperçu

La gestion des versions offre plusieurs avantages clés :

* **Expérimentation sécurisée**: Créez et testez des modifications dans une nouvelle version sans affecter la version en production utilisée sur vos pages.
* **Suivi des modifications**: Conservez un historique des modifications des composants.
* **Restauration facile**: Revenez rapidement à une version antérieure fonctionnelle si nécessaire.
* **Développement organisé**: Séparez les versions expérimentales et stables.

### Concepts clés

* **Versions multiples**: Enregistrez un nombre illimité de versions d'un seul composant dynamique.
* **Version active**: Une seule version est « active » à la fois. Cette version est affichée lorsque vous ajoutez le composant à une page Salesforce.
* **Versions indépendantes**: Chaque version est une copie distincte. Les modifications apportées à une version n'affectent pas les autres tant que vous n'activez pas une version différente.

## Afficher les versions du composant (depuis la page d'accueil)

Vous pouvez afficher toutes les versions enregistrées d'un composant dynamique spécifique directement depuis la page d'accueil des composants dynamiques Avonni dans l'application Avonni Components. Cette vue sert de point de départ pour gérer les versions individuelles.

1. **Accéder à l'application**: Depuis le lanceur d'applications Salesforce (grille à neuf points), ouvrez l'application « Avonni Components ».
2. **Trouvez votre composant**: Localisez le composant dynamique que vous souhaitez gérer dans la liste principale.
3. **Afficher les versions**: Cliquez sur la flèche du menu déroulant à côté du nom du composant. Cela développera la liste pour afficher toutes les versions enregistrées de ce composant.
4. **Identifier la version active**: La version actuellement active (celle utilisée sur les pages Lightning) sera indiquée dans la liste (souvent avec un libellé d'état spécifique comme « Active », une coche, ou un style distinct). D'autres versions peuvent afficher des statuts comme « Brouillon ».

Depuis cette liste de versions, vous pouvez généralement accéder à des actions telles que l'édition d'une version spécifique, l'activation d'une version différente ou l'archivage de l'ensemble du composant (voir les sections suivantes pour plus de détails sur ces actions).

## Enregistrer une nouvelle version

1. Ouvrir et modifier : Ouvrez le composant dynamique dans le constructeur de composants et apportez vos modifications.
2. Enregistrer comme nouvelle version : Au lieu de cliquer sur « Enregistrer » (ce qui écraserait la version actuelle), sélectionnez l'option pour enregistrer comme nouvelle version. Cela crée une nouvelle version, laissant la version active inchangée.
3. Numérotation automatique : Avonni attribue automatiquement un nouveau numéro de version (par exemple, Version 2, Version 3).

## Activation d'une version

Pour rendre une version spécifique de votre composant active (celle affichée sur les pages) :

1. **Allez à la page d'accueil**: Accédez à la page d'accueil des composants dynamiques Avonni.
2. **Trouvez votre composant**: Localisez votre composant dans la liste.
3. **Afficher les versions**: Déployez la liste des versions.
4. **Modifier la version ciblée**: Cliquez sur la flèche du menu déroulant à côté de la version que vous souhaitez activer et sélectionnez « Modifier ».
5. **Activer**: Cliquez sur le bouton « Activer ». Cela rend la version choisie active et désactive la précédente.

## Suppression des versions de composants dynamiques

La suppression des versions nécessite une manipulation prudente en raison du stockage via le type de métadonnées personnalisées sous-jacent dans Salesforce. Bien que la suppression directe ne soit pas possible au sein de l'application Avonni, celle-ci vous guide tout au long du processus.

{% hint style="danger" %}

#### Prérequis crucial : vérifiez l'utilisation du composant !

Avant de supprimer, assurez-vous que le composant N'EST PAS utilisé sur une page Lightning. La suppression d'un composant utilisé cassera ces pages. Veuillez le retirer de toutes les pages dans le Lightning App Builder en premier.
{% endhint %}

### Processus de suppression recommandé (via l'application Avonni) :

1. Archiver le composant dynamique :
   * Vous devez d'abord archiver l'ensemble du composant dynamique (toutes les versions).
   * Utilisez le menu d'actions du composant depuis la page d'accueil des composants dynamiques Avonni et sélectionnez « Archiver ».
   * Effet : Rend le composant et toutes ses versions inactifs, les déplaçant vers la section Archive.
2. Accédez à la section Archive : Allez dans le dossier/la section Archive au sein de l'application Avonni Components.
3. Localisez le composant archivé et la version : Trouvez et développez le composant pour afficher ses versions archivées.
4. Initier la suppression de la version : Sélectionnez la version spécifique que vous souhaitez supprimer et choisissez « Supprimer » dans son menu d'actions.
5. Redirection vers la configuration Salesforce :
   * Important : Cliquer sur « Supprimer » dans l'application Avonni vous redirige vers la page d'enregistrement du type de métadonnées personnalisées dans la configuration Salesforce.
6. Confirmer la suppression dans la configuration Salesforce : Cliquez sur le lien/bouton standard « Supprimer » de Salesforce sur la page redirigée et confirmez.

Comprendre le processus : Avonni gère des « versions », chacune correspondant à un enregistrement du type de métadonnées personnalisées. L'application vous guide vers la configuration Salesforce pour la suppression définitive.

### Suppression directe via la configuration (Avancé - à utiliser avec une extrême prudence) :

Techniquement, vous pouvez supprimer directement depuis la configuration Salesforce :

{% stepper %}
{% step %}
**Allez dans Configuration > Types de métadonnées personnalisées**

Cliquez sur l' **icône d'engrenage** , puis sélectionnez **icône d'engrenage**. Dans la zone de recherche rapide, tapez `Types de métadonnées personnalisées` et sélectionnez-le dans les résultats.
{% endstep %}

{% step %}
**Trouvez le type de métadonnées personnalisées Avonni Dynamic Components (par exemple, avonnidc\_\_Dynamic\_Component\_\_mdt).**

Dans la liste des types de métadonnées personnalisées, localisez celui spécifique utilisé par Avonni Dynamic Components. Le nom d'API sera typiquement quelque chose comme `avonnidc__Dynamic_Component__mdt`
{% endstep %}

{% step %}
**Cliquez sur « Gérer les enregistrements ».**

Sur la page de détail du type de métadonnées personnalisées, trouvez la section pour les enregistrements eux‑mêmes et cliquez sur le **bouton « Gérer les enregistrements »** . Cela affichera une liste de tous les enregistrements individuels, chacun représentant une version spécifique d'un composant dynamique Avonni.
{% endstep %}

{% step %}
**Localisez l'enregistrement de la version spécifique (peut être difficile).**

* C'est l'étape la plus critique et potentiellement complexe. Vous devez identifier méticuleusement l' *enregistrement* exact
* de métadonnées personnalisées correspondant à la version spécifique du composant que vous avez l'intention de supprimer définitivement. **Les enregistrements peuvent être identifiables par leur « Libellé » (souvent le nom du composant et les informations de version) ou par le « Nom d'API ». Il n'y a**pas de « liste de versions » visuelle ici comme dans l'application Avonni
* **, ce qui rend beaucoup plus facile de sélectionner le mauvais enregistrement.** Vérifiez et revérifiez
  {% endstep %}

{% step %}
**les détails (Nom, Date de dernière modification, toute information d'identification) pour vous assurer que vous avez le bon enregistrement avant de continuer. Supprimer par erreur le mauvais enregistrement peut avoir des conséquences importantes.**

* Cliquez sur le lien « Suppr ». *Une fois que vous êtes* absolument certain **d'avoir identifié le bon enregistrement pour la version que vous souhaitez supprimer, cliquez sur le** lien « Suppr »
* (Supprimer) dans la colonne « Action » à côté de cet enregistrement spécifique. **Salesforce vous demandera alors de confirmer la suppression.**
  {% endstep %}
  {% endstepper %}

<mark style="color:Note finale;background-color:red;">**Une fois confirmée, cette action est immédiate et permanente via cette interface et contourne toute gestion du cycle de vie ou les protections au sein de l'application Avonni.**</mark>par défaut

: La suppression est permanente. Avant de supprimer, assurez-vous que la version n'est plus nécessaire et n'est pas utilisée. Envisagez de conserver les versions archivées.

* Notes importantes sur la suppression

## Suppression permanente (Avancé) : Seuls les administrateurs expérimentés disposant de sauvegardes devraient supprimer directement les enregistrements du type de métadonnées personnalisées. L'archivage est généralement suffisant.

Exemple : Tester un nouveau bouton

1. **Vous avez un composant dynamique nommé « ContactForm », avec la Version 1 active.**&#x41;jouter une nouvelle fonctionnalité
2. **: Vous souhaitez ajouter un nouveau bouton. Vous ouvrez « ContactForm » et ajoutez le bouton.**&#x45;nregistrer comme nouvelle version
3. **: Vous enregistrez ceci comme Version 2. La Version 1 reste active.**&#x54;ester la nouvelle version
4. **: Vous testez la Version 2 (éventuellement sur une page de test).**&#x41;ctiver la nouvelle version

: Une fois satisfait, activez la Version 2 depuis la page d'accueil des composants dynamiques Avonni. La Version 1 est maintenant inactive et la Version 2 est en production.
