Verwenden von DocuSign mit einem adaptiven Formular integrate-aem-forms-with-DocuSign

Klonen Sie Ihr AEM Forms as a Cloud Service-Projekt oder erstellen Sie ein Experience Manager Forms as a Cloud Service-Projekt basierend auf AEM Archetyp 27 oder höher. So erstellen Sie ein Experience Manager Forms as a Cloud Service-Projekt basierend auf AEM Archetyp:

Öffnen Sie die Eingabeaufforderung und führen Sie den folgenden Befehl aus, um ein Experience Manager Forms as a Cloud Service-Projekt zu erstellen:

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"

Ändern Sie im obigen Befehl außerdem appTitle, appId und groupId, sodass die Werte Ihrer Umgebung entsprechen.

Klonen Sie das Repository aem-forms-samples. Dieses Repository enthält eine benutzerdefinierte Übermittlungsaktion für DocuSign und Konfigurationsdetails zur Verbindung mit dem DocuSign-Server.

Öffnen Sie das in Schritt 1 erstellte AEM Forms as a Cloud Service-Projekt zur Bearbeitung in der IDE Ihrer Wahl.

Öffnen Sie die Datei [AEM Forms as a Cloud Service project]\pom.xml zur Bearbeitung und nehmen Sie die folgenden Änderungen vor:

1. Fügen Sie Folgendes am Ende des <properties>-Tags hinzu:

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

2. Fügen Sie Folgendes am Ende des <repositories>-Tags hinzu:

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

   Wenn es kein <repositories>-Tag gibt, erstellen Sie das Tag unter dem <properties>-Tag.

3. Fügen Sie Folgendes am Ende des <dependencyManagement>-Tags hinzu:

   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>

Führen Sie die folgenden Schritte in der Datei all/pom.xml aus, die im Projektordner von Cloud Service verfügbar ist:

1. Fügen Sie Folgendes am Ende des <embeddeds>-Tags hinzu:

   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. Fügen Sie Folgendes am Ende des <dependencies>-Tags hinzu:

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

Öffnen Sie die Eingabeaufforderung und gehen Sie zu aem-forms-samples\forms-integration-docusign (in Schritt 3 geklont) und führen Sie den folgenden Befehl aus:

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

<AEM Forms as a Cloud Service project path> bezieht sich auf den Namen des Ordners, der in Schritt 1 dieses Verfahrens erstellt wurde.

Stellen Sie das Projekt in Ihrer lokalen Entwicklungsumgebung bereit. Sie können folgenden Befehl verwenden, um die Bereitstellung für Ihre lokale Entwicklungsumgebung durchzuführen.

mvn -PautoInstallPackage clean install

Nachdem Sie diese Schritte ausgeführt haben, können Sie eine neue benutzerdefinierte Übermittlungsaktion Übermitteln mit elektronischen DocuSign-Signaturen, die in der Liste der Übermittlungsoptionen für ein adaptives Formular verfügbar ist, und eine DocuSign-Cloud-Service-Konfiguration in Ihrer lokalen Entwicklungsumgebung sehen.

Kompilieren Sie den Code und stellen Sie ihn in Ihrer AEM Forms as a Cloud Service-Umgebung bereit.

Gehen Sie zu Tools > Cloud Services > DocuSign und wählen Sie einen Ordner aus, in dem die Konfiguration gehostet werden soll.

Wählen Sie auf der Konfigurationsseite Erstellen, um die DocuSign-Konfiguration in AEM Forms zu erstellen.

Geben Sie auf der Registerkarte Allgemein auf der Seite DocuSign-Konfiguration erstellen einen Namen für die Konfiguration an und wählen Sie Weiter. Sie können optional einen Titel angeben.

Kopieren Sie die URL im aktuellen Browser-Fenster in einen Texteditor. Diese URL benötigen Sie, um DocuSign in einem späteren Schritt mit AEM Forms zu konfigurieren.

Konfigurieren Sie OAuth-Einstellungen für das DocuSign-Programm:

1. Öffnen Sie ein Browser-Fenster und melden Sie sich beim DocuSign -Entwicklerkonto an.
2. Öffnen Sie die Anwendung, die für AEM Forms konfiguriert ist.
3. Fügen Sie im Feld Umleitungs-URL die im vorherigen Schritt kopierte URL ein und klicken Sie dann auf Speichern.
4. Notieren Sie sich die Integrations- und Geheimschlüssel.

Schritt-für-Schritt-Anleitungen zum Konfigurieren der OAuth-Einstellungen für ein DocuSign-Programm und zum Abrufen der Schlüssel finden Sie in der Entwicklerdokumentation unter Konfigurieren von OAuth-Einstellungen für die Anwendung.

Kehren Sie zur Seite DocuSign-Konfiguration erstellen zurück. Auf der Registerkarte Einstellungen wird im Feld OAuth-URL die folgende Standard-URL angegeben:

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

Geben Sie die Client-ID (DocuSign-Integrationsschlüssel) und das Client-Geheimnis (geheimer DocuSign-Schlüssel) ein.

Wählen Sie Verbindung zu DocuSign herstellen. Geben Sie bei Aufforderung zur Eingabe der Anmeldeinformationen den Benutzernamen und das Kennwort des Kontos an, die bei der Erstellung des DocuSign-Programms verwendet wurden. Sobald Sie aufgefordert werden, den Zugriff für your developer account zu bestätigen, klicken Sie auf Zugriff erlauben. Wenn die Anmeldeinformationen korrekt sind, wird eine Erfolgsmeldung angezeigt.

Wählen Sie Erstellen, um die DocuSign-Konfiguration zu erstellen.

