Show Menu
ARGOMENTI×

Configurare e configurare il sito di riferimento We.Gov

Dettagli del pacchetto dimostrativo

Prerequisiti per l’installazione

Questo pacchetto è stato creato per AEM Forms 6.4 OSGI Author , è stato testato ed è pertanto supportato nelle seguenti versioni della piattaforma:
VERSIONE AEM
VERSIONE DEL PACCHETTO AEM FORMS
STATO
6.4
5.0.86
Supportato
6.5
6.0.80
Supportato
Questo pacchetto contiene la configurazione cloud che supporta le seguenti versioni della piattaforma:
CLOUD FORVIDER
VERSIONE DEL SERVIZIO
STATO
Adobe Sign
API v5
Supportato
Microsoft Dynamics 365
1710 (9.1.0.3020)
Supportato
Considerazioni sull’installazione del pacchetto:
  • Il pacchetto deve essere installato su un server pulito, senza altri pacchetti demo o versioni precedenti del pacchetto demo
  • Il pacchetto deve essere installato su un server OSGI, in esecuzione in modalità Autore

Cosa include questo pacchetto

Il pacchetto demo AEM Forms We.Gov ( we-gov-forms.pkg.all-<versione>.zip ) viene fornito come pacchetto che include diversi altri pacchetti e servizi secondari. Il pacchetto include i seguenti moduli:
  • we-gov-forms.pkg.all-<versione>.zip - Pacchetto demo completo
    • we-gov-forms.ui.apps-<versione>.zip - Contiene tutti i componenti, le librerie client, gli esempi di utenti, i modelli di workflow, ecc.
      • we-gov-forms.core-<versione>.jar - Contiene tutti i servizi OSGI, implementazione personalizzata dei passaggi del flusso di lavoro, ecc.
      • core.wcm.components.all-2.0.4.zip - Raccolta di componenti WCM di esempio
      • grid-aem.ui.apps-1.0-SNAPSHOT.zip - pacchetto di layout Griglia di siti AEM per il controllo delle colonne della pagina Siti
    • we-gov-forms.ui.coentent-<versione>.zip - Contiene tutti i contenuti, le pagine, le immagini, i moduli, le risorse di comunicazione interattiva, ecc.
    • we-gov-forms.config.public-<versione>.zip - Contiene tutti i nodi di configurazione predefiniti, incluse le configurazioni cloud segnaposto per evitare modelli di dati dei moduli e problemi di binding dei servizi.
Le risorse incluse in questo pacchetto includono:
  • Pagine del sito AEM con modelli modificabili
  • AEM Forms - Moduli adattivi
  • AEM Forms Interactive Communications (Stampa e Canale Web)
  • Documento XDP di AEM Forms
  • Modello dati AEM Forms MS Dynamics Forms
  • Integrazione di Adobe Sign
  • Modello flusso di lavoro AEM
  • Immagini di esempio di AEM Assets

Opzioni di configurazione

Questa sezione include informazioni sulle opzioni di configurazione. In questa fase, questa sezione è intenzionalmente vuota.

Installazione del pacchetto dimostrativo

Questa sezione contiene informazioni sull'installazione del pacchetto dimostrativo.

Dalla condivisione del pacchetto

  1. Andate a https://<aemserver>:<porta>/crx/packageshare/
    In alternativa, in AEM, fate clic su Distribuzione e selezionate l'icona Condivisione pacchetti.
  2. Effettuate l'accesso con il vostro Adobe ID.
  3. Cercate e individuate il pacchetto we-gov-forms.pkg.all-<version> .
  4. Selezionate l'opzione "Scarica" e accettate i termini e le condizioni.
  5. Una volta scaricato, selezionate l'opzione "Scaricato" per individuare il pacchetto in Gestione pacchetti.
  6. Selezionate l'opzione "Install" per installare il pacchetto.
  7. Consentire il completamento del processo di installazione.
  8. Andate a https://<aemserver>:<porta>/content/we-gov/home.html?wcmmode=disabled per verificare che l'installazione sia stata completata correttamente.

