DocumentazioneAEM as a Cloud ServiceGuida utente

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

Last update: Tue Dec 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

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.

Puoi anche utilizzare la soluzione di firma elettronica di Adobe, Adobe Sign, per firmare elettronicamente un modulo adattivo. AEM Forms offre un’integrazione molto più profonda con Adobe Sign e controlli molto più precisi, come la firma sequenziale e parallela, più metodi di autenticazione, esperienza di firma interna ai moduli e altro ancora. Per ulteriori informazioni, consulta Utilizzo di Adobe Sign in un modulo adattivo.

Prerequisiti prerequisites

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

Configurare l’azione di invio personalizzata e Cloud Service per DocuSign deploy-custom-submit-action

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:

    code language-shell 
    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:

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

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

      code language-shell 
       <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:

      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>

  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:

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

      code language-shell 
       <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:

    code language-shell 
    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 configure-docusign-with-aem-forms

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

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

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

  3. In Generale scheda di Crea configurazione DocuSign , specificare un Nome per la configurazione, quindi seleziona 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. Seleziona 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. Seleziona 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 enabledocusign

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

Creare un modulo adattivo per DocuSign create-an-adaptive-form-for-docusign

Per creare un modulo adattivo abilitato alla firma:

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

  2. Seleziona Crea e seleziona Modulo adattivo. Viene visualizzato un elenco di modelli. Seleziona un modello e seleziona 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. Seleziona 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 , seleziona la scheda Contenitore modulo e seleziona Configura .

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

  8. In Configurazione azione sezione, seleziona Aggiungi per aggiungere un destinatario e specificarne l’indirizzo e-mail. Seleziona 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. Seleziona Salva per salvare le proprietà.

Abilita DocuSign per un modulo adattivo editafsign

Da utilizzare DocuSign in un modulo adattivo esistente:

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

  2. Seleziona il modulo adattivo e seleziona 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. Seleziona 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 , seleziona la scheda Contenitore modulo e seleziona Configura .

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

  8. In Configurazione azione sezione, seleziona Aggiungi per aggiungere un destinatario e specificarne l’indirizzo e-mail. Seleziona 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. Seleziona Salva per salvare le proprietà.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab