Configurare e configurare siti di riferimento AEM Forms

AEM Forms fornisce un'implementazione del sito di riferimento per dimostrare come AEM Forms aiuta le organizzazioni del settore e del governo dei servizi finanziari a trasformare le loro complesse transazioni in esperienze digitali semplici e coinvolgenti ovunque, in qualsiasi momento, su qualsiasi dispositivo.

I siti di riferimento We.Finance e We.Gov attingono a casi di utilizzo reali per coinvolgere clienti esistenti e potenziali, dal punto di partenza alla gestione delle corrispondenze e delle transazioni in modo personalizzato ed economico.

I siti di riferimento consentono di esplorare e presentare le seguenti funzionalità chiave di AEM Forms.

• Esperienza di authoring semplificata con moduli adattivi coinvolgenti e reattivi e comunicazioni interattive.
• Comunicazioni interattive per creare comunicazioni interattive, personalizzate e reattive per i clienti che si adattano all'impostazione e al layout del dispositivo.
• Integrazione dei dati per la connessione a origini dati diverse per la precompilazione e l'invio dei dati del modulo tramite un modello dati del modulo.
• Flusso di lavoro Forms per automatizzare processi e flussi di lavoro aziendali.
• Funzionalità avanzate di gestione ed elaborazione dei dati utente.
• Integrazione con Adobe Sign per firmare e inviare moduli adattivi in modo sicuro.
• Integrazione con Adobe Target per distribuire raccomandazioni mirate e eseguire test A/B per ottimizzare il ROI da un modulo.
• Integrazione con Adobe Analytics per misurare le prestazioni di un modulo o di una campagna e prendere decisioni informate.
• Esperienza di compilazione dei moduli migliorata.

I siti di riferimento forniscono risorse riutilizzabili che potete usare come modelli per creare risorse personalizzate.

• Integrazione con Adobe Sign per firmare e inviare moduli adattivi in modo sicuro.

• Integrazione con Adobe Sign per firmare e inviare moduli adattivi in modo sicuro.

Prerequisiti e passaggi per configurare i siti di riferimento

Prima di configurare il sito di riferimento, accertatevi di disporre dei seguenti elementi:

• AEM di base

  AEM QuickStart, pacchetto aggiuntivo AEM Forms e pacchetti di riferimento per siti. Per informazioni dettagliate sui pacchetti di componenti aggiuntivi e di riferimento per i siti, vedere rilasci di AEM Forms.

• Un
  servizio SMTP: è possibile utilizzare qualsiasi servizio SMTP.

• account sviluppatore Adobe Sign e applicazione API Adobe Sign

  Per utilizzare le funzionalità di firma digitale, è necessario account sviluppatore Adobe Sign. Vedere Adobe Sign.

• Un'istanza in esecuzione di Microsoft Dynamics 365 da integrare con AEM Forms. Per eseguire il sito di riferimento, importare i dati di esempio nell'istanza di Microsoft Dynamics per precompilare la comunicazione interattiva utilizzata nel sito di riferimento.

• Un'istanza in esecuzione di AEM 6.4 con il pacchetto aggiuntivo Forms. Per ulteriori informazioni, vedere Installazione e configurazione AEM Forms.

Effettuate i seguenti passaggi nella sequenza consigliata per configurare e impostare i siti di riferimento.

