La distribuzione di AEM Cloud Manager non riesce a causa di errori di compilazione HTL nelle risorse della libreria client

✨ Il contenuto è generato tramite IA e potrebbe non essere accurato. Termini di IA generativi

Questo articolo spiega come risolvere gli errori di distribuzione di Cloud Manager causati da errori di compilazione HTL quando i valori letterali dei modelli JavaScript nelle risorse HTML della libreria client vengono interpretati in modo errato dal parser AEM.

Descrizione description

Ambiente

  • Adobe Experience Manager (AEM) Cloud Manager (tutte le versioni)

Sintomi

Le build di Cloud Manager non riescono durante il passaggio di distribuzione in tutti gli ambienti (sviluppo, staging e produzione). I registri della pipeline mostrano gli errori di compilazione HTL nei file di risorse della libreria client. Il parser segnala errori quali:

  • mismatched input '(' expecting {'}', '@'}

Le risorse interessate includono i file HTML all’interno delle librerie client che contengono espressioni letterali per i modelli di JavaScript (ad esempio, ${getAccessToken()}) in .html file. Queste vengono interpretate come espressioni HTL e causano errori del parser durante la distribuzione.

Causa

La distribuzione non riesce perché le espressioni letterali al modello di JavaScript (${...}) all’interno delle risorse della libreria client .html vengono interpretate come espressioni HTL dal parser di AEM, causando errori di sintassi durante il passaggio di compilazione HTL.

Risoluzione resolution

Per risolvere il problema, segui la procedura riportata di seguito.

  1. Esaminare i file di risorse della libreria client interessati nel codebase, ad esempio i file HTML in /apps/.../clientlibs/.../resources/.
  2. Verificare la presenza di espressioni JavaScript basate sul valore letterale del modello utilizzando la sintassi ${...} all’interno di questi file .html.
  3. Se queste espressioni sono destinate a JavaScript, accertati che non siano interpretate come espressioni HTL dal parser di AEM.
  4. Spostare il codice JavaScript contenente i valori letterali del modello in .js file invece di incorporarli direttamente nelle risorse .html. In alternativa, esegui il escape o il refactoring della sintassi ${...} per evitare conflitti di analisi HTL.
  5. Esegui nuovamente la pipeline di Cloud Manager per verificare che gli errori di compilazione HTL siano stati risolti.
recommendation-more-help
experience-cloud-kcs-help-kbarticles