DocumentazioneAEMGuida utente

Utilizzo dell’abilità di migrazione ad AEM Cloud using-cloud-migration-skill

Ultimo aggiornamento: 2 settembre 2026
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Developer

Questa documentazione descrive ogni modello di migrazione supportato, come fornire i risultati BPA e come gestire le sessioni in un progetto di grandi dimensioni. Per un’introduzione e le istruzioni di installazione, vedere la panoramica.

Generare un Runbook di migrazione migration-runbook

Per una valutazione dell’intero progetto, inizia con un runbook invece di denominare un singolo pattern. Chiedi all’agente:

Review my code for AEMaaCS migration

L’abilità genera un migration-runbook.md di sola lettura nella directory principale del progetto senza modificare il codice. Il runbook copre ogni pattern che l’abilità di migrazione può risolvere e, per ciascuno, registra:

  • La strategia di rilevamento utilizzata (risultati BPA/CAM, analizzatore o scansione del contenuto euristico)
  • I file interessati e un conteggio dei risultati per pattern
  • Un prompt di copia e incolla per avviare la sessione di migrazione del modello

Poiché il runbook scrive anche una cache dei risultati insieme al markdown, una sessione di pattern successiva riutilizza i risultati già scoperti, l’agente non esegue una nuova scansione. Utilizza il runbook per assegnare la priorità ai pattern da affrontare per primi, quindi avvia le sessioni di pattern come descritto di seguito.

NOTE
Runbook di sola lettura. Non modifica mai il codice, e i risultati euristici (non-BPA) sono corrispondenze candidate da confermare piuttosto che da conteggi autorevoli.

Funzionamento di una sessione workflow-overview

Ogni sessione di migrazione segue questa sequenza:

  1. Denomina il pattern: specifica un pattern (ad esempio, scheduler)
  2. Fornisci risultati: da un file BPA CSV, CAM tramite MCP o percorsi di file specifici
  3. L’agente legge le regole di trasformazione: l’abilità legge le regole di trasformazione pertinenti dall’abilità code-assessment associata prima di apportare modifiche al codice
  4. Primo batch di cinque: l’agente trasforma fino a cinque risultati e segnala le modifiche apportate
  5. Rivedi e continua: dopo aver esaminato ogni batch, rispondi continue per passare al successivo

L’agente elabora un modello e un batch alla volta. Non procede automaticamente; ogni batch richiede la tua conferma.

Modelli di migrazione patterns

Modulo di pianificazione scheduler

Esegue il targeting delle classi Java utilizzando l’iniezione di sling.commons.scheduler o Scheduler incompatibili con il runtime AEMaaCS senza stato e containerizzato.

ID pattern BPA: scheduler

L’agente converte Scheduler processi inseriti in @Component implementazioni di Runnable utilizzando @Designate, sostituendo la registrazione dell’utilità di pianificazione basata sul costruttore con i metodi del ciclo di vita @Activate / @Deactivate.

ResourceChangeListener resource-change-listener

Destinazioni delle implementazioni del listener ResourceChangeListener o ResourceChange che richiedono aggiornamenti per AEMaaCS.

ID pattern BPA: resourceChangeListener

Replica replication

Destinazione classi che importano com.day.cq.replication.Replicator o API di replica correlate, non supportate in AEMaaCS. L’agente li sostituisce con equivalenti basati su ContentDistribution e aggiorna i riferimenti del servizio OSGi corrispondenti.

ID pattern BPA: replication

Listener di eventi event-listener

Ha come target le implementazioni OSGi EventListener o EventHandler che devono essere aggiornate per la semantica di elaborazione degli eventi AEMaaCS.

ID pattern BPA: eventListener

Gestore di Evento event-handler

Ha come target i servizi OSGi EventHandler sincroni che devono essere adattati per AEMaaCS.

ID pattern BPA: eventHandler

API Asset asset-api

Consente di eseguire il targeting delle classi utilizzando API DAM AssetManager, DAMEvent o non supportate. L’agente li sostituisce con gli equivalenti API di AEM Assets supportati.

ID pattern BPA: assetApi

Lint HTL (data-sly-test) htl-lint

Esegue il targeting dei modelli HTL in ui.apps che generano data-sly-test: redundant constant value comparison avvisi di lint. L’agente rileva i modelli interessati analizzando direttamente il pacchetto di contenuti; questo modello non richiede una connessione BPA CSV o CAM.

ID pattern BPA: htlLint

NOTE
htlLint risultati non vengono visualizzati nelle esportazioni CSV BPA. L'agente li rileva mediante l'analisi diretta dei file quando si avvia una sessione per questo modello.

Configurazioni OSGi per Cloud Manager osgi-cloud-manager

Converte le configurazioni OSGi in ui.config nel formato .cfg.json compatibile con Cloud Manager con una gestione completa specifica dell’ambiente. Questo riguarda due attività correlate:

Conversione formato configurazione

AEMaaCS richiede che le configurazioni OSGi siano memorizzate come file .cfg.json, con configurazioni specifiche per l’ambiente nelle cartelle con ambito di runmode (config.author/, config.publish/, config.dev/ e così via). L’agente:

  • Converte le configurazioni OSGi esistenti di .config, .cfg e in formato XML in .cfg.json
  • Suddivide le configurazioni contenenti valori specifici dell’autore e della pubblicazione in file con ambito di modalità di esecuzione separati
  • Convalida i tipi di proprietà in base alla specifica del metatipo OSGi (stringhe, interi, booleani, array)
  • Segnala i PID di proprietà di Adobe per la revisione manuale anziché per la conversione automatica