Da un file ZIP locale

  1. Scaricate e individuate il file we-gov-forms.pkg.all-<versione>.zip .
  2. Andate a https://<aemserver>:<porta>/crx/packmgr/index.jsp .
  3. Selezionate l'opzione "Carica pacchetto".
  4. Utilizzate il browser dei file per individuare e selezionare il file ZIP scaricato.
  5. Fate clic su "Apri" per caricare.
  6. Una volta caricato il pacchetto, selezionate l'opzione "Installa" per installarlo.
  7. Consentire il completamento del processo di installazione.
  8. Andate a https://<aemserver>:<porta>/content/we-gov/home.html?wcmmode=disabled per verificare che l'installazione sia stata completata correttamente.

Installazione delle nuove versioni del pacchetto

Per installare la nuova versione del pacchetto, seguite i passaggi definiti in 4.1 e 4.2. È possibile installare una versione di pacchetto più recente mentre è già installato un altro pacchetto precedente, ma si consiglia di disinstallare prima la versione di pacchetto precedente. A tal fine, attenetevi alla procedura indicata di seguito.
  1. Andate a https://<aemserver>:<porta>/crx/packmgr/index.jsp
  2. Individuate il file we-gov-forms.pkg.all-<versione>.zip precedente.
  3. Selezionate l'opzione "Altro".
  4. Dal menu a discesa, selezionate l'opzione "Disinstalla".
  5. Al momento della conferma, selezionate di nuovo "Disinstalla" e consentite il completamento del processo di disinstallazione.

Configurazione del pacchetto dimostrativo

Questa sezione contiene informazioni e istruzioni sulla configurazione post-distribuzione del pacchetto demo prima della presentazione.

Configurazione immaginaria dell'utente

  1. Andate a https://<aemserver>:<porta>/libs/granite/security/content/groupadmin.html
  2. Cercate " workflow ".
  3. Selezionate il gruppo " workflow-users " e fate clic su "Properties".
  4. Passate alla scheda "Membri".
  5. Digitare il valore in "Seleziona utente o gruppo".
  6. Selezionate dal menu a discesa " We.Gov Form Users ".
  7. Fate clic su "Save and Close" (Salva e chiudi) nella barra dei menu.
  8. Ripetete i passaggi da 2 a 7 cercando " analytics ", selezionando il gruppo " Analytics Administrators " e aggiungendo il gruppo " We.Gov Form Users " come membro.
  9. Ripetere i passaggi da 2 a 7 cercando " Form users ", selezionando il gruppo " forms-power-users " e aggiungendo il gruppo " We.Gov Form Users " come membro.
  10. Ripetete i passaggi da 2 a 7 cercando "utenti ​dei moduli", selezionando il gruppo "utenti ​moduli" e aggiungendo il gruppo "Utenti ​We.Gov" come membro.

Configurazione server e-mail

  1. Consulta la documentazione di configurazione Configurazione delle notifiche e-mail
  2. Andate a https://<aemserver>:<porta>/system/console/configMgr
  3. Individuate e fate clic sul servizio Day CQ Mail Service da configurare.
  4. Configurare il servizio per la connessione al server SMTP di tua scelta:
    1. Nome host server SMTP: ad esempio (smtp.gmail.com)
    2. Porta server: ad esempio (465) per la posta elettronica che utilizza SSL
    3. Utente SMTP: demo@ <nome azienda> .com
    4. Indirizzo "Da": aemformsdemo@adobe.com
  5. Fate clic su "Salva" per salvare la configurazione.

Configurazione SSL AEM

Questa sezione contiene informazioni sulla configurazione di SSL nell’istanza di AEM per poter configurare la configurazione di Adobe Sign Cloud.
Riferimenti:
Note:
  1. Andate a https://<aemserver>:<porta>/aem/inbox dove potrete completare il processo descritto nel collegamento della documentazione di riferimento precedente.
  2. Il pacchetto we-gov-forms.pkg.all-<versione>.zip include una chiave SSL di esempio e un certificato a cui è possibile accedere estraendo la cartella we-gov-forms.pkg.all-<versione>.zip/ssl che fa parte del pacchetto.
  3. Certificato SSL e dettagli chiave:
    1. rilasciato a "CN=localhost"
    2. 10 anni di validità
    3. valore password di "password"

