Utilizzo di DocuSign con un modulo adattivo

DocuSign è una soluzione di firma elettronica importante. È possibile utilizzarlo per firmare un accordo tramite posta elettronica. È possibile integrare DocuSign con un modulo adattivo. Consente di inviare un modulo adattivo per le firme elettroniche a più destinatari. L’utilizzo delle firme elettroniche consente di:

• Chiudere le offerte da qualsiasi dispositivo con procedure di proposta, preventivo e contratto completamente automatizzate.
• Completa i processi relativi alle risorse umane più rapidamente e offri ai tuoi dipendenti le esperienze digitali.
• Ridurre i tempi di ciclo del contratto e integrare i fornitori più rapidamente.

AEM Forms as a Cloud Service fornisce azione di invio personalizzata per DocuSign. L’azione invia consente di inviare i moduli adattivi per le firme elettroniche utilizzando le API DocuSign.

Prerequisiti

Per integrare DocuSign con AEM Forms sono necessari i seguenti elementi:

• A DocuSign account sviluppatore
• Un'applicazione DocuSign
• Credenziali (ID client e segreto client) dell’applicazione API DocuSign.
• Azione di invio personalizzata e servizio cloud per DocuSign
• (Solo per l’ambiente di sviluppo locale) Imposta documento di record.

Configurare l’azione di invio personalizzata e Cloud Service per DocuSign

AEM Forms as a Cloud Service fornisce un’azione di invio personalizzata per DocuSign. L’azione invia consente di inviare i moduli adattivi per le firme elettroniche utilizzando le API DocuSign. Il codice per l’azione di invio personalizzata è disponibile su AEM Forms campiona l’archivio Git pubblico. Puoi distribuire il codice così come si trova nell’ambiente AEM Forms o personalizzarlo in base ai requisiti della tua organizzazione.

Per configurare l’azione di invio personalizzata predefinita e il Cloud Service DocuSign, effettua le seguenti operazioni:

1. Clona il progetto AEM Forms as a Cloud Service o creare un Experience Manager Forms as a Cloud Service progetto basato su AEM Archetipo 27 o più tardi. Per creare un Experience Manager Forms as a Cloud Service progetto basato su Archetipo AEM:
   
   Apri il prompt dei comandi ed esegui il comando seguente per creare un Experience Manager Forms Progetto as a Cloud Service:

   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.

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

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

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

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

      <repository.location>maven_repository</repository.location>
      

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

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

      In caso contrario <repositories> , crea il tag sotto il <properties> tag.

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

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

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

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

       <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. Aggiungi il seguente testo alla fine del <dependencies> tag:

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

6. Apri il prompt dei comandi e passa a aem-forms-samples\forms-integration-docusign (clonato nel passaggio 3) ed esegui 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.

7. 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 firme elettroniche DocuSign disponibile nell’elenco delle opzioni di invio per un modulo adattivo e un Configurazione servizio cloud DocuSign nell'ambiente di sviluppo locale.

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

Integrare DocuSign con AEM Forms

Dopo aver impostato i prerequisiti, effettua le seguenti operazioni per integrare DocuSign con AEM Forms sulle istanze Autore.

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

2. Nella pagina delle configurazioni, tocca Crea per creare DocuSign in AEM Forms.

3. In Generale scheda di Crea configurazione DocuSign , specificare un Nome per la configurazione, quindi tocca Successivo. Facoltativamente, puoi specificare un valore Titolo.

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

5. Configurare le impostazioni OAuth per DocuSign applicazione:

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

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

6. Torna a Crea configurazione DocuSign pagina. In Impostazioni , la scheda URL OAuth nel campo è indicato il seguente URL predefinito:

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

7. Specifica la ID client (chiave di integrazione DocuSign) e Segreto client (Chiave segreta DocuSign).

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

9. Tocca Crea per creare DocuSign configurazione.

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

11. Ripeti tutti i passaggi precedenti sulle istanze di sviluppo, staging e produzione (a seconda di quale sia il passaggio rimasto) per completare la configurazione DocuSign con AEM Forms per il tuo ambiente.

Ora l’ambiente AEM Forms è configurato per l’utilizzo di DocuSign. Accertati di aggiungere il contenitore di configurazione utilizzato per il Cloud Service a tutti i Forms adattivi abilitati per DocuSign. È possibile specificare un contenitore di configurazione dalle proprietà di un modulo adattivo.

Utilizzare DocuSign in un modulo adattivo

È possibile abilitare DocuSign per un modulo adattivo esistente o crea un DocuSign è stato abilitato Adaptive Form. Scegliere una delle opzioni seguenti:

• Creare un DocuSign Modulo adattivo abilitato
• Abilita DocuSign per un modulo adattivo esistente.

Creare un modulo adattivo per DocuSign

Per creare un modulo adattivo abilitato alla firma:

1. Accedi a Adobe Experience Manager > Forms > Forms e documenti.

2. Tocca Crea e seleziona Modulo adattivo. Viene visualizzato un elenco di modelli. Seleziona un modello e tocca Successivo.

3. In Base scheda:

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

   2. Seleziona la Contenitore configurazione creato durante integrazione DocuSign con AEM Forms.

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

4. In 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 Associa modello modulo come modello del 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 Genera documento di record opzione. Quando utilizzi l’opzione, nel documento inviato per la firma vengono visualizzati tutti i campi del modulo adattivo.

5. Tocca Crea. Viene creato un modulo adattivo abilitato alla firma. Puoi aggiungere il tuo DocuSign nel modulo e inviarlo per la firma.

6. Apri il modulo adattivo in modalità di modifica. In Contenuto , toccare la scheda Contenitore modulo e tocca .

7. In Invio sezione, seleziona Invia con firme elettroniche DocuSign dal Azione di invio elenco a discesa.

8. In Configurazione azione sezione, tocca Aggiungi per aggiungere un destinatario e specificarne l’indirizzo e-mail. Tocca Aggiungi per aggiungere altri destinatari.

9. Specifica l’oggetto del messaggio e-mail nel Oggetto e-mail campo. Seleziona Includi allegati per includere allegati nel messaggio e-mail.

10. Tocca per salvare le proprietà.

Abilita DocuSign per un modulo adattivo

Da utilizzare DocuSign in un modulo adattivo esistente:

1. Accedi a Adobe Experience Manager > Forms > Forms e documenti.

2. Seleziona il modulo adattivo e tocca Proprietà.

3. In Base , seleziona la scheda Contenitore configurazione creato durante l’integrazione DocuSign con AEM Forms.

4. In 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 Associa modello modulo come modello del 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 Genera documento di record opzione. Quando utilizzi l’opzione, nel documento inviato per la firma vengono visualizzati tutti i campi del modulo adattivo.

5. Tocca Salva e chiudi. Il modulo adattivo è abilitato per DocuSign. Ora puoi aggiungere il tuo DocuSign nel modulo e inviarlo per la firma.

6. Apri il modulo adattivo in modalità di modifica. In Contenuto , toccare la scheda Contenitore modulo e tocca .

7. In Invio sezione, seleziona Invia con firme elettroniche DocuSign dal Azione di invio elenco a discesa.

8. In Configurazione azione sezione, tocca Aggiungi per aggiungere un destinatario e specificarne l’indirizzo e-mail. Tocca Aggiungi per aggiungere altri destinatari.

9. Specifica l’oggetto del messaggio e-mail nel Oggetto e-mail campo. Seleziona Includi allegati per includere allegati nel messaggio e-mail.

10. Tocca per salvare le proprietà.