Wählen Sie die Konfiguration aus und klicken Sie auf Veröffentlichen, wählen Sie die Konfiguration aus und klicken Sie auf Veröffentlichen. Dadurch wird die Konfiguration in die entsprechende Umgebung im Veröffentlichungsmodus repliziert.

Wiederholen Sie alle oben genannten Schritte für Ihre Entwicklungs-, Staging- und Produktionsinstanzen (je nachdem, welche noch übrig sind), um die Konfiguration von DocuSign mit AEM Forms für Ihre Umgebung abzuschließen.

Gehen Sie zu Adobe Experience Manager > Formulare > Formulare und Dokumente.

Wählen Sie Erstellen und dann Adaptives Formular aus. Eine Liste von Vorlagen wird angezeigt. Wählen Sie eine Vorlage aus und dann Weiter.

Auf der Registerkarte Standard:

1. Geben Sie Name und Titel für das adaptive Formular an.

2. Wählen Sie den Konfigurations-Container aus, der bei der Integration von DocuSign in AEM Forms erstellt wurde.

Der Konfigurations-Container enthält die für Ihre Umgebung konfigurierten DocuSign-Cloud Services. Diese Services stehen im Editor für adaptive Formulare zur Auswahl.

Wählen Sie auf der Registerkarte Formularmodell eine der folgenden Optionen:

• Wenn Sie über eine benutzerdefinierte Formularvorlage verfügen und ein Datensatzdokument auf Grundlage der Formularvorlage benötigen, wählen Sie die Option Formularvorlage als Vorlage für das Datensatzdokument zuordnen und wählen Sie eine Datensatzdokumentvorlage aus. Wenn Sie diese Option verwenden, zeigen die zum Signieren gesendeten Dokumente nur die Felder an, die auf der zugehörigen Formularvorlage basieren. Es werden nicht alle Felder des adaptiven Formulars angezeigt.

• Wenn Sie keine benutzerdefinierte Formularvorlage haben, wählen Sie die Option Datensatzdokument erzeugen. Wenn Sie diese Option verwenden, zeigt das zum Signieren gesendete Dokument alle Felder des adaptiven Formulars an.

Wählen Sie Erstellen. Es wird ein signaturfähiges adaptives Formular erstellt. Sie können Ihre DocuSign-Felder zum Formular hinzufügen und dieses zum Signieren senden.

Öffnen Sie Ihr adaptives Formular im Bearbeitungsmodus. Wählen Sie auf der Registerkarte Inhalt die Option Formular-Container und dann .

Wählen Sie im Abschnitt Übermittlung die Option Senden mit DocuSign-E-Signaturen aus der Dropdown-Liste Übermittlungsaktion aus.

Wählen Sie im Abschnitt Aktionskonfiguration die Option Hinzufügen, um eine Empfängerin bzw. einen Empfänger hinzuzufügen, und geben Sie die E-Mail-Adresse der Person an. Wählen Sie erneut Hinzufügen, um weitere Empfängerinnen oder Empfänger hinzuzufügen.

Geben Sie im Feld E-Mail-Betreffzeile den Betreff für die E-Mail-Nachricht an. Wählen Sie Anhänge einschließen, um Anhänge in die E-Mail-Nachricht aufzunehmen.

Wählen Sie aus, um die Eigenschaften zu speichern.

Gehen Sie zu Adobe Experience Manager > Forms > Formulare und Dokumente.

Wählen Sie das adaptive Formular aus und wählen Sie dann Eigenschaften.

Wählen Sie auf der Registerkarte Standard den Konfigurations-Container aus, der bei der Integration von DocuSign in AEM Forms erstellt wurde.

Wählen Sie auf der Registerkarte Formularmodell eine der folgenden Optionen:

• Wenn Sie über eine benutzerdefinierte Formularvorlage verfügen und ein Datensatzdokument auf Grundlage der Formularvorlage benötigen, wählen Sie die Option Formularvorlage als Vorlage für das Datensatzdokument zuordnen und wählen Sie eine Datensatzdokumentvorlage aus. Wenn Sie diese Option verwenden, zeigen die zum Signieren gesendeten Dokumente nur die Felder an, die auf der zugehörigen Formularvorlage basieren. Es werden nicht alle Felder des adaptiven Formulars angezeigt.

• Wenn Sie keine benutzerdefinierte Formularvorlage haben, wählen Sie die Option Datensatzdokument erzeugen. Wenn Sie diese Option verwenden, zeigt das zum Signieren gesendete Dokument alle Felder des adaptiven Formulars an.

Wählen Sie Speichern und schließen. Das adaptive Formular ist für DocuSign aktiviert. Jetzt können Sie Ihre DocuSign-Felder zum Formular hinzufügen und dieses zum Signieren senden.

Öffnen Sie Ihr adaptives Formular im Bearbeitungsmodus. Wählen Sie auf der Registerkarte Inhalt die Option Formular-Container und dann .

Wählen Sie im Abschnitt Übermittlung die Option Senden mit DocuSign-E-Signaturen aus der Dropdown-Liste Übermittlungsaktion aus.

Wählen Sie im Abschnitt Aktionskonfiguration die Option Hinzufügen, um eine Empfängerin bzw. einen Empfänger hinzuzufügen, und geben Sie die E-Mail-Adresse der Person an. Wählen Sie erneut Hinzufügen, um weitere Empfängerinnen oder Empfänger hinzuzufügen.

Geben Sie im Feld E-Mail-Betreffzeile den Betreff für die E-Mail-Nachricht an. Wählen Sie Anhänge einschließen, um Anhänge in die E-Mail-Nachricht aufzunehmen.

Wählen Sie aus, um die Eigenschaften zu speichern.