Documentazione AEM as a Cloud Service Guida utente

Abilitare i componenti core per moduli adattivi

Ultimo aggiornamento: 27 giugno 2025

Si applica a:
Experience Manager as a Cloud Service

Creato per:

Amministratore
Sviluppatore
Utente

Versione	Collegamento articolo
AEM 6.5	Fai clic qui
AEM as a Cloud Service	Questo articolo

Abilitando i componenti core Adaptive Forms su AEM Forms as a Cloud Service, puoi iniziare a creare, pubblicare e distribuire componenti core basati su Adaptive Forms e Headless Forms utilizzando le istanze AEM Forms Cloud Service su più canali. Per utilizzare Headless Adaptive Forms è necessario un ambiente abilitato per i Componenti core Forms adattivi.

Considerazioni

Quando crei un nuovo programma AEM Forms as a Cloud Service, I componenti core Adaptive Forms e Headless Adaptive Forms sono già abilitati per il tuo ambiente.
Se hai un programma Forms as a Cloud Service precedente in cui i Componenti core sono non abilitati, puoi aggiungere le dipendenze dei Componenti core Adaptive Forms al tuo archivio AEM as a Cloud Service e distribuire l'archivio negli ambienti Cloud Service per abilitare Headless Adaptive Forms.
Se l'ambiente Cloud Service esistente offre l'opzione per creare Forms adattivo basato su Componenti core, i componenti core Forms adattivi e i Forms adattativi headless sono già abilitati per il tuo ambiente e puoi distribuire Forms adattivo basato su Componenti core come moduli headless a canali quali dispositivi mobili, web, app native e servizi che richiedono una rappresentazione headless di Forms adattivo.

Abilitare i componenti core Forms adattivi e i Forms adattativi headless

Per abilitare i componenti core Adaptive Forms e Headless Adaptive Forms per un ambiente AEM Forms as a Cloud Service, effettua le seguenti operazioni, nell’ordine elencato

Abilita componenti core e moduli adattivi headless

1. Clonare l’archivio Git di AEM Forms as a Cloud Service

Accedi a Cloud Manager e seleziona la tua organizzazione e il tuo programma.
Passa alla scheda Pipeline dalla pagina Panoramica del programma, quindi fai clic sul pulsante Accedi a dati archivio per accedere e gestire il tuo archivio Git. La pagina include le seguenti informazioni:
- URL dell’archivio Git di Cloud Manager.
- Credenziali dell’archivio Git (nome utente e password), nome utente Git.
Fare clic su Genera password per visualizzare o generare la password.
Aprire il terminale o il prompt dei comandi sul computer locale ed eseguire il comando seguente:
git clone [Git Repository URL]
Quando richiesto, immettere le credenziali. L'archivio viene clonato nel computer locale.

2. Aggiungere all’archivio Git le dipendenze dei Componenti core adattivi di Forms

Apri la cartella dell’archivio Git in un editor di codice di testo normale. Ad esempio, Codice VS.
Apri il file [AEM Repository Folder]\pom.xml per la modifica.

Sostituire le versioni dei componenti core.forms.components.version, core.forms.components.af.version e core.wcm.components.version con le versioni specificate nella documentazione dei componenti core. Se il componente non esiste, aggiungi questi componenti.

<!-- Replace the version with the latest released version at https://github.com/adobe/aem-core-forms-components/tags -->

<properties>
    <core.wcm.components.version>2.22.10</core.wcm.components.version>
    <core.forms.components.version>2.0.18</core.forms.components.version>
    <core.forms.components.af.version>2.0.18</core.forms.components.af.version>
</properties>

Menzionare la versione più recente dei componenti core di Forms

