Använda DocuSign med ett anpassat formulär integrate-aem-forms-with-DocuSign

DocuSign är en framträdande e-signaturlösning. Du kan använda det för att e-signera ett avtal. Du kan integrera DocuSign med ett anpassat formulär. Det hjälper dig att skicka ett anpassat formulär för e-signaturer till flera mottagare. Med e-signaturer kan ni

  • Slut avtal från vilken enhet som helst med fullt automatiserade processer för förslag, offerter och kontrakt.
  • Slutför HR-processerna snabbare och ge medarbetarna de digitala upplevelserna.
  • Minska kontraktscyklerna och anlita era leverantörer snabbare.

AEM Forms as a Cloud Service har en anpassad skickaåtgärd för DocuSign. Med åtgärden Skicka kan du skicka adaptiva formulär för e-signaturer med hjälp av API:er för DocuSign.

Du kan också använda Adobe signaturlösning, Adobe Sign, för att e-signera ett anpassat formulär. AEM Forms har en mycket djupare integrering med Adobe Sign och ger mycket finare kontroller som sekventiell och parallell signering, flera autentiseringsmetoder, signering i formulär med mera. Mer information finns i Använda Adobe Sign i en adaptiv form.

Förutsättningar prerequisites

Följande krävs för att integrera DocuSign med AEM Forms:

Konfigurera anpassad inskickningsåtgärd och molntjänst för DocuSign deploy-custom-submit-action

AEM Forms as a Cloud Service innehåller en anpassad skickaåtgärd för DocuSign. Med åtgärden Skicka kan du skicka adaptiva formulär för e-signaturer med hjälp av API:er för DocuSign. Kod för anpassad skickaåtgärd är tillgänglig på AEM Forms samplar offentlig Git-databas. Du kan distribuera koden som den är i din AEM Forms-miljö eller anpassa den efter organisationens behov.

Utför följande steg för att konfigurera en körklar anpassad sändningsåtgärd och DocuSign-Cloud Service:

  1. Klona ditt AEM Forms as a Cloud Service-projekt eller skapa Experience Manager Forms som Cloud Service projekt baserat på AEM 27 eller senare. Skapa en Experience Manager Forms som Cloud Service projekt baserat på AEM Archetype:

    Öppna kommandotolken och kör nedanstående kommando för att skapa en Experience Manager Forms as a Cloud Service projekt:

    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"
    

    Ändra också appTitle, appIdoch groupId, i ovanstående kommando för att återspegla din miljö.

  2. Klona aem-forms-samples databas. Den här databasen innehåller anpassad skickaåtgärd för DocuSign och konfigurationsinformation för anslutning till DocuSign-servern.

  3. Öppna AEM Forms as a Cloud Service projekt som skapats i steg 1 för redigering i den utvecklingsmiljö du vill.

  4. Öppna [AEM Forms as a Cloud Service project]\pom.xml -fil för redigering och gör följande ändringar:

    1. Lägg till följande text i slutet av <properties> tagg:

      code language-shell
      <repository.location>maven_repository</repository.location>
      
    2. Lägg till följande text i slutet av <repositories> tagg:

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

      Om det inte finns något <repositories> skapar du taggen under -taggen <properties> -tagg.

    3. Lägg till följande text i slutet av <dependencyManagement> tagg:

      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. Utför följande steg i all/pom.xml -fil finns i Cloud Servicens projektmapp:

    1. Lägg till följande text i slutet av <embeddeds> tagg:

      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. Lägg till följande text i slutet av <dependencies> tagg:

      code language-shell
       <dependency>
          <groupId>com.adobe.aemforms.samples</groupId>
          <artifactId>forms.integration.docusign.all</artifactId>
          <type>zip</type>
       </dependency>
      
  6. Öppna kommandotolken och navigera till aem-forms-samples\forms-integration-docusign (klonat i steg 3) och kör följande kommando:

    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> refererar till namnet på mappen som skapades i steg 1 i den här proceduren.

  7. Distribuera projektet till din lokala utvecklingsmiljö. Du kan använda följande kommando för att distribuera till den lokala utvecklingsmiljön

    mvn -PautoInstallPackage clean install

    När du har utfört de här stegen kan du visa en ny anpassad skicka-åtgärd Skicka med elektroniska signaturer i DocuSign finns i listan med alternativ för att skicka in formulär med adaptiv form och en DokSign-molntjänstkonfiguration i den lokala utvecklingsmiljön.

  8. Kompilera och Distribuera koden till AEM Forms as a Cloud Service miljö.

Integrera DocuSign med AEM Forms configure-docusign-with-aem-forms

