Configurare e configurare i siti di riferimento di AEM Forms

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

I siti di riferimento We.Finance e We.Gov richiamano casi d'uso reali per interagire con clienti esistenti e potenziali, dal momento del primo contatto alla gestione di corrispondenze e transazioni in modo personalizzato ed economico.

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

  • Esperienza di authoring semplificata per moduli adattivi coinvolgenti e reattivi e comunicazioni interattive.
  • Comunicazioni interattive per creare comunicazioni cliente interattive, personalizzate e reattive che si adattano all'impostazione e al layout del dispositivo.
  • Integrazione dei dati per connettersi a diverse origini dati per precompilare e inviare i dati del modulo tramite un modello di dati del modulo.
  • Flusso di lavoro Forms per automatizzare i processi e i flussi di lavoro aziendali.
  • Funzionalità avanzate di gestione ed elaborazione dei dati utente.
  • Integrazione con Adobe Sign per la firma e l’invio sicuri di moduli adattivi.
  • Integrazione con Adobe Target per distribuire consigli mirati ed eseguire test A/B per massimizzare 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 migliorata di compilazione dei moduli.

I siti di riferimento forniscono risorse riutilizzabili che possono essere utilizzate come modelli per creare risorse personalizzate.

  • Integrazione con Adobe Sign per la firma e l’invio sicuri di moduli adattivi.

  • Integrazione con Adobe Sign per la firma e l’invio sicuri di moduli adattivi.

Prerequisiti e passaggi per configurare siti di riferimento

Prima di configurare il sito di riferimento, assicurarsi 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, consulta Versioni 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 un account sviluppatore Adobe Sign. Consulta 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 pacchetto aggiuntivo Forms. Per ulteriori informazioni, consulta Installazione e configurazione di AEM Forms.

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

Incremento Configurazione Note
Installare e configurare AEM Forms Creazione e pubblicazione Installa e configura le istanze di authoring e pubblicazione di AEM Forms.
Configurare SSL Creazione e pubblicazione
 Abilita HTTP su SSL per comunicazioni sicure con Adobe Sign.

Configurare la configurazione Day CQ Link Externalizer

 Creazione e pubblicazione

I casi di utilizzo del sito di riferimento forniscono e-mail per transazioni diverse. Questa impostazione è necessaria per la consegna della newsletter tramite e-mail. Gli URL e le immagini puntano all’istanza di pubblicazione.

Configura il servizio di posta CQ Day Creazione e pubblicazione Obbligatorio per la comunicazione via e-mail.
Ignora configurazione XSS predefinita Pubblicazione Utilizzato per sostituire i caratteri $, { e } bloccati dalla sicurezza xss.
Configurare le impostazioni di AEM DS Autore Configura AEM DS per l’invio del modulo sull’istanza di pubblicazione e per l’elaborazione dei flussi di lavoro sull’istanza di authoring.
Distribuire pacchetti di siti di riferimento Autore Distribuisci pacchetti di siti di riferimento sull’istanza di authoring di AEM Forms.
Importare dati di esempio in Microsoft Dynamics Creazione e pubblicazione Importazione di dati di esempio per l'applicazione di carte di credito, l'applicazione di mutui per la casa e l'applicazione di assicurazione per la casa procedura dettagliata
Configurare il servizio cloud OAuth per Microsoft Dynamics Creazione e pubblicazione Configura il servizio cloud OAuth in AEM Forms per abilitare la comunicazione tra AEM Forms e Microsoft Dynamics.
Configurare Adobe Sign Scheduler Creazione e pubblicazione
 Modifica la configurazione della pianificazione per controllare lo stato ogni due minuti.
Configurare l’Cloud Service Adobe Sign del sito di riferimento Creazione e pubblicazione
 Configurazione fornita con pacchetti di siti di riferimento e che richiede la riconfigurazione con credenziali valide.
Configurazione del servizio di configurazione comune Forms per gli utenti anonimi Pubblicazione La configurazione consente l’invio, la firma e la generazione di documenti di record per gli utenti anonimi.
Modificare il file Swagger del servizio residuo per il modello dati del modulo Creazione e pubblicazione
 Modifica il servizio per il tuo ambiente.

Installare e configurare AEM Forms

Installa e distribuisci AEM Forms come descritto in Installazione e configurazione di AEM Forms su OSGi.

NOTA

Configura gli agenti di replica e di replica inversa se ci sono più istanze di pubblicazione o di authoring e pubblicazione su computer diversi.

Configurare SSL

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

ATTENZIONE