Nella sezione delle dipendenze del file [AEM Repository Folder]\pom.xml, aggiungere le dipendenze seguenti e salvare il file.

    <!-- WCM Core Component Examples Dependencies -->
        <dependency>
            <groupId>com.adobe.cq</groupId>
            <artifactId>core.wcm.components.examples.ui.apps</artifactId>
            <type>zip</type>
            <version>${core.wcm.components.version}</version>
        </dependency>
        <dependency>
            <groupId>com.adobe.cq</groupId>
            <artifactId>core.wcm.components.examples.ui.content</artifactId>
            <type>zip</type>
            <version>${core.wcm.components.version}</version>
        </dependency>
        <dependency>
            <groupId>com.adobe.cq</groupId>
            <artifactId>core.wcm.components.examples.ui.config</artifactId>
            <version>${core.wcm.components.version}</version>
            <type>zip</type>
        </dependency>
        <!-- End of WCM Core Component Examples Dependencies -->
        <!-- Forms Core Component Dependencies -->
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-core</artifactId>
            <version>${core.forms.components.version}</version>
        </dependency>
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-apps</artifactId>
            <version>${core.forms.components.version}</version>
            <type>zip</type>
        </dependency>
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-af-core</artifactId>
            <version>${core.forms.components.version}</version>
        </dependency>
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-af-apps</artifactId>
            <version>${core.forms.components.version}</version>
            <type>zip</type>
        </dependency>
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-examples-apps</artifactId>
            <type>zip</type>
            <version>${core.forms.components.version}</version>
        </dependency>
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-examples-content</artifactId>
            <type>zip</type>
            <version>${core.forms.components.version}</version>
        </dependency>
<!-- End of AEM Forms Core Component Dependencies -->

Apri il file [AEM Repository Folder]/all/pom.xml per la modifica. Aggiungere le dipendenze seguenti nella sezione <embeddeds> e salvare il file.

<!-- WCM Core Component Examples Dependencies -->

<!-- inside plugin config of filevault-package-maven-plugin -->
<!-- embed wcm core components examples artifacts -->

<embedded>
    <groupId>com.adobe.cq</groupId>
    <artifactId>core.wcm.components.examples.ui.apps</artifactId>
    <type>zip</type>
    <target>/apps/${appId}-vendor-packages/content/install</target>
</embedded>
<embedded>
    <groupId>com.adobe.cq</groupId>
    <artifactId>core.wcm.components.examples.ui.content</artifactId>
    <type>zip</type>
    <target>/apps/${appId}-vendor-packages/content/install</target>
</embedded>
<embedded>
    <groupId>com.adobe.cq</groupId>
    <artifactId>core.wcm.components.examples.ui.config</artifactId>
    <type>zip</type>
    <target>/apps/${appId}-vendor-packages/content/install</target>
</embedded>
<!-- embed forms core components artifacts -->
<embedded>
    <groupId>com.adobe.aem</groupId>
    <artifactId>core-forms-components-af-apps</artifactId>
    <type>zip</type>
    <target>/apps/${appId}-vendor-packages/application/install</target>
</embedded>
<embedded>
    <groupId>com.adobe.aem</groupId>
    <artifactId>core-forms-components-af-core</artifactId>
    <target>/apps/${appId}-vendor-packages/application/install</target>
</embedded>
<embedded>
    <groupId>com.adobe.aem</groupId>
    <artifactId>core-forms-components-examples-apps</artifactId>
    <type>zip</type>
    <target>/apps/${appId}-vendor-packages/content/install</target>
</embedded>
<embedded>
    <groupId>com.adobe.aem</groupId>
    <artifactId>core-forms-components-examples-content</artifactId>
    <type>zip</type>
    <target>/apps/${appId}-vendor-packages/content/install</target>
</embedded>

NOTE

Sostituisci ${appId} con il tuo appId.

Per trovare ${appId}, nel file [AEM Repository Folder]/all/pom.xml, cerca il termine -packages/application/install. Il testo prima del termine -packages/application/install è ${appId}. Il codice seguente, ad esempio, myheadlessform è ${appId}.





com.myheadlessform

myheadlessform.ui.apps

zip

/apps/myheadlessform-packages/application install

Nella sezione <dependencies> del file [AEM Repository Folder]/all/pom.xml, aggiungere le dipendenze seguenti e salvare il file:

        <!-- Other existing dependencies -->
        <!-- wcm core components examples dependencies -->
        <dependency>
            <groupId>com.adobe.cq</groupId>
            <artifactId>core.wcm.components.examples.ui.apps</artifactId>
            <type>zip</type>
        </dependency>
        <dependency>
            <groupId>com.adobe.cq</groupId>
            <artifactId>core.wcm.components.examples.ui.config</artifactId>
            <type>zip</type>
            </dependency>
        <dependency>
            <groupId>com.adobe.cq</groupId>
            <artifactId>core.wcm.components.examples.ui.content</artifactId>
            <type>zip</type>
        </dependency>
            <!-- forms core components dependencies -->
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-af-apps</artifactId>
            <type>zip</type>
        </dependency>
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-examples-apps</artifactId>
            <type>zip</type>
        </dependency>
            <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-examples-content</artifactId>
            <type>zip</type>
        </dependency>

