Utilizzo di DocuSign con un modulo adattivo integrate-aem-forms-with-DocuSign

Clona il progetto AEM Forms as a Cloud Service o crea un progetto Experience Manager Forms come progetto Cloud Service basato su AEM Archetipo 27 o versione successiva. Per creare un Experience Manager Forms come progetto Cloud Service basato su Archetipo AEM:

Aprire il prompt dei comandi ed eseguire il comando seguente per creare un progetto as a Cloud Service Experience Manager Forms:

mvn -B archetype:generate -DarchetypeGroupId=com.adobe.aem -DarchetypeArtifactId=aem-project-archetype -DarchetypeVersion=27 -DaemVersion="cloud" -DappTitle="My Site" -DappId="mysite" -DgroupId="com.mysite" -DincludeForms="y"

Inoltre, modifica appTitle, appId e groupId nel comando precedente per riflettere l'ambiente.

Clona l'archivio aem-forms-samples. Questo archivio contiene l'azione di invio personalizzata per DocuSign e i dettagli di configurazione per la connessione al server DocuSign.

Apri l’as a Cloud Service progetto AEM Forms creato nel passaggio 1 per la modifica nell’IDE che preferisci.

Apri il file [AEM Forms as a Cloud Service project]\pom.xml per la modifica e apporta le seguenti modifiche:

1. Aggiungere il testo seguente alla fine del tag <properties>:

   code language-shell
   <repository.location>maven_repository</repository.location>

2. Aggiungere il testo seguente alla fine del tag <repositories>:

   code language-shell
   <repository> <id>project-repository</id> <url>file://${project.basedir}/${repository.location}</url> </repository>

   Se non è presente alcun tag <repositories>, creare il tag sotto il tag <properties>.

3. Aggiungere il testo seguente alla fine del tag <dependencyManagement>:

   code language-shell
   <dependency> <groupId>com.adobe.aemforms.samples</groupId> <artifactId>forms.integration.docusign.all</artifactId> <type>zip</type> <version>1.0.0</version> </dependency>

Eseguire i passaggi seguenti nel file all/pom.xml disponibile nella cartella dei progetti di Cloud Service:

1. Aggiungere il testo seguente alla fine del tag <embeddeds>:

   code language-shell
   <embedded> <groupId>com.adobe.aemforms.samples</groupId> <artifactId>forms.integration.docusign.all</artifactId> <type>zip</type> <target>/apps/moonlightprodprogram-vendor-packages/application/install</target> </embedded>

2. Aggiungere il testo seguente alla fine del tag <dependencies>:

   code language-shell
   <dependency> <groupId>com.adobe.aemforms.samples</groupId> <artifactId>forms.integration.docusign.all</artifactId> <type>zip</type> </dependency>

Aprire il prompt dei comandi, passare a aem-forms-samples\forms-integration-docusign (clonato nel passaggio 3) ed eseguire il comando seguente:

mvn clean install -Dinstall.dir="<AEM Forms as a Cloud Service project path>/maven_repository"

<AEM Forms as a Cloud Service project path> fa riferimento al nome della cartella creata nel passaggio 1 di questa procedura.

Implementa il progetto nell’ambiente di sviluppo locale. Puoi utilizzare il seguente comando per distribuire nell’ambiente di sviluppo locale

mvn -PautoInstallPackage clean install

Dopo aver eseguito questi passaggi, puoi visualizzare una nuova azione di invio personalizzata Invia con le firme elettroniche DocuSign disponibile nell'elenco delle opzioni di invio per un modulo adattivo e una configurazione del servizio cloud DocuSign nell'ambiente di sviluppo locale.

Compila e distribuisci il codice nel tuo AEM Forms ambiente as a Cloud Service.

Passa a Strumenti > Cloud Service > DocuSign e seleziona una cartella per ospitare la configurazione.

Nella pagina Configurazioni, seleziona Crea per creare la configurazione DocuSign in AEM Forms.

Nella scheda Generale della pagina Crea configurazione DocuSign, specificare Nome per la configurazione e selezionare Avanti. Facoltativamente, puoi specificare un Titolo.

Copiare l'URL nella finestra del browser corrente in un blocco note. L'URL è necessario per configurare l'applicazione DocuSign con AEM Forms in un passaggio successivo.

Configurare le impostazioni OAuth per l'applicazione DocuSign:

1. Apri una finestra del browser e accedi al tuo account DocuSign sviluppatore.
2. Apri l'app configurata per AEM Forms.
3. Nella casella URI reindirizzamento aggiungere l'URL copiato nel passaggio precedente e fare clic su Salva.
4. Prendi nota dell’integrazione e delle chiavi segrete.

Per informazioni dettagliate su come configurare le impostazioni OAuth per un'applicazione DocuSign e ottenere le chiavi, vedere Configurare le impostazioni OAuth per la documentazione per gli sviluppatori dell'applicazione.

