DocumentationExperience Cloud KCS

Les modèles de workflow personnalisés reviennent aux valeurs par défaut après le déploiement dans AEM as a Cloud Service

Dernière mise à jour : 20 octobre 2026

Cet article explique pourquoi les modèles de workflow personnalisés dans Adobe Experience Manager as a Cloud Service reviennent à leurs définitions par défaut après le déploiement et fournit des étapes pour s’assurer que les personnalisations persistent.

Description description

Environnement

  • Adobe Experience Manager as a Cloud Service
  • Modèles de workflow personnalisés déployés via Cloud Manager

Problème/Symptômes

  • Après un déploiement de packages de contenu, les modèles de workflow personnalisés apparaissent initialement comme prévu.
  • Après un déploiement ultérieur ou un événement de cycle de vie de l’environnement, le modèle de workflow sous /var/workflow/models contient la définition par défaut au lieu de la définition personnalisée prévue.
  • Le package de contenu d’origine n’est pas disponible en tant que package modifiable dans le gestionnaire de packages après le déploiement de Cloud Manager. Les packages installés par Cloud Manager apparaissent sous la forme d’artefacts cp2fm convertis et figés.

Cause

Ce problème est généralement causé par l’utilisation de filtres de package larges ou incorrects et de méthodes de déploiement manuel. Lorsque les filtres de package ne sont pas spécifiques au modèle, ou lorsqu’une installation manuelle est utilisée en production, les modèles de workflow personnalisés peuvent être remplacés par les définitions par défaut lors de la synchronisation de l’environnement ou des événements de cycle de vie. La gestion des définitions de modèle de workflow au moment de la conception (/conf) et de l’exécution (/var) avec des filtres spécifiques au modèle et le déploiement via Cloud Manager garantit un déploiement automatisé et cohérent.

Résolution resolution

Pour résoudre ce problème, procédez comme suit :

  1. Passez en revue les filter.xml du package pour obtenir des racines au niveau des parents qui couvrent les modèles de workflow. Utilisez des racines de filtre spécifiques au modèle pour les modèles de workflow détenus par le package, plutôt qu’un filtre qui remplace l’ensemble de l’arborescence du modèle de workflow. Vérifiez le modèle au moment de la conception sous /conf/global/settings/workflow/models/<model> et le modèle d’exécution correspondant sous /var/workflow/models/<model> dans le cadre de la révision du déploiement.

  2. Utilisez mode="replace" uniquement lorsque le package contient la structure complète du modèle de workflow pour la racine de filtre exacte, y compris toutes les étapes, transitions, propriétés et métadonnées. Remarque : FileVault replace remplace le contenu couvert par la racine du filtre et supprime les nœuds de référentiel couverts qui ne sont pas présents dans le package. Conservez la racine du filtre limitée au modèle prévu. N’utilisez pas de racine parent large, sauf si le package possède intentionnellement tous les modèles sous-jacents.

  3. Conservez le modèle de workflow au moment de la conception sous /conf/global/settings/workflow/models/<model> dans le projet sous contrôle de code source. Après le déploiement, utilisez **Sync** dans la console Modèles de workflow et vérifiez que le modèle d’exécution sous /var/workflow/models/<model> reflète la définition personnalisée. Incluez le modèle de /var d’exécution dans le package uniquement si le propriétaire du workflow confirme que cette approche de déploiement et le programme de validation de package la prennent en charge pour votre projet.

  4. Pour le déploiement répétable de modèles de workflow contrôlés par la source, validez les modifications du package et déployez-les via le pipeline Cloud Manager. N’utilisez pas une installation manuelle du gestionnaire de packages comme méthode de déploiement répétable. Le gestionnaire de packages est disponible pour les opérations de contenu modifiable uniques ; cela ne fait pas de l’installation manuelle une partie du déploiement contrôlé par la source de Cloud Manager.

  5. Après la mise à jour des filtres et de l’approche de déploiement :

    • Incrémentez la version du package.
    • Créez l’intégralité du projet AEM et vérifiez que le package généré contient le modèle de workflow prévu.
    • Déploiement vers le développement ou évaluation via Cloud Manager.
    • Vérifiez le modèle dans la console Modèles de workflow et confirmez que la définition d’exécution reste correcte après le déploiement et après un redémarrage de l’environnement ou un événement de cycle de vie.
    • Après validation, promouvez le déploiement en production via Cloud Manager.
recommendation-more-help
experience-cloud-kcs-help-kbarticles