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 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.

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

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 ett Experience Manager Forms som ett Cloud Service-projekt baserat på AEM Archetype 27 eller senare. Så här skapar du ett Experience Manager Forms som ett Cloud Service-projekt baserat på AEM-arkitypen:

    Öppna kommandotolken och kör nedanstående kommando för att skapa ett 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 även appTitle, appId och groupId i ovanstående kommando så att den återspeglar din miljö.

  2. Klona databasen aem-forms-samples. 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-projektet som skapats i steg 1 för redigering i den utvecklingsmiljö du vill.

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

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

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

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

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

    3. Lägg till följande text i slutet av taggen <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>
      
  5. Utför följande steg i filen all/pom.xml som finns i Cloud Service projektmapp:

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

      code language-shell
       <dependency>
          <groupId>com.adobe.aemforms.samples</groupId>
          <artifactId>forms.integration.docusign.all</artifactId>
          <type>zip</type>
       </dependency>
      
  6. Öppna kommandotolken och gå 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 av 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 sändningsåtgärd, Skicka med elektroniska DocuSign-signaturer, som är tillgänglig i listan över sändningsalternativ för ett adaptivt formulär och en DocumentSign-molntjänstkonfiguration i den lokala utvecklingsmiljön.

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

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

När förutsättningarna är uppfyllda utför du följande steg för att integrera DocuSign med AEM Forms på författarinstanserna.

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

  2. På konfigurationssidan väljer du Create för att skapa DocuSign-konfigurationen i AEM Forms.

  3. På fliken General på sidan Create DocuSign Configuration anger du Name för konfigurationen och väljer Next. Du kan också ange Title.

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

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

    1. Öppna ett webbläsarfönster och logga in på ditt DocuSign utvecklarkonto.
    2. Öppna appen som konfigurerats för AEM Forms.
    3. Lägg till den URL som kopierades i föregående steg i rutan Redirect URI och klicka på Save.
    4. Anteckna Integrering och Hemliga nycklar.

    Stegvis information om hur du konfigurerar OAuth-inställningar för ett DocuSign-program och hämtar nycklarna finns i Konfigurera autentiseringsinställningar för programmets ​ utvecklardokumentation.

  6. Gå tillbaka till sidan Create DocuSign Configuration. På fliken Settings anger fältet OAuth URL följande standard-URL:

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

  7. Ange Client ID (DocuSign-integreringsnyckel) och Client Secret (hemlig DocuSign-nyckel).

  8. Välj Connect to DocuSign. När du uppmanas att ange autentiseringsuppgifter anger du användarnamn och lösenord för kontot som används när programmet DocuSign skapas. När du ombeds bekräfta åtkomst för your developer account klickar du på Allow Access. Om inloggningsuppgifterna är korrekta visas ett meddelande om att åtgärden lyckades.

  9. Välj Create om du vill skapa DocuSign-konfigurationen.

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

  11. Upprepa alla ovanstående steg på din utvecklare, scen och produktionsinstanser (beroende på vad som återstår) för att slutföra konfigurationen av 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 Service 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 ett adaptivt formulär enabledocusign

Du kan aktivera DocuSign för ett befintligt adaptivt formulär eller skapa ett DocuSign-aktiverat adaptivt formulär. 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 välj Adaptive Form. En lista med mallar visas. Välj en mall och välj Next.

  3. På fliken Basic:

    1. Ange Name och Title för det adaptiva formuläret.

    2. Välj konfigurationsbehållaren som skapades när integrerar DocuSign med AEM Forms.

    Konfigurationsbehållaren innehåller de DocuSign molntjänster som är konfigurerade för din miljö. Dessa tjänster kan väljas i verktyget Adaptiv form.

  4. Välj något av följande alternativ på fliken Form Model:

    • Om du har en anpassad formulärmall och kräver ett dokument för post som är baserat på formulärmallen, markerar du alternativet Associate form template as the Document of Record template och väljer 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 alternativet Generate Document of Record. 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 dina DocuSign-fält i formuläret och skicka det för signering.

  6. Öppna det adaptiva formuläret i redigeringsläge. Markera Content på fliken Form Container och välj Konfigurera .

  7. I avsnittet Submission väljer du Submit with DocuSign electronic signatures i listrutan Submit Action.

  8. I avsnittet Action Configuration väljer du 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 fältet Email Subject. Välj Inkludera bifogade filer om du vill inkludera bifogade filer i e-postmeddelandet.

  10. Välj Spara om du vill spara egenskaperna.

Aktivera DocuSign för ett anpassat formulär editafsign

Så här använder du DocuSign i ett befintligt adaptivt formulär:

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

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

  3. På fliken Basic väljer du den konfigurationsbehållare som skapades när DocuSign integrerades med AEM Forms.

  4. Välj något av följande alternativ på fliken Form Model:

    • Om du har en anpassad formulärmall och kräver ett dokument för post som är baserat på formulärmallen, markerar du alternativet Associate form template as the Document of Record template och väljer 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 alternativet Generate Document of Record. 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 har aktiverats för DocuSign. Nu kan du lägga till dina DocuSign-fält i formuläret och skicka det för signering.

  6. Öppna det adaptiva formuläret i redigeringsläge. Markera Content på fliken Form Container och välj Konfigurera .

  7. I avsnittet Submission väljer du Submit with DocuSign electronic signatures i listrutan Submit Action.

  8. I avsnittet Action Configuration väljer du 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 fältet Email Subject. Välj Inkludera bifogade filer om du vill inkludera bifogade filer i e-postmeddelandet.

  10. Välj Spara om du vill spara egenskaperna.

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