Incremento	Configurazione	Note
Installare e configurare AEM Forms	Creazione e pubblicazione	Installate e configurate istanze di creazione e pubblicazione AEM Forms.
Configurare SSL	Autore e pubblicazione	Abilita HTTP su SSL per comunicazioni sicure con Adobe Sign.
Configurare la configurazione Day CQ Link Externalizer	Autore e pubblicazione	Casi di utilizzo del sito di riferimento forniscono e-mail per diverse transazioni. Questa impostazione è necessaria per la consegna della newsletter tramite e-mail. Gli URL e le immagini puntano all’istanza di pubblicazione.
Configura servizio di posta CQ Day	Creazione e pubblicazione	Obbligatorio per la comunicazione tramite e-mail.
Ignora configurazione XSS predefinita	Pubblicazione	Utilizzato per ignorare $, { e } caratteri bloccati dalla sicurezza xss.
Configurare le impostazioni di AEM DS	Autore	Configurare AEM DS per l'invio del modulo nell'istanza di pubblicazione e per l'elaborazione dei flussi di lavoro nell'istanza di creazione.
Distribuzione di pacchetti di siti di riferimento	Autore	Distribuire pacchetti per siti di riferimento ’istanza di creazione AEM Forms.
Importa dati di esempio in Microsoft Dynamics	Creazione e pubblicazione	Importazione di dati di esempio per l'applicazione di carte di credito, l'applicazione di ipoteca per la casa e l'applicazione di assicurazione per la casa dettagliata
Configurare il servizio cloud OAuth per Microsoft Dynamics	Creazione e pubblicazione	Configurare il servizio cloud OAuth in AEM Forms per abilitare la comunicazione tra AEM Forms e Microsoft Dynamics.
Configurare pianificazione Adobe Sign	Autore e pubblicazione	Modifica la configurazione del pianificatore per controllare lo stato ogni due minuti.
Configura sito di riferimento Cloud Service Adobe Sign	Autore e pubblicazione	Una configurazione fornita con i siti di riferimento crea pacchetti e richiede la riconfigurazione con credenziali valide.
Configurare Forms Common Configuration Service per gli utenti anonimi	Pubblicazione	La configurazione consente l’invio, la firma e la generazione del documento di registrazione per gli utenti anonimi.
Modifica file Swagger del servizio residuo per il modello dati del modulo	Autore e pubblicazione	Modificare il servizio per il proprio ambiente.

Installazione e configurazione AEM Forms

Installate e distribuite AEM Forms come descritto in Installazione e configurazione AEM Forms su OSGi.

Configurare SSL

La configurazione SSL è necessaria per comunicare con server Adobe Sign. Per i passaggi dettagliati, vedere Abilitazione di HTTP su SSL.

Configurare la configurazione Day CQ Link Externalizer

