Abilitare i componenti core Adaptive Forms sul Forms AEM 6.5 enable-adaptive-forms-core-components
L'abilitazione dei componenti core Forms adattivi consente di iniziare a creare, pubblicare e distribuire componenti core basati su Forms adattivo e Forms adattivo headless dall'ambiente Forms AEM 6.5.
Per abilitare i componenti core Adaptive Forms nell'ambiente Forms AEM 6.5, imposta e distribuisci un progetto basato su AEM Archetype 41 o versione successiva (con le opzioni Forms abilitate) in tutte le istanze Author e Publish.
Questo articolo fornisce istruzioni dettagliate per configurare e distribuire un progetto basato su Archetipo AEM 41 o versione successiva nell’ambiente Forms AEM 6.5 per abilitare i componenti core di Forms adattivi. Per versioni compatibili con AEM 6.5 per abilitare i componenti core Forms, fare riferimento all'elenco seguente:
Prerequisiti prerequisites
Prima di abilitare i componenti core Forms adattivi in un ambiente Forms AEM 6.5:
-
Eseguire l'aggiornamento a AEM 6.5 Forms Service Pack 16 (6.5.16.0) o versione successiva.
-
Installa la versione più recente di Apache Maven.
-
Installa un editor di testo normale. Microsoft Visual Studio Code.
Crea e implementa il progetto più recente basato su Archetipo AEM
Per creare un progetto basato su Archetipo AEM 41 o versione successiva e distribuirlo a tutte le istanze Author e Publish:
-
Accedi al tuo computer, ospitando ed eseguendo l’istanza Forms AEM 6.5, come amministratore.
-
Apri il prompt dei comandi o il terminale ed esegui il seguente comando per creare un progetto Archetipo AEM (con le opzioni Forms abilitate):
- Microsoft Windows
code language-shell mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate ^ -D archetypeGroupId=com.adobe.aem ^ -D archetypeArtifactId=aem-project-archetype ^ -D archetypeVersion=41 ^ -D appTitle="My Form" ^ -D appId="myform" ^ -D groupId="com.myform" ^ -D includeFormsenrollment="y" ^ -D aemVersion="6.5.15"
- Linux o Apple macOS
code language-shell mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \ -D archetypeGroupId=com.adobe.aem \ -D archetypeArtifactId=aem-project-archetype \ -D archetypeVersion=41 \ -D appTitle="My Form" \ -D appId="myform" \ -D groupId="com.myform" \ -D includeFormsenrollment="y" \ -D aemVersion="6.5.15"
Quando esegui il comando di cui sopra, considera i seguenti punti:
-
Non modificare il valore della proprietà
aemVersion
da6.5.15.0
ad altro. -
Impostare la proprietà
archetypeVersion
su41
o versione successiva. Per la versione più recente, consulta la sezione sui requisiti di sistema nella documentazione di AEM Project Archetype. -
Aggiornare il comando in modo che rifletta i valori specifici dell'ambiente, inclusi
appTitle
,appId
egroupId
. Impostare inoltre il valore della proprietàincludeFormsenrollment
suy
. Se si utilizza Forms Portal, impostare l'opzioneincludeExamples=y
per includere nel progetto i componenti core di Forms Portal.
-
(Solo per progetti basati su Archetipo versione 41) Dopo la creazione del progetto Archetipo AEM, abilita i temi per Forms adattivo basato su Componenti core. Per abilitare i temi:
-
Apri la [cartella dei progetti Archetipo AEM]/ui.apps/src/main/content/jcr_root/apps/appId/components/adaptiveForm/page/customheaderlibs.html per modificare:
-
Aggiungere il seguente codice alla riga 21:
code language-xml <sly data-sly-use.clientlib="core/wcm/components/commons/v1/templates/clientlib.html" data-sly-use.formstructparser="com.adobe.cq.forms.core.components.models.form.FormStructureParser" data-sly-test.themeClientLibRef="${formstructparser.themeClientLibRefFromFormContainer}"> <sly data-sly-test="${themeClientLibRef}" data-sly-call="${clientlib.css @ categories=themeClientLibRef}"/> </sly>
-
Salva e chiudi il file.
-
-
Aggiorna il progetto per includere la versione più recente dei Componenti core di Forms:
-
Apri [Cartella progetti Archetipo AEM]/pom.xml per la modifica.
-
Impostare la versione di
core.forms.components.version
ecore.forms.components.af.version
sulla versione più recente dei Componenti core di Forms e assicurarsi che entrambi abbiano la stessa versione dei Componenti core di Forms menzionati nella tabella e impostare la versione dicore.wcm.components.version
come specificato in Componenti core di WCM.note warning WARNING - Durante la creazione di un progetto Archetipo con versione 45,
[AEM Archetype Project Folder]/pom.xml
imposta inizialmente la versione dei Componenti core forms su 1.1.28. Prima di creare o distribuire il progetto Archetipo, aggiorna la versione dei componenti core forms al 1.1.26. La versione più recente è disponibile nella cronologia delle versioni di Forms 6.5 per l'AEM.
note note NOTE - Se configuri un’altra topologia, accertati di aggiungere l’URL di invio, precompilazione e altro al inserisco nell'elenco Consentiti a livello di Dispatcher.
- Durante la creazione di un progetto Archetipo con versione 45,
-
Salva e chiudi il file.
-
-
Dopo aver creato correttamente il progetto dell’Archetipo AEM, crea il pacchetto di distribuzione per il tuo ambiente. Per generare il pacchetto:
-
Passa alla directory principale del progetto Archetipo AEM.
-
Esegui il seguente comando per creare il progetto Archetipo AEM per il tuo ambiente:
code language-shell mvn clean install
Una volta creato correttamente il progetto dell’Archetipo AEM, viene generato un pacchetto AEM. Puoi trovare il pacchetto in [Cartella progetti Archetipo AEM]\all\target[appid].all-[version].zip
-
-
Utilizza Gestione pacchetti per distribuire il pacchetto [Cartella progetti Archetipo AEM]\all\target[appid].all-[versione].zip in tutte le istanze Author e Publish.
- Se si verificano problemi durante l'accesso alla finestra di dialogo di accesso in un'istanza di pubblicazione, per installare il pacchetto tramite Gestione pacchetti provare a utilizzare l'URL
http://[Publish Server URL]:[PORT]/system/console
per l'accesso. Questo consente di accedere alla pagina di accesso di un’istanza di Publish, per procedere con il processo di installazione. - Non eliminare o eliminare il progetto Archetipo dopo averlo distribuito nell’ambiente. Il progetto Archetipo è necessario per aggiungere all’ambiente temi personalizzati e nuovi Componenti core Forms adattivi.
I Componenti core sono abilitati per il tuo ambiente. Nell'ambiente vengono distribuiti un modello modulo adattivo basato su Componenti core vuoti e un tema Canvas 3.0, che consente di creare componenti core basati su Forms adattivo.
Domande frequenti
Cosa sono i Componenti core?
I Componenti core sono un insieme di componenti WCM (Web Content Management) standardizzati per l'AEM che consentono di velocizzare i tempi di sviluppo e ridurre i costi di manutenzione dei siti Web.
Quali sono tutte le funzionalità aggiunte all’abilitazione dei componenti core?
Quando i componenti core Adaptive Forms sono abilitati per il tuo ambiente, all’ambiente vengono aggiunti un modello di modulo adattivo basato su Componenti core vuoto e un tema Canvas 3.0. Dopo aver abilitato i componenti core Forms adattivi per il tuo ambiente, puoi:
- Creazione di componenti core basati su Adaptive Forms.
- Creare modelli di moduli adattivi basati su Componenti core.
- Crea temi personalizzati per i modelli di moduli adattivi basati su Componenti core.
- Distribuisci le rappresentazioni JSON del modulo adattivo basato su componenti core a canali quali dispositivi mobili, web, app native e servizi che richiedono la rappresentazione headless di un modulo.