Adobe Sign cloud configuration

Questa sezione contiene informazioni e istruzioni sulla configurazione di Adobe Sign Cloud.
Riferimenti:

Cloud configuration

  1. Esaminate i prerequisiti. Consultate Configurazione SSL AEM per la configurazione SSL richiesta.
  2. Accedi a:
    https://<aemserver>:<porta>/libs/adobesign/cloudservices/adobesign.html/conf/we-gov
    L'URL utilizzato per accedere al server AEM deve corrispondere all'URL configurato nell'URI di reindirizzamento OAuth di Adobe Sign per evitare problemi di configurazione (ad esempio https://<server aemserver>:<porta>/mnt/overlay/adobesign/cloudservices/adobesign/properties.html )
  3. Selezionare la configurazione "We.gov Adobe Sign".
  4. Fare clic su "Proprietà".
  5. Passate alla scheda "Impostazioni".
  6. Immettete l’URL di autenticazione, ad esempio: https://secure.na1.echosign.com/public/oauth
  7. Fornire l'ID client e il Segreto cliente configurati dall'istanza Adobe Sign configurata.
  8. Fare clic su "Connetti ad Adobe Sign".
  9. Dopo la connessione, fate clic su "Save and Close" (Salva e chiudi) per completare l'integrazione.

Configurazione di MS Dynamics cloud

Questa sezione contiene informazioni e istruzioni sulla configurazione di MS Dynamics Cloud.
Riferimenti:

Servizio cloud MS Dynamics OData

  1. Accedi a:
    https://<aemserver>:<porta>/libs/fd/fdm/gui/components/admin/fdmcloudservice/fdm.html/conf/we-gov
    1. Assicurarsi di accedere al server utilizzando lo stesso URL di reindirizzamento configurato nella registrazione dell'applicazione MS Dynamics.
  2. Selezionare la configurazione "Microsoft Dynamics OData Cloud Service".
  3. Fare clic su "Proprietà".
  4. Passate alla scheda "Impostazioni autenticazione".
  5. Inserite i seguenti dettagli:
    1. Radice servizio: ad esempio https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
    2. Tipo di autenticazione: OAuth 2.0
    3. Impostazioni autenticazione (vedere Impostazioni di configurazione di MS Dynamics cloud per raccogliere queste informazioni):
      1. ID client - anche denominato ID applicazione
      2. Segreto client
      3. Aggiorna URL token, ad esempio https://login.windows.net/common/oauth2/token
      4. URL token di accesso, ad esempio https://login.windows.net/common/oauth2/token
      5. Ambito di autorizzazione - open id
      6. Intestazione autenticazione - Titolare autorizzazione
    4. Fate clic su "Connetti a OAuth".
  6. Dopo l'autenticazione, fate clic su "Save & Close" (Salva e chiudi) per completare l'integrazione.

Impostazioni di configurazione di MS Dynamics cloud

