DocumentazioneExperience Cloud KCS

I modelli di flusso di lavoro personalizzati tornano ai valori predefiniti dopo la distribuzione in AEM as a Cloud Service

Ultimo aggiornamento: 20 ottobre 2026

Questo articolo spiega perché i modelli di flusso di lavoro personalizzati in Adobe Experience Manager as a Cloud Service ripristinano le definizioni predefinite dopo la distribuzione e fornisce i passaggi per garantire che le personalizzazioni persistano.

Descrizione description

Ambiente

  • Adobe Experience Manager as a Cloud Service
  • Modelli di flusso di lavoro personalizzati distribuiti tramite Cloud Manager

Problema/Sintomi

  • Dopo la distribuzione di un pacchetto di contenuti, i modelli di flusso di lavoro personalizzati vengono inizialmente visualizzati come previsto.
  • Dopo un evento successivo del ciclo di vita dell’ambiente o della distribuzione, il modello di flusso di lavoro in /var/workflow/models contiene la definizione predefinita anziché la definizione personalizzata prevista.
  • Il pacchetto di contenuto originale non è disponibile come pacchetto modificabile in Gestione pacchetti dopo la distribuzione di Cloud Manager. I pacchetti installati da Cloud Manager vengono visualizzati come artefatti convertiti e congelati cp2fm.

Causa

Questo problema è in genere causato dall’utilizzo di filtri di pacchetto e metodi di distribuzione manuali ampi o errati. Quando i filtri dei pacchetti non sono specifici per il modello o quando viene utilizzata l’installazione manuale in produzione, i modelli di flusso di lavoro personalizzati possono essere sovrascritti dalle definizioni predefinite durante la sincronizzazione dell’ambiente o gli eventi del ciclo di vita. La gestione delle definizioni dei modelli di flusso di lavoro in fase di progettazione (/conf) e runtime (/var) con filtri specifici del modello e la distribuzione tramite Cloud Manager garantisce una distribuzione coerente e automatizzata.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Esaminare filter.xml del pacchetto per individuare le directory principali a livello principale che coprono i modelli di flusso di lavoro. Utilizza le directory principali dei filtri specifiche per il modello per i modelli di flusso di lavoro di proprietà del pacchetto, anziché un filtro che sostituisce l’intero albero del modello di flusso di lavoro. Controllare il modello Design-Time in /conf/global/settings/workflow/models/<model> e il modello di runtime corrispondente in /var/workflow/models/<model> come parte della revisione della distribuzione.

  2. Utilizzare mode="replace" solo quando il pacchetto contiene la struttura completa del modello di flusso di lavoro per la radice del filtro esatto, inclusi tutti i passaggi, le transizioni, le proprietà e i metadati. Nota: FileVault replace sostituisce il contenuto coperto dalla radice del filtro e rimuove i nodi dell’archivio coperti che non sono presenti nel pacchetto. Mantieni la radice del filtro limitata al modello previsto; non utilizzare una radice principale ampia a meno che il pacchetto non possieda intenzionalmente ogni modello al suo interno.

  3. Mantieni il modello del flusso di lavoro in fase di progettazione in /conf/global/settings/workflow/models/<model> nel progetto controllato dall’origine. Dopo la distribuzione, utilizzare **Sync** nella console Modelli flusso di lavoro e verificare che il modello di runtime in /var/workflow/models/<model> rifletta la definizione personalizzata. Includere il modello di runtime /var nel pacchetto solo se il proprietario del flusso di lavoro conferma che questo approccio di distribuzione e la convalida del pacchetto lo supportano per il progetto.

  4. Per la distribuzione ripetibile di modelli di flusso di lavoro controllati dall’origine, esegui il commit delle modifiche apportate al pacchetto e distribuiscili tramite la pipeline Cloud Manager. Non utilizzare un’installazione manuale di Gestione pacchetti come metodo di distribuzione ripetibile. Gestione pacchetti è disponibile per operazioni una tantum con contenuto mutabile; ciò non rende l’installazione manuale parte della distribuzione controllata da sorgente di Cloud Manager.

  5. Dopo aver aggiornato i filtri e l’approccio di distribuzione:

    • Incrementa la versione del pacchetto.
    • Crea il progetto AEM completo e verifica che il pacchetto generato contenga il modello di flusso di lavoro previsto.
    • Implementare in Sviluppo o Stage tramite Cloud Manager.
    • Verifica il modello nella console Modelli di flusso di lavoro e verifica che la definizione del runtime rimanga corretta dopo la distribuzione e dopo il riavvio dell’ambiente o un evento del ciclo di vita.
    • Dopo la convalida, promuovi la distribuzione in Produzione tramite Cloud Manager.
recommendation-more-help
experience-cloud-kcs-help-kbarticles