In AEM, il Externalizer è un servizio OSGI che consente di trasformare programmaticamente un percorso di risorse (ad es. /path/to/my/page) in un URL esterno e assoluto (ad esempio, https://www.mycompany.com/path/to/my/page) anteponendo il percorso a un DNS preconfigurato. Consultate Esternalizzazione di URL.

Effettuate le seguenti operazioni sia sulle istanze di creazione che di pubblicazione:

1. Andate alla configurazione OSGi all'indirizzo https://<hostname>:<port>/system/console/configMgr.

2. Individuate e toccate la configurazione Day CQ Link Externalizer.

   Viene visualizzata la finestra di dialogo Day CQ Link Externalizer (Esternalizzatore collegamento CQ Day) per modificare la configurazione.

3. Nella finestra di dialogo Day CQ Link Externalizer, nel campo Domains (Domini):

   • Nell’istanza di creazione, specificate un URL di pubblicazione a cui potete accedere da un sistema esterno. Ad esempio, un nome host o un server Web di pubblicazione.
   • Nell’istanza di pubblicazione, specificate gli URL di creazione e pubblicazione.

4. Sia nelle istanze di creazione che di pubblicazione, accertatevi che l’URL del server locale sia specificato nel campo Domini.

5. Toccate Salva. Attendi il riavvio di tutti i servizi.

Configurare il servizio di posta di CQ Day

L'implementazione del sito di riferimento richiede l'invio di e-mail agli utenti di esempio quando compilano e inviano i moduli. La configurazione di Day CQ Mail Service consente di fornire i dettagli del servizio SMTP per inviare e-mail automatizzate ai clienti. Vedere Configurazione delle notifiche e-mail.

Per configurare il servizio di posta elettronica nell’istanza di pubblicazione, effettuate le seguenti operazioni:

1. Andate alla configurazione OSGi all'indirizzo https://<hostname>:<port>/system/console/configMgr.
2. Individuate e toccate Day CQ Mail Service per aprirlo alla configurazione.
3. Specificare il nome host del server SMTP e i valori della porta.
4. Toccate Salva.

Ignora configurazione XSS predefinita

I modelli e-mail per il sito di riferimento We.Finance contengono collegamenti personalizzati nelle e-mail. Tali collegamenti hanno un segnaposto come ${placeholder}. Questi segnaposto vengono sostituiti dai valori effettivi prima dell'invio delle e-mail. La configurazione di protezione XSS predefinita per AEM non consente l'utilizzo di parentesi graffe ({ }) nell'URL nel contenuto HTML. Tuttavia, potete ignorare la configurazione predefinita eseguendo i seguenti passaggi sull’istanza di pubblicazione:

1. Copiare /libs/cq/xssprotection/config.xml in /apps/cq/xssprotection/config.xml.

2. Apri /apps/cq/xssprotection/config.xml.

3. Nella sezione common-regexps, modificare la voce onsiteURL come segue e salvare il file.

   <regexp name="onsiteURL" value="([\p{L}\p{N}\\\.\#@\$\{\}%\+&;\-_~,\?=/!\*\(\)]*|\#(\w)+)"/>

Dopo aver configurato il server SMTP, provare a compilare un modulo utilizzando il nome Sarah Rose e salvarlo come bozza. Quando salvate come bozza, potete ricevere la bozza tramite e-mail. Toccando il pulsante Invia e-mail, se si riceve un messaggio e-mail con un collegamento alla bozza dell'applicazione, la configurazione dell'e-mail viene completata correttamente. Assicurati di accedere utilizzando le credenziali di Sarah per vedere la bozza.

Configurare le impostazioni AEM DS

AEM le impostazioni del servizio DS sono richieste nell'istanza Pubblica per le comunicazioni e-mail nei casi di utilizzo del sito di riferimento. Per i passaggi dettagliati per configurare AEM configurazione del servizio DS nell'istanza Pubblica, vedere Configurare AEM impostazioni DS.

Per siti di riferimento AEM Forms, in AEM DS Settings Service, specificate l'URL del server di pubblicazione invece dell'URL del server di elaborazione.

Distribuzione di pacchetti di siti di riferimento

Installate i seguenti pacchetti di siti di riferimento tramite Distribuzione software.

• AEM-FORMS-6.4-FSI-REF-SITE
• AEM-FORMS-6.4-GOV-REF-SITE

Per ulteriori informazioni sull'utilizzo dei pacchetti, vedere Come utilizzare i pacchetti.

Dopo aver installato i pacchetti e avviato le istanze di creazione e pubblicazione, visitate i seguenti URL nel browser:

• https://[server]:[port]/wegov
• https://[server]:[port]/wefinance

Se l'installazione ha esito positivo, potete accedere alle pagine di destinazione dei siti di riferimento We.Gov e We.Finance.

(Facoltativo) Importa dati di esempio in Microsoft Dynamics

I siti di riferimento dell'applicazione ipoteca principale e dell'applicazione di assicurazione automatica sono configurati per utilizzare i record di Microsoft Dynamics. Il pacchetto del sito di riferimento installa un'entità personalizzata e record di esempio che è possibile importare in Microsoft Dynamics per eseguire il sito di riferimento. Effettuare le seguenti operazioni per migrare e impostare i dati di esempio:

Per importare l'entità personalizzata per l'applicazione di assicurazione automatica:

1. Scaricate il pacchetto della soluzione WeFinanceAutoInsurance_1_0.zip da https://[server]:[port]/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/WeFinanceAutoInsurance_1_0.zip nell'istanza AEM autore.
2. Nell'istanza di Microsoft Dynamics, andare a Soluzioni nel menu Impostazioni e fare clic su Importa. Selezionate e importate il pacchetto.

Per importare l'entità personalizzata per l'applicazione di assicurazione automatica:

1. Scaricate il pacchetto AEMFormsFSIRefsite_1_0.zip da https://[author]:[port]/content/aemforms-refsite-collaterals/we-finance/home-mortgage/ms-dynamics/AEMFormsFSIRefsite_1_0.zip. Selezionate e importate il pacchetto.

2. Nell'istanza di Microsoft Dynamics, andare a Soluzioni nel menu Impostazioni e fare clic su Importa. Selezionate e importate il pacchetto.

Per importare i record cliente e polizza assicurativa:

1. Scaricate i file di dati We.Finance Customers.csv, We.Finance Auto Insurance Renewals.csv e home Mutuo dai seguenti percorsi nell'istanza di AEM autore:

   • https://[server]:[port/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/We.Finance Customers.csv
   • https://[server]:[port/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/We.Finance Auto Insurance Renewals.csv
   • https://[server]:[port]/content/aemforms-refsite-collaterals/we-finance/home-mortgage/ms-dynamics/Sarah%20Rose%20Contact.csv

2. Nell’istanza di Microsoft Dynamics, effettuate le seguenti operazioni:

   • Vai a Vendite > We.Finance Customers e fai clic su Importa.
   • Vai a Vendite > We.Finance Auto Insurance e fai clic su Importa.
   • Vai a Vendite > We.Finance Home Mortgage e fai clic su Import.

Configurare il servizio cloud OAuth per Microsoft Dynamics

Configurare il servizio cloud OAuth in AEM Forms per abilitare la comunicazione tra AEM Forms e Microsoft Dynamics. Effettuate le seguenti operazioni per configurare l’Cloud Service OAuth sulle istanze di creazione e pubblicazione AEM:

1. Per AEM'istanza di creazione, andate a Strumenti > Cloud Services > Origini dati > globale. Toccate l'icona Refsite Dynamics Integration e toccate Properties.
2. Accedere all'account Microsoft Azure Active Directory. Aggiungete l'URL di configurazione del servizio cloud copiato nell'impostazione Rispondi all'URL per l'applicazione registrata. Salva la configurazione.
3. Nella scheda Impostazioni autenticazione, specificare Radice servizio, ID client, Segreto cliente e URL risorsa per l'istanza di Microsoft Dynamics. Fare clic su Connetti a OAuth per reindirizzare alla pagina di accesso di Microsoft Dynamics.
4. Immettete le credenziali di accesso. Una volta effettuato l'accesso, verrete reindirizzati alla pagina di configurazione del servizio cloud AEM Forms. Fai clic su Salva e chiudi. La configurazione del servizio cloud viene salvata.
5. Vai a Forms > Integrazioni dati > We.Finance. Selezionare Auto Insurance (Dynamics) e fare clic su Edit (Modifica). Le entità di Microsoft Dynamics sono elencate nella scheda Origini dati. Attendere che tutte le entità siano recuperate da Microsoft Dynamics ed elencate nella scheda origini dati.
6. Selezionare l'entità AutoInsuranceRenewal e fare clic su Oggetto modello di prova. Nella sezione della richiesta di input, specificate il valore per l'ID cliente come "900001" e fate clic su Test. Nella sezione Output vengono visualizzati i record recuperati da Microsoft Dynamics per ID cliente 900001.
7. Nella sezione della richiesta di input, specificate il valore per l'ID cliente come "900001" e fate clic su Test. Nella sezione Output vengono visualizzati i record recuperati da Microsoft Dynamics per ID cliente 900001.
8. Ripetete i passaggi da 1 a 6 sull’istanza di pubblicazione.

Configurare pianificazione Adobe Sign

Per le istanze di creazione e pubblicazione effettuate le seguenti operazioni:

1. Passate AEM console Configurazione Web all'indirizzo https://[server]:[host]/system/console/configMgr.

2. Individuate e toccate Adobe Sign Configuration Service per aprirlo alla configurazione.

3. Configurare Status Update Scheduler Expression come 0 0/2 &ast; &ast; &ast; ?.

   NOTA

   La configurazione del pianificatore di cui sopra verifica lo stato del servizio Adobe Sign ogni due minuti.

4. Toccate Salva.

Configurare il sito di riferimento servizio cloud Adobe Sign

Per le istanze di creazione e pubblicazione effettuate le seguenti operazioni:

1. Vai a Strumenti > Cloud Services > Adobe Sign > globale. Selezionare AEM Forms Reference Site Sign e toccare Properties.

   ATTENZIONE

   Accertatevi che l'URL https://[host]:[ssl_port]/mnt/overlay/adobesign/cloudservices/adobesign/properties.html sia aggiunto all'elenco degli URL di reindirizzamento della configurazione OAuth dell'applicazione API Adobe Sign.

2. Specificate l'ID client e il segreto della configurazione OAuth dell'applicazione Adobe Sign .

3. (Facoltativo) Selezionare l'opzione Abilita Adobe Sign per gli allegati anche, quindi toccare Connetti a Adobe Sign. Aggiunge i file allegati a un modulo adattivo al documento Adobe Sign corrispondente inviato per la firma.

4. Toccate Connetti a Adobe Sign ed effettuate l'accesso con le credenziali Adobe Sign.

Configurare Forms Common Configuration Service

Effettuate le seguenti operazioni nell’istanza di pubblicazione per consentire l’accesso agli utenti anonimi:

1. Passate AEM console Configurazione Web all'indirizzo https://[server]:[port]/system/console/configMgr.
2. Trovare e toccare Forms Common Configuration Service per aprirlo alla configurazione.
3. Configurare il campo Consenti per Tutti gli utenti.
4. Toccate Salva.

Modifica servizio di riposo per il modello dati modulo

Per le istanze di creazione e pubblicazione effettuate le seguenti operazioni:

1. Passate a CRXDE all'indirizzo https://[server]:[port]/crx/de/index.jsp.
2. Andate a /conf/global/settings/cloudconfigs/fdm/roi-rest/jcr:content/swaggerFile e aprite il file swagger.
3. Aggiornate le impostazioni di host e porta in base all'ambiente in uso.
4. Salvate le impostazioni.
5. (Solo istanza Author) Passare a Strumenti > Cloud Services > Origini dati > globale. Selezionare roi-rest e toccare Properties. Toccate Impostazioni autenticazione e impostate Tipo di autenticazione su Autenticazione di base. Specificare admin/ admincome nome utente/password per accedere al servizio. Toccate Save and Close (Salva e chiudi).

Integrazione con il Marketing Cloud

È possibile integrare il AEM Forms con Adobe Analytics e Adobe Target. Adobe Analytics consente di generare report e analizzare le prestazioni dei moduli adattivi, mentre Adobe Target consente di distribuire esperienze personalizzate ed eseguire test A/B per i moduli adattivi.

Effettuate le seguenti operazioni per configurare Adobe Analytics e Adobe Target AEM Forms.

Configurare Adobe Analytics

'integrazione AEM Forms con Adobe Analytics consente di monitorare e analizzare in che modo i clienti interagiscono con moduli e documenti. Consente di identificare e risolvere le aree problematiche e di agire per aumentare il tasso di conversione.

Per provare questa funzionalità nel sito di riferimento, configura il tuo account Analytics come descritto in Configurazione di analisi e report.

Per generare un rapporto, i dati iniziali vengono raggruppati con i siti di riferimento. Prima di utilizzare i dati iniziali, effettuate le seguenti operazioni:

1. Verifica che le configurazioni di analisi We.Finance e We.Gov siano disponibili nei servizi AEM Cloud. Puoi trovare i servizi cloud in uno dei seguenti modi:

   • Andate a Strumenti>Cloud Services>Cloud Services precedenti oppure individuate https://<host>:<porta>/libs/cq/core/content/tools/cloudservices.html.
   • Nella pagina Cloud Services, nella sezione Adobe Analytics fare clic su Show Configurations. Potete vedere le configurazioni We.Finance e We.Gov disponibili. Fate clic per aprire la configurazione. Nella pagina di configurazione, fare clic su Modifica. Specifica società, nome utente, segreto condiviso (password) e centro dati validi e fai clic su Connetti ad Analytics. Dopo aver ottenuto la finestra di dialogo Connessione, fare clic su OK nella finestra di dialogo di configurazione. Configurate il framework nella configurazione di Analytics come descritto in Configuring Analytics and Reports (Configurazione di Analytics e Reporting).

2. Andate su https://<host>:<port>/system/console/configMgr ed effettuate le seguenti operazioni:

   • Nella pagina Configurazione console Web, individua e fai clic su Configurazione AEM Forms Analytics.
   • Nel campo Framework di SiteCatalyst della finestra di dialogo Configurazione AEM Forms Analytics , selezionate we-finance(we-finance) o we-gov(we-gov).
   • Fare clic su Salva e consentire l'aggiornamento della pagina.

3. Passare a Forms Manager all'indirizzo https://<host>:<porta>/aem/forms ed effettuare le seguenti operazioni:

   • Aprite la cartella We.Finance o We.Gov e selezionate il modulo per il quale desiderate visualizzare il rapporto.
   • Fate clic su Abilita analisi nella barra degli strumenti Azioni. Dopo aver attivato l'analisi del modulo, fai clic su Rapporto analisi. Potete visualizzare un rapporto vuoto generato. Dopo la generazione di un report vuoto, devi fornire i dati iniziali forniti con il pacchetto refsite per generare report di analisi a scopo dimostrativo.

   I siti di riferimento forniscono report di analisi con dati iniziali per i casi di utilizzo di carte di credito, ipoteche per la casa e assistenza ai bambini. Per la configurazione dei dati iniziali, vedere We.Finance site walkthrough and We.Gov sito di riferimento walkthrough.

Configurare Target

Il sito di riferimento mostra l'integrazione di AEM Forms con Adobe Target che consente di includere contenuti mirati e personalizzati nei documenti adattivi. Consente inoltre di creare test A/B per i moduli adattivi.

Per provare l'integrazione nel sito di riferimento, effettuate le seguenti operazioni per configurare Target in AEM:

1. Avviate l'avvio rapido dell'autore con l'argomento jvm -Dabtesting.enabled=true per abilitare il test A/B sul server.

   Nota: Se l'istanza AEM è in esecuzione su JBoss, che viene avviata come servizio dall'installazione di Turnkey, aggiungere il -Dabtesting.enabled=true parametro nella seguente voce del jboss\bin\standalone.conf.bat file:

   set "JAVA_OPTS=%JAVA_OPTS% -Dadobeidp.serverName=server1 -Dfile.encoding=utf8 -Djava.net.preferIPv4Stack=true -Dabtesting.enabled=true"

2. Accedete a https://<hostname>:<port>/libs/cq/core/content/tools/cloudservices.html.

3. Nella sezione Adobe Target, fare clic su Mostra configurazioni. È possibile visualizzare la configurazione di destinazione We.Finance disponibile. Fate clic per aprire la configurazione. Nella pagina di configurazione, fare clic su Modifica. Viene visualizzata la finestra di dialogo Edit Component per la configurazione.

4. Specifica il codice cliente, l'e-mail e la password associati all'account Target. Selezionare il tipo di API come REST.

5. Fare clic su Connetti per destinazione Adobe. Una volta configurato l'account Target, fate clic su OK. Potete vedere che la configurazione del pacchetto include un framework di Target.

6. Andate a https://<hostname>:<port>/system/console/configMgr.

7. Fate clic su AEM Forms Target Configuration.

8. Selezionate un framework Target.

9. Nel campo URL di destinazione, specificate l'URL per AEM Forms. Ad esempio: https://<hostname>:<port>.

10. Fai clic su Salva.

I casi di utilizzo di applicazioni con carta di credito e applicazioni con ipoteche domestiche dimostrano come eseguire test A/B e presentare un rapporto a scopo dimostrativo. Per informazioni dettagliate, vedere Sito di riferimento We.Finance in corso.

Passaggio successivo

Ora siete tutti impostati per esplorare il sito di riferimento. Per ulteriori informazioni sul flusso di lavoro e i passaggi del sito di riferimento, vedi:

• Procedura dettagliata sul sito di riferimento We.Finance

• Procedura dettagliata sul sito di riferimento We.Gov

• Procedura dettagliata sul sito di riferimento self-service dei dipendenti