DocuSign gebruiken met een adaptief formulier integrate-aem-forms-with-DocuSign

​ Kloon uw project van AEM Forms as a Cloud Service ​ of creeer een Experience Manager Forms als Cloud Service project dat op ​ wordt gebaseerd AEM Archetype 27 ​ of later. Een Experience Manager Forms maken als een Cloud Service -project op basis van AEM Archetype:

Open de opdrachtregel en voer de onderstaande opdracht uit om een Experience Manager Forms as a Cloud Service-project te maken:

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"

Wijzig ook appTitle , appId en groupId in de bovenstaande opdracht om uw omgeving te weerspiegelen.

Kloon de ​ aem-vormen-steekproeven ​ bewaarplaats. Deze opslagplaats bevat een aangepaste verzendactie voor DocuSign en configuratiegegevens om verbinding te maken met de DocuSign-server.

Open het AEM Forms as a Cloud Service-project dat in Stap 1 is gemaakt voor bewerking in IDE van uw keuze.

Open het [AEM Forms as a Cloud Service project]\pom.xml -bestand om het te bewerken en breng de volgende wijzigingen aan:

1. Voeg de volgende tekst toe aan het einde van de tag <properties> :

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

2. Voeg de volgende tekst toe aan het einde van de tag <repositories> :

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

   Als er geen tag <repositories> is, maakt u de tag onder de tag <properties> .

3. Voeg de volgende tekst toe aan het einde van de tag <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>

Voer de volgende stappen uit in het all/pom.xml -bestand dat beschikbaar is in de Cloud Service-projectmap:

1. Voeg de volgende tekst toe aan het einde van de tag <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. Voeg de volgende tekst toe aan het einde van de tag <dependencies> :

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

Open de opdrachtprompt, navigeer naar aem-forms-samples\forms-integration-docusign (gekloond in stap 3) en voer de volgende opdracht uit:

mvn clean install -Dinstall.dir="<AEM Forms as a Cloud Service project path>/maven_repository"

<AEM Forms as a Cloud Service project path> verwijst naar de naam van de map die in stap 1 van deze procedure is gemaakt.

Implementeer het project in uw lokale ontwikkelomgeving. U kunt het volgende bevel gebruiken om aan uw lokale ontwikkelomgeving op te stellen

mvn -PautoInstallPackage clean install

Na het uitvoeren van deze stappen, kunt u een nieuwe douane bekijken voorlegt actie ​ met elektronische handtekeningen DocuSign ​ beschikbaar in de lijst van voorstellingsopties voor een adaptieve vorm en de configuratie van de a ​ de wolkendienst DocuSign ​ in uw lokale ontwikkelomgeving.

Compileer en ​ stel de code aan uw AEM Forms milieu van as a Cloud Service ​ op.

Navigeer aan Tools > Cloud Services > DocuSign en selecteer een omslag om de configuratie te ontvangen.

Selecteer op de configuratiepagina Create om DocuSign -configuratie te maken in AEM Forms.

Geef op het tabblad General van de Create DocuSign Configuration -pagina een Name voor de configuratie op en selecteer Next . U kunt desgewenst een Title opgeven.

Kopieer de URL in het huidige browservenster naar een laptop. De URL is vereist als u de DocuSign -toepassing in een latere stap met AEM Forms wilt configureren.

Configureer OAuth-instellingen voor de DocuSign -toepassing:

1. Open een browser venster en teken binnen aan uw DocuSign ​ ontwikkelaarsrekening ​.
2. Open de toepassing die voor AEM Forms is geconfigureerd.
3. Voeg in het vak Redirect URI de URL toe die u in de vorige stap hebt gekopieerd en klik op Save .
4. Noteer de integratietoetsen en de geheime toetsen.

