Utilizzo di DocuSign con un modulo adattivo

DocuSign è una soluzione di firma elettronica di rilievo. Puoi utilizzarlo per firmare un accordo via e-mail. È 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:

  • Chiudi le offerte da qualsiasi dispositivo con processi di proposta, preventivo e contratto completamente automatizzati.
  • Completa più velocemente i processi delle risorse umane e dai ai tuoi dipendenti le esperienze digitali.
  • Taglia i tempi del ciclo di contratto e accedi più rapidamente ai tuoi fornitori.

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

È inoltre possibile utilizzare la soluzione di firma elettronica di Adobe, Adobe Sign, per apporre la firma elettronica a un modulo adattivo. AEM Forms offre un’integrazione molto più profonda con Adobe Sign e offre controlli molto più precisi come la firma sequenziale e parallela, metodi di autenticazione multipli, esperienza di firma in-form e altro ancora. Per ulteriori informazioni, consulta Utilizzo di Adobe Sign in un modulo adattivo.

Prerequisiti

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

Configurare l’azione di invio personalizzata e il servizio Cloud per DocuSign

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

Esegui i seguenti passaggi per configurare l’azione di invio personalizzata predefinita e il Cloud Service DocuSign:

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

    Apri il prompt dei comandi ed esegui il comando sottostante 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, cambia appTitle, appIde groupId, nel comando precedente per riflettere l'ambiente.

  2. Clona il aem-forms-amples archivio. Questo archivio contiene un'azione di invio personalizzata per DocuSign e i dettagli di configurazione per connettersi al server DocuSign.

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

  4. Apri [AEM Forms as a Cloud Service project]\pom.xml 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>
      

      Se non esiste <repositories> crea il tag sotto il tag <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. Esegui i seguenti passaggi nella all/pom.xml file disponibile nella cartella di progetto del 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 al punto 3) ed esegui il seguente comando:

    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. Distribuisci il progetto nell’ambiente di sviluppo locale. È possibile utilizzare il comando seguente per distribuire nell'ambiente di sviluppo locale

    mvn -PautoInstallPackage clean install

    Dopo aver eseguito questi passaggi, è possibile visualizzare una nuova azione di invio personalizzata Invia con firme elettroniche DocuSign disponibili nell’elenco delle opzioni di invio per un modulo adattivo e un Configurazione del 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, esegui i seguenti passaggi per l’integrazione DocuSign con AEM Forms nelle istanze Autore .

  1. Passa a Strumenti martello > Cloud Services > DocuSign e seleziona una cartella in cui ospitare la configurazione.

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

  3. In Generale della scheda Crea configurazione DocuSign pagina, specifica un Nome per la configurazione e tocca Successivo. Facoltativamente, puoi specificare un Titolo.

  4. Copia l'URL nella finestra del browser corrente su un blocco note. L’URL deve essere configurato DocuSign applicazione con AEM Forms in un passaggio successivo.

  5. Configura le impostazioni OAuth per la DocuSign domanda:

    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. Annotare le chiavi di integrazione e segrete.

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

  6. Torna alla pagina Crea configurazione DocuSign pagina. In Impostazioni scheda URL OAuth Il campo cita 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 viene richiesto di specificare le credenziali, specificare il nome utente e la password dell’account utilizzato durante la creazione DocuSign applicazione. Quando 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 successo.

  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, stage e produzione (a seconda di quale dei due passaggi successivi) per completare la configurazione DocuSign con AEM Forms per il tuo ambiente.

Ora, il tuo ambiente AEM Forms è configurato per utilizzare DocuSign. Aggiungi il contenitore di configurazione utilizzato per il Cloud Service a tutti i Forms adattivi per i quali DocuSign. È possibile specificare un contenitore di configurazione dalle proprietà di un modulo adattivo.

Utilizzo DocuSign in un modulo adattivo

È possibile attivare DocuSign per un modulo adattivo esistente o per creare un DocuSign modulo adattivo abilitato. Scegliere una delle seguenti opzioni:

Creare un modulo adattivo per DocuSign

Per creare un modulo adattivo abilitato alla firma:

  1. Passa 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 di configurazione creato mentre integrazione DocuSign con AEM Forms.

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

  4. In Modello Modulo seleziona 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 la Associa modello di modulo come modello del documento di record e selezionare un modello Documento di record. Quando si utilizza l’opzione , i documenti inviati per la firma visualizzano solo i campi basati sul modello di modulo associato. Non vengono visualizzati tutti i campi del modulo adattivo.

    • Se non si dispone di un modello di modulo personalizzato, selezionare la Genera documento di registrazione opzione . Quando si utilizza 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 per la firma. Puoi aggiungere il tuo DocuSign campi al modulo e inviarlo per la firma.

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

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

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

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

  10. Tocca Salva per salvare le proprietà.

Abilita DocuSign per un modulo adattivo

Per utilizzare DocuSign in un modulo adattivo esistente:

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

  2. Seleziona il modulo adattivo e tocca Proprietà.

  3. In Base seleziona la scheda contenitore di configurazione creato durante l'integrazione DocuSign con AEM Forms.

  4. In Modello Modulo seleziona 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 la Associa modello di modulo come modello del documento di record e selezionare un modello Documento di record. Quando si utilizza l’opzione , i documenti inviati per la firma visualizzano solo i campi basati sul modello di modulo associato. Non vengono visualizzati tutti i campi del modulo adattivo.

    • Se non si dispone di un modello di modulo personalizzato, selezionare la Genera documento di registrazione opzione . Quando si utilizza 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 campi al modulo e inviarlo per la firma.

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

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

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

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

  10. Tocca Salva per salvare le proprietà.

In questa pagina