Tornare alla pagina Crea configurazione DocuSign. Nella scheda Impostazioni, il campo URL OAuth fa riferimento al seguente URL predefinito:

https://account-d.docusign.com/oauth/auth

Specificare ID client (chiave di integrazione DocuSign) e Segreto client (chiave segreta DocuSign).

Selezionare Connetti a DocuSign. Quando vengono richieste le credenziali, specificare il nome utente e la password dell'account utilizzato durante la creazione dell'applicazione DocuSign. Quando viene richiesto di confermare l'accesso per your developer account, fare clic su Consenti accesso. Se le credenziali sono corrette, viene visualizzato un messaggio di operazione riuscita.

Seleziona Crea per creare la configurazione di DocuSign.

Seleziona la configurazione e fai clic su Publish, seleziona la configurazione e fai clic su Publish. Replica la configurazione negli ambienti di pubblicazione corrispondenti.

Ripeti tutti i passaggi precedenti per le istanze di sviluppo, stage e produzione (qualsiasi sia rimasto) per completare la configurazione di DocuSign con AEM Forms per il tuo ambiente.

Passa a Adobe Experience Manager > Forms > Forms e documenti.

Seleziona Crea e Modulo adattivo. Viene visualizzato un elenco di modelli. Seleziona un modello e seleziona Avanti.

Nella scheda Base:

1. Specifica il Nome e il Titolo per il modulo adattivo.

2. Seleziona il contenitore di configurazione creato durante l'integrazione DocuSign con AEM Forms.

Il contenitore di configurazione contiene i DocuSign Cloud Service configurati per l'ambiente. Questi servizi sono disponibili per la selezione nell’editor di moduli adattivi.

Nella scheda Modello modulo selezionare una delle opzioni seguenti:

• Se si dispone di un modello di modulo personalizzato e si richiede un documento di record basato sul modello di modulo, selezionare l'opzione Associa modello di modulo come modello di documento record e selezionare un modello di documento record. Quando si utilizza l'opzione, i documenti inviati per la firma visualizzano solo i campi basati sul modello di modulo associato. Non visualizza tutti i campi del modulo adattivo.

• Se non si dispone di un modello di modulo personalizzato, selezionare l'opzione Genera documento di record. Quando utilizzi l’opzione, nel documento inviato per la firma vengono visualizzati tutti i campi del modulo adattivo.

Selezionare Crea. È stato creato un modulo adattivo abilitato alla firma. Puoi aggiungere i campi DocuSign al modulo e inviarlo per la firma.

Apri il modulo adattivo in modalità di modifica. Nella scheda Contenuto, seleziona Contenitore modulo e .

Nella sezione Invio, selezionare Invia con firme elettroniche DocuSign dall'elenco a discesa Azione invio.

Nella sezione Configurazione azione, seleziona Aggiungi per aggiungere un destinatario e specificare l'indirizzo e-mail del destinatario. Seleziona di nuovo Aggiungi per aggiungere altri destinatari.

Specifica l'oggetto del messaggio e-mail nel campo Oggetto e-mail. Selezionare Includi allegati per includere gli allegati nel messaggio di posta elettronica.

Seleziona per salvare le proprietà.

Passa a Adobe Experience Manager > Forms > Forms e documenti.

Seleziona il modulo adattivo e seleziona Proprietà.

Nella scheda Base, seleziona il contenitore di configurazione creato durante l'integrazione di DocuSign con AEM Forms.

Nella scheda Modello modulo selezionare una delle opzioni seguenti:

• Se si dispone di un modello di modulo personalizzato e si richiede un documento di record basato sul modello di modulo, selezionare l'opzione Associa modello di modulo come modello di documento record e selezionare un modello di documento record. Quando si utilizza l'opzione, i documenti inviati per la firma visualizzano solo i campi basati sul modello di modulo associato. Non visualizza tutti i campi del modulo adattivo.

• Se non si dispone di un modello di modulo personalizzato, selezionare l'opzione Genera documento di record. Quando utilizzi l’opzione, nel documento inviato per la firma vengono visualizzati tutti i campi del modulo adattivo.

Seleziona Salva e chiudi. Modulo adattivo abilitato per DocuSign. Ora puoi aggiungere i campi DocuSign al modulo e inviarlo per la firma.

Apri il modulo adattivo in modalità di modifica. Nella scheda Contenuto, seleziona Contenitore modulo e .

Nella sezione Invio, selezionare Invia con firme elettroniche DocuSign dall'elenco a discesa Azione invio.

Nella sezione Configurazione azione, seleziona Aggiungi per aggiungere un destinatario e specificare l'indirizzo e-mail del destinatario. Seleziona di nuovo Aggiungi per aggiungere altri destinatari.

Specifica l'oggetto del messaggio e-mail nel campo Oggetto e-mail. Selezionare Includi allegati per includere gli allegati nel messaggio di posta elettronica.

Seleziona per salvare le proprietà.