I passaggi descritti in questa sezione sono inclusi per individuare l'ID client, il Segreto cliente e i dettagli dall'istanza di MS Dynamics Cloud.
  1. Andate a https://portal.azure.com/ e accedete.
  2. Dal menu a sinistra selezionare "Tutti i servizi".
  3. Cerca o passa a "Registrazione app".
  4. Create o selezionate una registrazione di applicazione esistente.
  5. Copiate l'ID ​applicazione da usare come ID ​client OAuthnella configurazione cloud AEM
  6. Fate clic su "Settings" (Impostazioni) o "Manifest" (Manifest) per configurare gli URL di risposta.
    1. Questo URL deve corrispondere all’URL utilizzato per accedere al server AEM durante la configurazione del servizio OData.
  7. Nella visualizzazione Impostazioni, fate clic su "Tasti" per visualizzare la nuova chiave creata (utilizzata come Segreto cliente in AEM).
    1. Accertatevi di conservare una copia della chiave in quanto non potrete visualizzarla in seguito in Azure o AEM.
  8. Per individuare l'URL di risorsa/l'URL di directory principale del servizio, andate al dashboard dell'istanza di MS Dynamics.
  9. Nella barra di navigazione superiore, fate clic su "Vendite" o sul tipo di istanza desiderato e su "Seleziona impostazioni".
  10. Fare clic su "Personalizzazioni" e "Risorse per sviluppatori" in basso a destra.
  11. L’URL della directory principale del servizio è il seguente: ad esempio
  12. I dettagli sull'URL di aggiornamento e accesso del token sono disponibili qui:

Verifica del modello dati del modulo

Una volta completata la configurazione cloud, potrebbe essere necessario verificare il modello dati del modulo.
  1. Accedi a
    https://<aemserver>:<porta>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov
  2. Selezionate "We.gov Microsoft Dynamics CRM FDM" e selezionate "Properties".
  3. Passate alla scheda "Aggiorna origine".
  4. Assicurarsi che la "configurazione in base al contesto" sia impostata su "/conf/we-gov" e che l'origine dati configurata sia "ms-ddynamic-odata-cloud-service".
  5. Modificare il modello dati del modulo.
    Per evitare problemi che richiedono la reinstallazione, fate clic su Annulla invece di Salva e chiudi .
  6. Verificare i servizi per assicurarsi che si connettano correttamente all'origine dati configurata.
    È stato segnalato che era necessario riavviare AEM Server affinché l'origine dati si connettesse correttamente al FDM.

Configurazione del servizio cloud di Adobe Analytics

Questo pacchetto è preconfigurato per la connessione ad Adobe Analytics. Vengono forniti i seguenti passaggi per consentire l'aggiornamento di questa configurazione.
  1. Andate a https://<aemserver>:<porta>/libs/cq/core/content/tools/cloudservices.html
  2. Individuate la sezione Adobe Analytics e selezionate il collegamento "Mostra configurazioni".
  3. Selezionate la configurazione "We.Gov Adobe Analytics (Analytics Configuration)".
  4. Fate clic sul pulsante "Modifica" per aggiornare la configurazione di Adobe Analytics (sarà necessario fornire il Segreto condiviso). Fate clic su "Connetti ad Analytics" per connettersi e su "OK" per completare.
  5. Dalla stessa pagina, fate clic su "We.Gov Adobe Analytics Framework (Analytics Framework)" se desiderate aggiornare le configurazioni del framework (consultate Abilitare l'authoring AEM per abilitare l'authoring).

Report di Adobe Analytics

Visualizzazione dei rapporti sui siti di Adobe Analytics

  1. Andate a https://<aemserver>:<porta>/sites.html/content
  2. Selezionate "AEM Forms We.Gov Site" per visualizzare le pagine del sito.
  3. Selezionate una delle pagine del sito (ad esempio Home) e scegliete "Analytics & Recommendations".
  4. In questa pagina, vedrai le informazioni recuperate da Adobe Analytics relative alla pagina Siti AEM (nota: in base alla progettazione, queste informazioni vengono aggiornate periodicamente da Adobe Analytics e non vengono visualizzate in tempo reale).
  5. Tornando alla pagina di visualizzazione della pagina (a cui si accede al punto 3), è possibile visualizzare anche le informazioni di visualizzazione della pagina modificando l'impostazione di visualizzazione per visualizzare gli elementi nella "Vista a elenco".
  6. Individuate il menu a discesa "Visualizza" e selezionate "Visualizzazione elenco".
  7. Nello stesso menu, selezionate "Visualizza impostazione" e selezionate le colonne da visualizzare nella sezione "Analisi".
  8. Fare clic su "Aggiorna" per rendere disponibili le nuove colonne.

