Gestione degli aggiornamenti degli argomenti DITA condivisi e della ripubblicazione delle mappe interessata in Adobe Experience Manager Guides
Questo articolo illustra gli approcci disponibili per identificare e gestire le mappe DITA interessate quando un argomento condiviso viene aggiornato nelle Guide di Adobe Experience Manager (AEM), incluse le opzioni di automazione manuali e personalizzate.
Descrizione description
Ambiente
- Guide di Adobe Experience Manager (AEM)
Problema/Sintomi
- Quando un argomento DITA condiviso viene riutilizzato in più mappe DITA in AEM Guides, l’aggiornamento dell’argomento non identifica automaticamente tutte le mappe interessate.
- L’aggiornamento dell’argomento non attiva automaticamente la rigenerazione e la ripubblicazione delle mappe interessate.
- Il pannello Riferimenti (Riferimenti
>utilizzati in) può essere utilizzato per visualizzare le relazioni di riferimento tra argomenti e mappe. Tuttavia, non esiste un’API o un flusso di lavoro integrato per identificare, rigenerare e ripubblicare automaticamente tutte le mappe interessate dopo un aggiornamento dell’argomento. - Per ottenere la piena automazione di questo scenario, è necessario uno sviluppo personalizzato.
Risoluzione resolution
Per identificare e ripubblicare le mappe DITA interessate dopo un aggiornamento di un argomento condiviso, effettuare le seguenti operazioni:
-
Il pannello Riferimenti di AEM Guides consente di identificare manualmente tutte le mappe DITA che fanno riferimento a un argomento modificato.
-
Per determinare lo stato di pubblicazione delle mappe interessate, controlla i registri di pubblicazione per ciascuna mappa oppure utilizza le API disponibili per verificare lo stato di pubblicazione.
-
Per l’automazione, implementa un flusso di lavoro personalizzato o un gestore eventi in AEM:
a. Configurare un listener back-end (ad esempio un OSGi
ResourceChangeListener, un’osservazione JCR o un modulo di avvio del flusso di lavoro) per rilevare eventi di salvataggio su argomenti DITA.b. Quando un argomento viene aggiornato, eseguire una query nel repository per trovare tutte le mappe di riferimento che utilizzano i dati di riferimento.
c. Per ogni mappa interessata, attiva la generazione e la pubblicazione dell’output utilizzando le API o i flussi di lavoro di pubblicazione disponibili.
d. Implementare la logica per evitare processi di pubblicazione duplicati o sovrapposti, ad esempio controllando le code dei processi o utilizzando identificatori univoci dei processi.
-
Dopo aver implementato l’automazione, verifica che l’aggiornamento di un argomento condiviso attivi la rigenerazione e la ripubblicazione di tutte le mappe interessate come previsto.