Segreti e variabili di ambiente

Sposta i segreti di testo normale e i valori specifici dell’ambiente dai file di configurazione salvati e li sostituisce con i segnaposto di Cloud Manager:

  • $[secret:NAME]: per password, token e altri valori sensibili
  • $[env:NAME]: per valori non sensibili che differiscono per ambiente (ad esempio, URL del servizio)

Le variabili e i segreti corrispondenti vengono applicati in Cloud Manager e inseriti in fase di runtime; nessun valore viene memorizzato nel controllo del codice sorgente.

IMPORTANT
L'agente non restituisce mai valori segreti nella conversazione. Tutti i dati sensibili vengono scritti in un file handoff ignorato da applicare tramite l’API o l’interfaccia utente di Cloud Manager.

Questo modello non utilizza CSV o CAM BPA. Avvia una sessione con:

Scan my config files and create Cloud Manager environment secrets or variables.

Migrazione finestre di dialogo (interfaccia utente legacy) dialog-migration

Converte le finestre di dialogo dell’interfaccia classica in interfaccia touch. L’agente gestisce due sottotipi di finestre di dialogo: le definizioni di ExtJS / Interfaccia classica cq:Dialog vengono ricompilate come strutture di Coral 3 _cq_dialog e le finestre di dialogo di Coral 2 esistenti vengono aggiornate a Coral 3. Trasporta anche i listener, optionsProvider, namePrefix, e gli aggiornamenti filter.xml.

ID pattern BPA: lui (solo sottotipi finestra di dialogo)

Quando esistono risultati sia di finestre di dialogo che di widget personalizzati per gli stessi componenti, esegui prima la migrazione dei widget personalizzati in modo che tutti i riferimenti xtype vengano risolti prima della conversione delle finestre di dialogo.

Convert my Classic UI dialogs to Touch UI Coral 3.

Widget per progettazione personalizzati (interfaccia utente legacy) custom-design-widgets

Esegue la migrazione di widget ExtJS personalizzati (cq:Widget definizioni con valori xtype personalizzati). L’agente archivia i widget, quindi mappa ogni xtype su un equivalente Coral 3 noto o scaffolds un componente modulo dell’interfaccia utente Granite quando non esiste alcuna mappatura diretta.

ID pattern BPA: cdw

Migrate my custom ExtJS widgets (CDW findings) from CAM.

Modernizzazione modello template-modernization

Converte i modelli statici in modelli modificabili e genera le regole di riscrittura degli strumenti di modernizzazione di AEM corrispondenti (regole per struttura, componente e criteri). L’agente viene eseguito in tre fasi: rileva i modelli e produce un piano per modello, esegue il modello di piano per modello e convalida le strutture /conf generate.

Questo modello non utilizza un ID di modello BPA. Avvia una sessione con:

Migrate my static templates to editable templates and generate the Modernize Tools rewrite rules.

Opzioni Source BPA bpa-source

Origine
Quando utilizzare
File CSV BPA
Hai esportato un file CSV dalla tua istanza di AEM o da Cloud Acceleration Manager. Immetti il percorso del file all’avvio della sessione.
CAM tramite MCP
Hai configurato AEM Cloud Migration MCP. L’agente elenca i progetti CAM, l’utente conferma quale utilizzare e i risultati vengono recuperati direttamente. Vedi Utilizzo di Cloud Migration MCP.
Percorsi file manuali
Desideri eseguire la migrazione di file specifici senza un rapporto BPA. Fornisci i percorsi direttamente nella richiesta.

Gestione degli errori MCP mcp-errors

Se la connessione MCP restituisce un errore (inclusi errori di autenticazione o di progetto non trovato), l’agente si arresta e mostra l’errore. Non passa automaticamente a un’altra sorgente. Dallo stato di arresto, è possibile:

  • Conferma il progetto corretto dall’elenco visualizzato dall’agente
  • Fornire un percorso CSV BPA in alternativa
  • Fornire percorsi di file Java specifici per una migrazione manuale

Gestione delle sessioni in report di grandi dimensioni large-reports

Per i rapporti BPA con molti risultati, l’approccio batch per batch consente di convalidare in modo incrementale:

  1. Esamina le differenze per ciascun batch
  2. Eseguire il commit del batch con un messaggio di commit con ambito pattern
  3. Rispondi continue per avviare il batch successivo
  4. Ripeti l’operazione finché l’agente non segnala che tutti i risultati del modello sono stati completati

Un pattern per commit mantiene la cronologia Git leggibile e, se necessario, semplifica il ripristino delle singole trasformazioni del pattern.

NOTE
Se si termina una sessione prima dell'elaborazione di tutti i risultati, riavviare con lo stesso pattern e la stessa origine BPA in una nuova sessione. L'agente riprende dal punto in cui era stato interrotto.

Ambito Workspace workspace-scope

L’agente cerca e modifica i file solo all’interno delle cartelle aperte dell’area di lavoro IDE. Non esegue la scansione delle directory principali, delle cartelle di pari livello o di altre posizioni su disco.

Se un risultato BPA fa riferimento a un percorso di file che non esiste nell’area di lavoro, l’agente si arresta e indica i percorsi mancanti. Apri la cartella del progetto corretta o fornisci i percorsi in modo esplicito per continuare.

recommendation-more-help
experience-manager-cloud-service-help-main-toc