Visualizzazione dei rapporti sui moduli di Adobe Analytics

  1. Accedi a
    https://<aemserver>:<porta>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
  2. Selezionate il modulo adattivo "Iscrizione applicazione per benefici sanitari" e selezionate l'opzione "Report di Analytics".
  3. Attendete che la pagina venga caricata e visualizzate i dati del report di Analytics.

Visualizzare i rapporti di Adobe Analytics

Facoltativamente, puoi accedere direttamente ad Adobe Analytics per visualizzare i dati di analisi.
  1. Effettua l'accesso con le tue credenziali:
    1. Società: Demo su AEM Forms
    2. Utente: <disponibile su richiesta>
    3. Password: <disponibile su richiesta>
  2. Selezionate il "Sito di riferimento We.Gov" dalle suite di rapporti.
  3. Selezionare uno dei report disponibili per visualizzare i dati di analisi di tale report.

Personalizzazioni del pacchetto dimostrativo

Questa sezione include istruzioni sulla personalizzazione della demo.

Abilita creazione AEM

Questo pacchetto demo include un file di configurazione del servizio OSGI che controlla il comportamento del servizio WCM Filter sul server Author di destinazione. Questa configurazione rende il server operativo in modalità di creazione disattivata (equivalente a ?wcmmode=disabled) per consentire la dimostrazione. Per aggiornare questa configurazione e abilitare l’authoring, effettuate le seguenti operazioni:
  1. Andate a https://<aemserver>:<porta>/system/console/configMgr
  2. Individuare e fare clic sul servizio filtro CQ WCM Day per configurare.
  3. Impostate il valore di " WCM Mode " su " Edit ".
  4. Fate clic su " Salva " per applicare la configurazione.

Personalizzazione dei modelli

I modelli modificabili si trovano nel seguente percorso:
https://<aemserver>:<porta>/libs/wcm/core/content/sites/templates.html/conf/we-gov
Questi modelli includono i modelli di sito AEM, modulo adattivo e comunicazioni interattive, creati e assemblati con componenti disponibili all'indirizzo:
https://<aemserver>:<porta>/crx/de/index.jsp#/apps/we-gov/components

Style system