Voor geleidelijke informatie om montages OAuth voor een DocuSign toepassing te vormen en de sleutels te verkrijgen, zie ​ montages van Auth voor de 2} de ontwikkelaarsdocumentatie van de toepassing {vormen.

Ga terug naar de Create DocuSign Configuration pagina. Op het tabblad Settings vermeldt het veld OAuth URL de volgende standaard-URL:

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

Geef de opties Client ID (DocuSign Integration Key) en Client Secret (DocuSign Secret Key) op.

Selecteer Connect to DocuSign. Geef bij de aanwijzing voor referenties de gebruikersnaam en het wachtwoord op van het account dat wordt gebruikt bij het maken van de DocuSign -toepassing. Klik op your developer account wanneer u wordt gevraagd de toegang voor Allow Access te bevestigen. Als de gegevens juist zijn, wordt een succesbericht weergegeven.

Selecteer Create om de DocuSign -configuratie te maken.

Selecteer de configuratie en klik op Publish , selecteer de configuratie en klik op Publish . De configuratie wordt in overeenkomende publicatieomgevingen gerepliceerd.

Herhaal alle bovenstaande stappen op uw ontwikkelaar-, werkgebied- en productieinstanties (afhankelijk van wat er nog over is) om het configureren van DocuSign met AEM Forms voor uw omgeving te voltooien.

Navigeer naar Adobe Experience Manager > Forms > Forms & Documents .

Selecteer Create en selecteer Adaptive Form . Er wordt een lijst met sjablonen weergegeven. Selecteer een sjabloon en selecteer Next .

Op het tabblad Basic :

1. Geef de waarden Name en Title op voor het adaptieve formulier.

2. Selecteer de ​ gemaakte configuratiecontainer ​ terwijl ​ integreren DocuSign met AEM Forms.

De configuratiecontainer bevat de DocuSign Cloud Services die voor uw omgeving zijn geconfigureerd. Deze services zijn beschikbaar voor selectie in Adaptief formulier Builder.

Selecteer op het tabblad Form Model een van de volgende opties:

• Als u een aangepaste formuliersjabloon hebt en een Document of Record vereist op basis van de formuliersjabloon, selecteert u de optie Associate form template as the Document of Record template en selecteert u een Document of Record-sjabloon. Als u deze optie gebruikt, worden alleen de velden weergegeven die zijn gebaseerd op de bijbehorende formuliersjabloon die zijn verzonden voor ondertekening. Niet alle velden van het adaptieve formulier worden weergegeven.

• Als u geen aangepaste formuliersjabloon hebt, selecteert u de optie Generate Document of Record . Als u deze optie gebruikt, worden in het document dat voor ondertekening is verzonden alle velden van het adaptieve formulier weergegeven.

Selecteer Create. Er wordt een adaptief formulier gemaakt dat geschikt is voor ondertekening. U kunt uw DocuSign -velden toevoegen aan het formulier en het verzenden voor ondertekening.

Open het adaptieve formulier in de bewerkingsmodus. In het Content lusje, selecteer Form Container en selecteer .

Selecteer Submission in de vervolgkeuzelijst Submit with DocuSign electronic signatures in de sectie Submit Action .

Selecteer in de sectie Action Configuration Add om een ontvanger toe te voegen en geef het e-mailadres van de ontvanger op. Selecteer nogmaals Add om meer ontvangers toe te voegen.

Geef het onderwerp voor het e-mailbericht op in het veld Email Subject . Selecteer omvatten Gehechtheid om gehechtheid in het e-mailbericht te omvatten.

Selecteer om de eigenschappen te bewaren.

Navigeer naar Adobe Experience Manager > Forms > Forms & Documents .

Selecteer het adaptieve formulier en selecteer Properties .

In het Basic lusje, selecteer de ​ gemaakte configuratiecontainer ​ terwijl het integreren DocuSign met AEM Forms.

Selecteer op het tabblad Form Model een van de volgende opties:

• Als u een aangepaste formuliersjabloon hebt en een Document of Record vereist op basis van de formuliersjabloon, selecteert u de optie Associate form template as the Document of Record template en selecteert u een Document of Record-sjabloon. Als u deze optie gebruikt, worden alleen de velden weergegeven die zijn gebaseerd op de bijbehorende formuliersjabloon die zijn verzonden voor ondertekening. Niet alle velden van het adaptieve formulier worden weergegeven.

• Als u geen aangepaste formuliersjabloon hebt, selecteert u de optie Generate Document of Record . Als u deze optie gebruikt, worden in het document dat voor ondertekening is verzonden alle velden van het adaptieve formulier weergegeven.

Selecteer Save & Close. Het adaptieve formulier is ingeschakeld voor DocuSign . Nu kunt u uw DocuSign -velden toevoegen aan het formulier en het verzenden voor ondertekening.

Open het adaptieve formulier in de bewerkingsmodus. In het Content lusje, selecteer Form Container en selecteer .

Selecteer Submission in de vervolgkeuzelijst Submit with DocuSign electronic signatures in de sectie Submit Action .

Selecteer in de sectie Action Configuration Add om een ontvanger toe te voegen en geef het e-mailadres van de ontvanger op. Selecteer nogmaals Add om meer ontvangers toe te voegen.

Geef het onderwerp voor het e-mailbericht op in het veld Email Subject . Selecteer omvatten Gehechtheid om gehechtheid in het e-mailbericht te omvatten.

Selecteer om de eigenschappen te bewaren.