Versioning

Le versioning est une fonctionnalité essentielle pour gérer les modifications et la synchronisation des groupes de champs entre différents environnements. Avec CustomFieldGroups, le versioning est intégré de manière transparente pour fonctionner avec Git, garantissant que vos groupes de champs sont constamment mis à jour et synchronisés. Ce processus est conçu pour faciliter les transitions entre les environnements de développement, de préproduction et de production.

Comment fonctionne le versioning

1. Stockage des groupes de champs : Les groupes de champs sont automatiquement enregistrés dans le répertoire /field-groups/ du module. Ce répertoire contient les fichiers JSON représentant vos groupes de champs.

2. Fonctionnalité :

   • Mise à jour : Si un groupe de champs existe dans la base de données et que le module détecte des différences avec le fichier enregistré, vous pourrez appliquer les modifications du fichier présent dans le répertoire /field-groups/ en un clique.
   • Création : Les nouveaux groupes de champs qui ne sont pas présents dans l'environnement seront créés automatiquement lorsque le module sera synchronisé.
   • Suppression : Si un fichier de groupe de champs manque dans le répertoire /field-groups/ et existe dans l'environnement, il sera supprimé pour garantir la cohérence.

info

La synchronization requiert une action manuelle pour être effectuée. Vous pouvez ignorer une synchronization si vous le souhaitez.

Activation du versioning

Pour activer le versioning :

• Allez sur la page de configuration du module.
• Activez la synchronisation des groupes de champs dans les paramètres.

Synchronisation

1. Déclenchement de la synchronisation :

   • Depuis la page des groupes de champs : Un message vous invitera à lancer la synchronisation si nécessaire. Il donnera également des détails sur les groupes impactés et des indications pour ignorer des synchronizations spécifiques.

   

   • Depuis la page d'édition du groupe de champs : Vous pouvez lancer manuellement la synchronisation pour vous assurer que l'environnement est à jour.

   

2. Exécution de la synchronisation : Cliquez sur le bouton de synchronisation fourni pour mettre à jour vos groupes de champs. Ce processus garantira que toutes les modifications sont reflétées dans votre environnement.

Bonnes pratiques

• Désactiver l'édition des groupes de champs en production : Évitez de faire des modifications directes aux groupes de champs dans l'environnement de production. Cela aide à prévenir les incohérences et les problèmes potentiels avec les données. Vous pouvez activer cette option dans la page de configuration du module.

• Utiliser la synchronisation en production : Effectuez toutes les mises à jour et modifications des groupes de champs dans un environnement de développement ou de préproduction. Utilisez la synchronisation pour appliquer ces modifications à l'environnement de production, en veillant à ce que toutes les mises à jour des groupes de champs soient contrôlées et suivies.

En suivant ces pratiques, vous pouvez maintenir une configuration stable et synchronisée entre vos différents environnements, améliorant ainsi la fiabilité et la gestion de votre module.