Utför följande steg för att integrera DocuSign med AEM Forms på Author-instanserna.

  1. Navigera till Tools hammare > Cloud Services > DocuSign och välj en mapp som ska vara värd för konfigurationen.

  2. Välj på konfigurationssidan Create att skapa DocuSign i AEM Forms.

  3. I General -fliken i Create DocuSign Configuration sida, ange en Name för konfigurationen och välj Next. Du kan också ange en Title.

  4. Kopiera URL-adressen i det aktuella webbläsarfönstret till en anteckningsruta. URL:en krävs för att konfigurera DocuSign program med AEM Forms i ett senare steg.

  5. Konfigurera OAuth-inställningar för DocuSign program:

    1. Öppna ett webbläsarfönster och logga in på DocuSign utvecklarkonto.
    2. Öppna programmet som konfigurerats för AEM Forms.
    3. I Redirect URI lägger du till den URL som kopierades i föregående steg och klickar på Save.
    4. Anteckna Integrering och Hemliga nycklar.

    Om du vill ha stegvis information om hur du konfigurerar OAuth-inställningar för en DocuSign program och hämta nycklarna, se Konfigurera autentiseringsinställningar för programmet dokumentation för utvecklare.

  6. Gå tillbaka till Create DocuSign Configuration sida. I Settings -fliken, OAuth URL I fältet anges följande standard-URL:

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

  7. Ange Client ID (DocuSign-integreringsnyckel) och Client Secret (Hemlig nyckel för DocuSign).

  8. Välj Connect to DocuSign. Ange användarnamn och lösenord för kontot som används när du skapar inloggningsuppgifter DocuSign program. När du ombeds att bekräfta åtkomsten för your developer account, klicka Allow Access. Om inloggningsuppgifterna är korrekta visas ett meddelande om att åtgärden lyckades.

  9. Välj Create för att skapa DocuSign konfiguration.

  10. Välj konfigurationen och klicka på Publish, markera konfigurationen och klicka på Publish. Konfigurationen replikeras till motsvarande publiceringsmiljöer.

  11. Upprepa alla ovanstående steg på utvecklaren, scenen och produktionsinstanserna (beroende på vad som återstår) för att slutföra konfigurationen DocuSign med AEM Forms för din miljö.

Nu är din AEM Forms-miljö konfigurerad att använda DocuSign. Se till att du lägger till konfigurationsbehållaren som används för Cloud Servicen i alla adaptiva Forms som aktiveras för DocuSign. Du kan ange en konfigurationsbehållare bland egenskaperna för ett adaptivt formulär.

Använd DocuSign i adaptiv form enabledocusign

Du kan aktivera DocuSign för ett befintligt adaptivt formulär eller skapa ett DocuSign aktiverad adaptiv form. Välj något av följande:

Skapa ett anpassat formulär för DocuSign create-an-adaptive-form-for-docusign

Så här skapar du ett signeringsaktiverat adaptivt formulär:

  1. Navigera till Adobe Experience Manager > Forms > Forms & Documents.

  2. Välj Create och markera Adaptive Form. En lista med mallar visas. Välj en mall och välj Next.

  3. I Basic tab:

    1. Ange Name och Title för den adaptiva formen.

    2. Välj konfigurationsbehållare skapad integrering DocuSign med AEM Forms.

    Konfigurationsbehållaren innehåller DocuSign Cloud Service som konfigurerats för din miljö. Dessa tjänster kan väljas i redigeraren för adaptiva formulär.

  4. I Form Model väljer du något av följande alternativ:

    • Om du har en anpassad formulärmall och kräver ett postdokument som är baserat på formulärmallen väljer du Associate form template as the Document of Record template och välj en dokumentmall. När du använder alternativet visas endast de fält som är baserade på den associerade formulärmallen i de dokument som skickas för signering. Alla fält i det adaptiva formuläret visas inte.

    • Om du inte har någon anpassad formulärmall väljer du Generate Document of Record alternativ. När du använder alternativet visas alla fält i det adaptiva formuläret i det dokument som skickas för signering.

  5. Välj Create. Ett signeringsaktiverat anpassat formulär skapas. Du kan lägga till DocuSign fält till formuläret och skicka det för signering.

  6. Öppna det adaptiva formuläret i redigeringsläge. I Content väljer du Form Container och markera Konfigurera .

  7. I Submission avsnitt, markera Submit with DocuSign electronic signatures från Submit Action listruta.

  8. I Action Configuration avsnitt, markera Add om du vill lägga till en mottagare och ange mottagarens e-postadress. Välj Add igen om du vill lägga till fler mottagare.

  9. Ange ämnet för e-postmeddelandet i Email Subject fält. Välj Inkludera bifogade filer om du vill inkludera bilagor i e-postmeddelandet.

  10. Välj Spara för att spara egenskaperna.

Aktivera DocuSign för ett adaptivt formulär editafsign

Används DocuSign i en befintlig adaptiv form:

  1. Navigera till Adobe Experience Manager > Forms > Forms & Documents.

  2. Markera det adaptiva formuläret och välj Properties.

  3. I Basic väljer du konfigurationsbehållare skapad vid integrering DocuSign med AEM Forms.

  4. I Form Model väljer du något av följande alternativ:

    • Om du har en anpassad formulärmall och kräver ett postdokument som är baserat på formulärmallen väljer du Associate form template as the Document of Record template och välj en dokumentmall. När du använder alternativet visas endast de fält som är baserade på den associerade formulärmallen i de dokument som skickas för signering. Alla fält i det adaptiva formuläret visas inte.

    • Om du inte har någon anpassad formulärmall väljer du Generate Document of Record alternativ. När du använder alternativet visas alla fält i det adaptiva formuläret i det dokument som skickas för signering.

  5. Välj Save & Close. Det adaptiva formuläret är aktiverat för DocuSign. Nu kan du lägga till DocuSign fält till formuläret och skicka det för signering.

  6. Öppna det adaptiva formuläret i redigeringsläge. I Content väljer du Form Container och markera Konfigurera .

  7. I Submission avsnitt, markera Submit with DocuSign electronic signatures från Submit Action listruta.

  8. I Action Configuration avsnitt, markera Add om du vill lägga till en mottagare och ange mottagarens e-postadress. Välj Add igen om du vill lägga till fler mottagare.

  9. Ange ämnet för e-postmeddelandet i Email Subject fält. Välj Inkludera bifogade filer om du vill inkludera bilagor i e-postmeddelandet.

  10. Välj Spara för att spara egenskaperna.

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