L’application Merge

L’application Merge vous permet de déplacer vos modifications de type de contenu d’un environnement à un autre. Avec l’application Merge, vous pouvez examiner les modifications dans votre environnement hors production et sélectionner celles à fusionner dans l’environnement cible que vous sélectionnez.

Les types de modifications de type de contenu suivants sont inclus dans la fusion :

• Ajout, édition, modification et/ou suppression de types de contenu.

• Ajout, édition et/ou suppression de champs.

• Ajout, édition et/ou suppression de paramètres de champ et de validations.

• Modifications de valeur par défaut.

• Modification de l’apparence du champ et du texte d’aide.

• Un minimum de deux environnements dans le même espace, avec l’application Merge installée dans chaque environnement à utiliser pour comparer les modifications.

• Pour qu’un utilisateur puisse effectuer une fusion, les autorisations suivantes doivent être activées dans le rôle d’espace de cet utilisateur :

• Règle d’autorisation qui permet de lire toutes les entrées dans l’environnement cible.
  

  REMARQUE : si l’accès à l’une des entrées de l’environnement cible est refusé, l’application Merge ne sera pas en mesure de valider si une fusion peut être exécutée avec succès.

• Autorisation de créer, de modifier et de supprimer des types de contenu dans l’environnement cible.

Pour installer l’application Merge :

1. Connectez-vous à l’application web Contentful.

2. Dans le volet supérieur, cliquez sur Applications et sélectionnez Marketplace.

3. Accédez à l’application Merge et sélectionnez-la. La page « Informations sur l’application » s’affiche.

4. Cliquez sur Installer. La boîte de dialogue « Gérer l’accès à l’application » s’affiche.
   

   

5. Cliquez sur le menu déroulant Environnements et sélectionnez celui ou ceux dans lesquels vous souhaitez installer l’application Merge.

6. Cliquez sur Autoriser l’accès.
   

   REMARQUE : il est nécessaire d’installer l’application Merge dans un environnement pour l’utiliser comme environnement source ou cible pour les changements de type de contenu.

7. Dans la page d’informations sur l’application, cliquez sur Installer. L’application Merge est installée.
   

   

REMARQUE : chaque fois que vous clonez un environnement, si l’application Merge est installée, elle est également clonée.

La fusion de vos modifications de type de contenu d’un environnement à un autre nécessite de passer par les étapes suivantes dans l’application :

• Sélection des environnements : à cette étape, vous sélectionnez l’environnement source qui contient les modifications et l’environnement cible dans lequel vous souhaitez fusionner vos modifications.

• Sélection des types de contenu : à cette étape, vous comparez vos types de contenu et sélectionnez les modifications que vous souhaitez fusionner dans l’environnement cible.
  Les modifications sont mises en évidence pour refléter le type de modification comme suit : - Couleur bleue : met en évidence un type de contenu ou un champ mis à jour dans une fusion.
  - Couleur verte : met en évidence un type de contenu ou un champ ajouté dans une fusion.
  - Couleur rouge : met en évidence un type de contenu ou un champ supprimé dans une fusion.

• Résolution des conflits : à cette étape, vous pouvez examiner les conflits potentiels et lire les recommandations pour les résoudre. Les types de contenu sont affichés dans les groupes suivants :

  1. Types de contenu avec actions requises : il est nécessaire de suivre les instructions de cette section pour fusionner le type de contenu dans l’environnement cible.
     Au lieu de suivre les instructions, vous pouvez supprimer le type de contenu de votre fusion.

  2. Types de contenu avec actions recommandées : il est recommandé de suivre les instructions de cette section, mais le type de contenu sera fusionné dans tous les cas.

  3. Prêt à fusionner : le type de contenu n’a pas de conflits. Aucune action n’est nécessaire.

REMARQUE: vous pouvez également utiliser l’application Merge avec l’interface Contentful CLI. Pour plus d’informations, consultez la section Application Merge CLI.

Comment fusionner les modifications de type de contenu

Pour fusionner vos modifications de types de contenu d’un environnement à un autre :

1. Connectez-vous à l’application web Contentful.

2. Cliquez sur Applications et sélectionnez Fusionner.

3. Sélectionnez les environnements à fusionner dans les listes déroulantes sous les champs suivants :

   1. Environnement cible : sélectionnez l’environnement cible dans lequel fusionner vos modifications.

   2. Environnement source : sélectionnez l’environnement dans lequel les modifications ont été apportées.

4. Après avoir sélectionné les environnements source et cible, cliquez sur Comparer les environnements.

5. Cochez les cases des modifications de type de contenu que vous souhaitez fusionner.
   

   REMARQUE : cliquez sur Afficher les détails pour développer les détails d’une modification spécifique, où vous pouvez voir quels champs ont été ajoutés, supprimés ou modifiés.

6. Cliquez sur Examiner les modifications pour passer à l’étape suivante.

7. S’il y a des conflits, examinez-les et résolvez-les comme indiqué, puis cliquez sur Recharger la page pour mettre à jour la page.
   

   Important : il est obligatoire de résoudre les conflits sous « Types de contenu avec actions requises » pour pouvoir procéder à votre fusion. Vous pouvez également supprimer les types de contenu de la fusion.

8. Facultatif : cliquez sur Exporter le script de migration pour générer et télécharger le fichier de migration. Vous pouvez utiliser le fichier de migration pour appliquer vos modifications de type de contenu dans d’autres environnements ou espaces ou pour conserver un enregistrement de la migration.

9. Cliquez sur Fusionner les types de contenu. La boîte de dialogue « Les fusions sont définitives » s’affiche.

10. Cliquez sur Fusionner les types de contenu pour confirmer vos modifications. Le processus de fusion commence.
    

    Important : ne fermez pas l’onglet du navigateur tant que la fusion n’est pas terminée.

11. Facultatif : une fois que vos modifications de type de contenu sont fusionnées dans l’environnement cible, consultez les résultats de la fusion dans l’écran RÉSULTAT DE LA FUSION.