Non configurare la forza SSL sulla cartella /etc/map .

Configurare la configurazione Day CQ Link Externalizer

In AEM, il esternalizzatore è un servizio OSGI che consente di trasformare programmaticamente un percorso di risorsa (ad esempio, /path/to/my/page) in un URL esterno e assoluto (ad esempio, https://www.mycompany.com/path/to/my/page) prefissando il percorso con un DNS preconfigurato. Consulta Eternalizzazione degli URL.

ATTENZIONE

Non esternalizzare l’URL HTTPS se utilizzi un certificato autofirmato per SSL.

Inoltre, utilizza localhost invece del relativo nome host per il server locale.

Esegui i seguenti passaggi sia sulle istanze di creazione che di pubblicazione:

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

  2. Trova e tocca la configurazione Day CQ Link Externalizer .

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

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

    • Nell’istanza di authoring, specifica un URL di pubblicazione a cui è possibile accedere da un sistema esterno. Ad esempio, un nome host o un server Web di pubblicazione.
    • Nell’istanza di pubblicazione, specifica gli URL di authoring e di pubblicazione.

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

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

Configura il servizio di posta CQ Day

L’implementazione del sito di riferimento richiede l’invio di e-mail agli utenti di esempio al momento della compilazione e dell’invio dei moduli. La configurazione di Day CQ Mail Service consente di fornire i dettagli del servizio SMTP per inviare e-mail automatizzate ai clienti. Consulta Configurazione delle notifiche e-mail.

Esegui i seguenti passaggi per configurare il servizio di posta nell’istanza di pubblicazione:

  1. Vai alla configurazione OSGi all'indirizzo https://<hostname>:<port>/system/console/configMgr.
  2. Trova e tocca Day CQ Mail Service per aprirlo per la configurazione.
  3. Fornire i valori dell’host del server SMTP e della porta.
  4. Tocca Salva.
NOTA

Puoi utilizzare il tuo servizio SMTP aziendale o i servizi pubblici come Gmail. Per la configurazione del servizio SMTP, vedere la documentazione del servizio SMTP.

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 parentesi graffe ({ }) nell’URL nel contenuto HTML. Tuttavia, puoi ignorare la configurazione predefinita eseguendo i seguenti passaggi sull’istanza di pubblicazione:

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

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

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

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

NOTA

Le parentesi graffe ({ }) sono incluse come caratteri accettati nell’URL nel contenuto HTML.

Dopo aver configurato il server SMTP, prova a compilare un modulo utilizzando la persona Sarah Rose e salvalo come bozza. Quando salvi come bozza, ottieni un’opzione per ricevere la bozza utilizzando l’e-mail. Toccando il pulsante Invia e-mail, se ricevi un’e-mail con un collegamento alla bozza dell’applicazione, la configurazione dell’e-mail avrà esito positivo. Assicurati di accedere utilizzando le credenziali di Sarah per visualizzare la bozza.

Configurare le impostazioni di AEM DS

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

Per i siti di riferimento AEM Forms, nel servizio Impostazioni DS AEM, specifica l'URL del server di pubblicazione invece dell'URL del server di elaborazione.

ATTENZIONE

Non inserire /lc nell'URL del server di elaborazione se lo stai configurando per AEM Forms OSGi.

Distribuire pacchetti di siti di riferimento

Installa i seguenti pacchetti siti di riferimento utilizzando Distribuzione di software.

Per ulteriori informazioni sull'utilizzo dei pacchetti, consulta Come lavorare con i pacchetti.

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

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

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

(Facoltativo) Importare dati di esempio in Microsoft Dynamics

I siti di riferimento dell’applicazione di mutuo per la casa 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. Esegui i seguenti passaggi per eseguire la migrazione e impostare i dati di esempio:

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

  1. Scarica 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 nella tua istanza di authoring AEM.
  2. Nell’istanza di Microsoft Dynamics, vai a Soluzioni nel menu Impostazioni e fai clic su Importa. Seleziona e importa il pacchetto.

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

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

  2. Nell’istanza di Microsoft Dynamics, vai a Soluzioni nel menu Impostazioni e fai clic su Importa. Seleziona e importa il pacchetto.

Per importare i record dei contratti di assicurazione e cliente:

  1. Scarica i file di dati We.Finance Customers.csv, We.Finance Auto Insurance Renewals.csv e home Mutuo dalle seguenti posizioni nell'istanza di authoring AEM:

    • 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, procedi come segue:

    • Vai a Vendite > Clienti We.Finance e fai clic su Importa.
    • Vai a Vendite > Assicurazione automatica We.Finance e fai clic su Importa.
    • Vai a Vendite > We.Finance Home Mutui e fai clic su Importa.

Configurare il servizio cloud OAuth per Microsoft Dynamics

Configura il servizio cloud OAuth in AEM Forms per abilitare la comunicazione tra AEM Forms e Microsoft Dynamics. Esegui i seguenti passaggi per configurare il Cloud Service OAuth su AEM istanze di authoring e pubblicazione:

  1. Nell'istanza AEM autore, vai a Strumenti > Cloud Services > Origini dati > globale. Tocca l’icona Rifiuta integrazione Dynamics e tocca Proprietà.
  2. Passa all’account Microsoft Azure Active Directory. Aggiungi l'URL di configurazione del servizio cloud copiato nell'impostazione URL di risposta per l'applicazione registrata. Salva la configurazione.
  3. Nella scheda Impostazioni autenticazione , specifica Directory principale del servizio, ID client, Segreto client e URL risorsa per l’istanza di Microsoft Dynamics. Fai clic su Connetti a OAuth per reindirizzare alla pagina di accesso di Microsoft Dynamics.
  4. Immetti le credenziali di accesso. Una volta effettuato l’accesso, verrai reindirizzato 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 Assicurazione automatica (Dynamics) e fare clic su Modifica. Le entità di Microsoft Dynamics sono elencate nella scheda Origini dati . Attendi che tutte le entità vengano recuperate da Microsoft Dynamics ed elencate nella scheda origini dati.
  6. Selezionare l'entità AutoInsuranceRenewal e fare clic su Oggetto modello di test. Nella sezione della richiesta di input, specifica il valore per l’ID cliente come "900001" e fai clic su Test. Nella sezione Output vengono visualizzati i record recuperati da Microsoft Dynamics per l’ID cliente 90001.
  7. Nella sezione della richiesta di input, specifica il valore per l’ID cliente come "900001" e fai clic su Test. Nella sezione Output vengono visualizzati i record recuperati da Microsoft Dynamics per l’ID cliente 90001.
  8. Ripeti i passaggi 1-6 sull’istanza di pubblicazione.

Configurare Adobe Sign Scheduler

Esegui le seguenti operazioni sia sulle istanze di authoring che di pubblicazione:

  1. Vai AEM console Configurazione web in https://[server]:[host]/system/console/configMgr.

  2. Trova e tocca Servizio di configurazione Adobe Sign per aprirlo per la configurazione.

  3. Configura espressione pianificazione aggiornamento stato come 0 0/2 * * * ?.

    NOTA

    La configurazione di pianificazione di cui sopra controlla lo stato del servizio Adobe Sign ogni due minuti.

  4. Tocca Salva.

Configurare il sito di riferimento Adobe Sign Cloud Service

Esegui le seguenti operazioni sia sulle istanze di authoring che di pubblicazione:

  1. Vai a Strumenti > Cloud Services > Adobe Sign > globale. Seleziona AEM Forms Reference Site Sign e tocca Proprietà.

    ATTENZIONE

    Accertati 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. Specifica l’ID client e il segreto della configurazione OAuth dell’applicazione Adobe Sign.

  3. (Facoltativo) Selezionare anche l'opzione Abilita Adobe Sign per gli allegati e toccare Connetti ad Adobe Sign. Aggiunge i file allegati a moduli adattivi al documento Adobe Sign corrispondente inviato per la firma.

  4. Tocca Connetti ad Adobe Sign e accedi con le tue credenziali Adobe Sign.

Configurare il servizio di configurazione comune Forms

Per consentire l’accesso agli utenti anonimi, procedi come segue nell’istanza di pubblicazione:

  1. Vai AEM console Configurazione web in https://[server]:[port]/system/console/configMgr.
  2. Trova e tocca Servizio di configurazione comune Forms per aprirlo per la configurazione.
  3. Configura il campo Consenti per Tutti gli utenti.
  4. Tocca Salva.

Modifica del servizio di riposo per il modello dati del modulo

Esegui le seguenti operazioni sia sulle istanze di authoring che di pubblicazione:

  1. Vai a CRXDE in https://[server]:[port]/crx/de/index.jsp.
  2. Passa a /conf/global/settings/cloudconfigs/fdm/roi-rest/jcr:content/swaggerFile e apri il file swagger.
  3. Aggiorna le impostazioni dell'host e della porta in base all'ambiente.
  4. Salva le impostazioni.
  5. (Solo istanza autore) Vai a Strumenti > Cloud Services > Origini dati > globale. Seleziona roi-rest e tocca Proprietà. Tocca Impostazioni di autenticazione e imposta Tipo di autenticazione su Autenticazione di base. Specifica admin/ admincome nome utente/password per accedere al servizio. Tocca Salva e chiudi.

Integrare con il Marketing Cloud

Puoi integrare AEM Forms con Adobe Analytics e Adobe Target. Mentre Adobe Analytics consente di generare rapporti e analizzare le prestazioni dei moduli adattivi, Adobe Target consente di fornire esperienze personalizzate ed eseguire test A/B per i moduli adattivi.

Per configurare Adobe Analytics e Adobe Target in AEM Forms, procedi come segue.

Configurare Adobe Analytics

L’integrazione di AEM Forms con Adobe Analytics consente di monitorare e analizzare il modo in cui i clienti interagiscono con i moduli e i documenti. Ti aiuta a identificare e correggere le aree problematiche e ad agire per aumentare il tasso di conversione.

Per utilizzare questa funzionalità nel sito di riferimento, configura l'account Analytics come descritto in Configurazione di analytics e report.

Per generare un rapporto, i dati seed vengono raggruppati con i siti di riferimento. Prima di utilizzare i dati di seed, procedi come segue:

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

    • Passa a Strumenti>Cloud Services>Cloud Services legacy o passa a https://<host>:<port>/libs/cq/core/content/tools/cloudservices.html.
    • Nella pagina Cloud Services, nella sezione Adobe Analytics , fai clic su Show Configurations. Puoi vedere le configurazioni We.Finance e We.Gov disponibili. Fai clic su per aprire la configurazione. Nella pagina di configurazione, fai clic su Modifica. Fornisci una società, un nome utente, un segreto condiviso (password) e un centro dati validi e fai clic su Connetti ad Analytics. Una volta visualizzata la finestra di dialogo Connessione, fare clic su OK nella finestra di dialogo di configurazione. Configura il framework nella configurazione di Analytics come descritto in Configurazione di Analytics e Reports.

  2. Passa a https://<host>:<porta>/system/console/configMgr e procedi come segue:

    • Nella pagina Configurazione console Web, trova e fai clic su Configurazione AEM Forms Analytics.
    • Nel campo Framework di SiteCatalyst della finestra di dialogo Configurazione di AEM Forms Analytics, seleziona we-finance(we-finance) o we-gov(we-gov).
    • Fai clic su Salva e lascia che la pagina venga aggiornata.

  3. Passa a Forms Manager all’indirizzo https://<host>:<port>/aem/forms ed effettua le seguenti operazioni:

    • Aprire la cartella We.Finance o We.Gov e selezionare il modulo per il quale si desidera visualizzare il rapporto.
    • Fai clic su Abilita Analytics nella barra degli strumenti Azioni. Dopo aver abilitato Analytics per il modulo, fai clic su Rapporto Analytics . È possibile visualizzare un rapporto vuoto generato. Dopo aver generato un rapporto vuoto, devi fornire i dati seed forniti con pacchetto refsite per generare un rapporto di analisi a scopo dimostrativo.

    I siti di riferimento forniscono rapporti di analisi con dati iniziali per i casi di utilizzo di carte di credito, mutui per la casa e assistenza ai bambini. Per la configurazione dei dati di seed, consulta la procedura dettagliata sul sito di riferimento We.Finance🔗 e la procedura dettagliata sul sito di riferimento We.Gov .🔗

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, procedi come segue per configurare Target in AEM:

  1. Avvia 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 avviato come servizio dall'installazione di Turnkey, aggiungi il -Dabtesting.enabled=true parametro nella seguente voce nel 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. Accedi a https://<hostname>:<port>/libs/cq/core/content/tools/cloudservices.html.

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

  4. Specifica il codice client, l’e-mail e la password associati all’account Target. Seleziona il tipo API come REST.

  5. Fare clic su Connetti a destinazione Adobe. Una volta configurato correttamente l'account Target, fai clic su OK. Puoi vedere che la configurazione del pacchetto ha un framework di Target.

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

  7. Fai clic su Configurazione di AEM Forms Target.

  8. Seleziona un framework di Target.

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

  10. Fai clic su Salva.

I casi d'uso di applicazioni con carta di credito e ipoteche domestiche dimostrano come eseguire test A/B e mostrare un rapporto a scopo dimostrativo. Per informazioni dettagliate, consulta Procedura dettagliata sul sito di riferimento We.Finance.

Passaggio successivo

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

In questa pagina