Apri [AEM Repository Folder]/ui.apps/pom.xml per la modifica. Aggiungere la dipendenza af-core bundle e salvare il file.
<dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> </dependency>
NOTE
Assicurati che i seguenti artefatti dei Componenti core adattivi di Forms non siano inclusi nel progetto.
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>core-forms-components-apps</artifactId>
</dependency>
e
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>core-forms-components-core</artifactId>
</dependency>
Salva e chiudi il file.

3. Genera e distribuisci il codice aggiornato

Distribuisci il codice aggiornato negli ambienti di sviluppo locali e Cloud Service per abilitare i Componenti core in entrambi gli ambienti:

Generare e distribuire il codice aggiornato in un ambiente di sviluppo locale (AEM as a Cloud Service SDK)
Creare e distribuire il codice aggiornato in un ambiente AEM Forms as a Cloud Service

Generare e distribuire il codice aggiornato in un ambiente di sviluppo locale

Apri il prompt dei comandi o il terminale.
Passa alla directory principale del progetto dell’archivio Git.
Esegui il seguente comando per generare il pacchetto per il tuo ambiente:
mvn clean install
Una volta creato correttamente il pacchetto, puoi trovarlo nella [cartella dell'archivio Git]\all\target[appid].all-[versione].zip
Utilizza Gestione pacchetti per distribuire il pacchetto [Cartella di progetto Archetipo AEM]\all\target[appid].all-[versione].zip nell'ambiente di sviluppo locale.

Creare e distribuire il codice aggiornato in un ambiente AEM Forms as a Cloud Service

Aprire il terminale o il prompt dei comandi.

Passa a [AEM Repository Folder] ed esegui i seguenti comandi nell'ordine elencato

 git add pom.xml
 git add all/pom.xml
 git add ui.apps/pom.xml
 git commit -m "Added dependencies for Adaptive Forms Core Components"
 git push origin

Dopo il commit dei file nell'archivio Git, Esegui la pipeline.

Una volta completata l’esecuzione della pipeline, i componenti core Adaptive Forms vengono abilitati per l’ambiente corrispondente. Inoltre, all’ambiente Forms as a Cloud Service vengono aggiunti un modello Forms adattivo (Componenti core) e un tema Canvas 3.0, che offrono opzioni per personalizzare e creare componenti core basati su Adaptive Forms.

Domande frequenti

Cosa sono i Componenti core?

I Componenti core sono un insieme di componenti WCM (Web Content Management) standardizzati di 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:

I componenti core Forms adattivi sono abilitati per il mio ambiente?

Per verificare che i componenti core Adaptive Forms siano abilitati per il tuo ambiente:

Clona l'archivio AEM Forms as a Cloud Service.
Apri il file [AEM Repository Folder]/all/pom.xml dell'archivio Git di AEM Forms Cloud Service.
Cerca le dipendenze seguenti:
- core-forms-components-af-core
- core-forms-components-core
- core-forms-components-apps
- core-forms-components-af-apps
- core-forms-components-examples-apps
- core-forms-components-examples-content
Se le dipendenze esistono, i componenti core Adaptive Forms sono abilitati per il tuo ambiente.

Perché i moduli basati su Componenti core non vengono riprodotti nel progetto?

Il rendering dei moduli basati su Componenti core potrebbe non riuscire a causa di una mancata corrispondenza tra la versione del pacchetto dei Componenti core di Forms e quella inclusa nell’archetipo del progetto. Questo problema si verifica in genere quando la versione specificata nell’archetipo del progetto è uguale o superiore alla versione inclusa nel pacchetto dei Componenti core di Forms. Per risolvere il problema, eseguire una delle operazioni seguenti:

Utilizza una versione inferiore del pacchetto dei Componenti core di Forms nell’archetipo del progetto.
Rimuovi la dipendenza dai Componenti core Forms dall’archetipo del progetto, in quanto la versione richiesta è già inclusa in AEM as a Cloud Service. Il pacchetto dei Componenti core Forms è incluso con AEM as a Cloud SDK a partire dalla versione 20133, ad esempio AEM SDK v2025.3.20133.20250325T063357Z-250300.

recommendation-more-help