Questo sito include anche le librerie client, una delle quali importa Bootstrap 4 ( https://getbootstrap.com/ ). Questa libreria client è disponibile in
https://<aemserver>:<porta>/crx/de/index.jsp#/apps/we-gov/clientlibs/clientlib-base/css/bootstrap
I modelli modificabili inclusi in questo pacchetto sono inoltre preconfigurati con criteri di modello/pagina che utilizzano le classi CSS di Bootstrap 4 per l'impaginazione, lo stile e così via. Non tutte le classi sono state aggiunte ai criteri dei modelli, ma qualsiasi classe supportata da Bootstrap 4 può essere aggiunta ai criteri. Consultate la pagina iniziale per un elenco delle classi disponibili:
I modelli inclusi in questo pacchetto supportano anche Style System:

Logo del modello

Risorse DAM progetto include anche loghi e immagini We.Gov. Tali risorse sono disponibili all’indirizzo:
https://<aemserver>:<porta>/assets.html/content/dam/we-gov
Quando si modificano i modelli di pagina e di modulo, è possibile scegliere di aggiornare i logo del marchio modificando i componenti Navigazione e Piè di pagina. Questi componenti offrono una finestra di dialogo di marchio e logo configurabile che può essere utilizzata per aggiornare i logo:
Consultate Modifica del contenuto della pagina per ulteriori informazioni:

Personalizzazione delle pagine dei siti

Tutte le pagine del sito sono disponibili da: https://<aemserver>:<porta>/sites.html/content/we-gov
Queste pagine del sito utilizzano anche il pacchetto AEM Grid per controllare il layout di alcuni componenti.

Style system

Anche le pagine incluse in questo pacchetto supportano Style System:
Per la documentazione sugli stili supportati, potete anche fare riferimento al sistema di stile di personalizzazione Modelli.

Personalizzazione di moduli adattivi

Tutti i moduli adattivi sono disponibili da:
https://<aemserver>:<porta>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
Questi moduli possono essere personalizzati in base a determinati casi di utilizzo. Tenere presente che alcuni campi e la logica di invio non devono essere modificati per garantire il corretto funzionamento del modulo. Ciò include:
Domanda Di Iscrizione Per Prestazioni Sanitarie:
  • contact_id - Campo nascosto utilizzato per ricevere l'ID contatto di MS Dynamics durante l'invio
  • Invia - La logica del pulsante Invia richiede la personalizzazione per supportare le callback. La personalizzazione è documentata, ma era necessario uno script di grandi dimensioni per inviare il modulo durante l'esecuzione di un'operazione POST e GET a MS Dynamics tramite Forms Data Model.
  • Pannello principale - L'evento Initialize viene utilizzato per aggiungere un pulsante MS Dynamics alla Casella in entrata AEM nel modo meno invadente possibile, poiché tutti i componenti dell'interfaccia Granite di AEM Inbox non sono modificabili.

Stile modulo adattivo

I moduli adattivi possono essere formattati anche utilizzando l'Editor di stile o l'Editor tema:

Personalizzazione del flusso di lavoro

Il modulo adattivo per l’iscrizione può essere inviato a un flusso di lavoro OSGI per l’elaborazione. Questo flusso di lavoro si trova in https://<aemserver>:<porta>/conf/we-gov/settings/models/we-gov-process.html .
A causa di alcune limitazioni, questo flusso di lavoro contiene diversi script e passaggi personalizzati del processo di flusso di lavoro OSGI. Questi passaggi del flusso di lavoro sono stati creati come passaggi generici e non sono stati creati con le finestre di dialogo di configurazione. Al momento, la configurazione dei passaggi del flusso di lavoro si basa sugli argomenti del processo.
Tutto il codice Java del passaggio del flusso di lavoro è contenuto nel pacchetto we-gov-forms.core-<versione>.jar .

Considerazioni dimostrative e problemi noti

Questa sezione contiene informazioni sulle funzioni dimostrative e sulle decisioni di progettazione che potrebbero richiedere considerazioni speciali durante il processo di dimostrazione.

Considerazioni sulla demo

  • Come da AGRS-159, assicurarsi che il nome (primo, intermedio e ultimo) del contatto utilizzato nel modulo adattivo per l'iscrizione sia univoco.
  • Il modulo adattivo per l'iscrizione invierà l'e-mail di Adobe Sign all'indirizzo specificato nel campo e-mail del modulo. Tale indirizzo e-mail non può essere lo stesso indirizzo e-mail utilizzato per configurare la configurazione cloud di Adobe Sign.
  • Per impostazione predefinita, il pacchetto demo include diverse configurazioni di servizio OSGI per controllare il comportamento complessivo del server di destinazione che ospita la demo. Queste configurazioni includono una configurazione del servizio filtro WCM che per impostazione predefinita rende il server operativo in modalità di creazione ​disabilitata (equivalente a ?wcmmode=disabled). Consultate Abilitare l’authoring AEM per consentire l’authoring delle pagine.

Problemi noti

  • (AGRS-120) Il componente Navigazione siti attualmente non supporta pagine figlie nidificate con profondità superiore a 2 livelli.
  • (AGRS-159) L'FDM corrente di MS Dynamics deve eseguire due operazioni per prima, POST i dati del modulo adattivo per l'iscrizione a Dynamics, quindi recuperare il record utente per recuperare l'ID contatto. Nel suo stato corrente, il recupero dell'ID contatto avrà esito negativo se più di due utenti con lo stesso nome sono presenti in Dynamics, il che non consentirà l'invio del modulo adattivo per l'iscrizione.

Passaggi successivi

Ora siete tutti pronti per esplorare il sito di riferimento We.Gov. Per ulteriori informazioni sul flusso di lavoro e i passaggi del sito di riferimento We.Gov, consulta la procedura dettagliata del sito di riferimento We.Gov.