Verwenden von DocuSign mit einem adaptiven Formular

DocuSign ist eine herausragende Lösung für elektronische Signaturen. Damit lassen sich Vereinbarungen elektronisch unterzeichnen. Sie können DocuSign mit einem adaptiven Formular integrieren. Es hilft Ihnen dabei, ein adaptives Formular zur elektronischen Signatur an mehrere Empfänger zu senden. Die Verwendung von elektronischen Signaturen hilft Ihnen bei Folgendem:

  • Geschäftsabschlüsse von jedem Gerät aus mit vollautomatischen Prozessen für Vorschlag, Angebot und Vertrag.
  • Schnelleres Abschließen von Prozessen im Personalwesen und Zugang zu digitalen Abläufen für Ihre Mitarbeiter.
  • Kürzere Vertragszyklen und schnelleres Onboarding Ihrer Lieferanten.

AEM Forms as a Cloud Service bietet eine benutzerdefinierte Übermittlungsaktion für DocuSign. Die Übermittlungsaktion hilft Ihnen dabei, die adaptiven Formulare für elektronische Signaturen mithilfe von DocuSign-APIs zu senden.

Sie können auch die E-Signaturlösung von Adobe, Adobe Sign, verwenden, um ein adaptives Formular elektronisch unterzeichnen zu lassen. AEM Forms verfügt über eine wesentlich tiefere Integration mit Adobe Sign und bietet wesentlich feinere Steuerelemente wie sequenzielles und paralleles Signieren, mehrere Authentifizierungsmethoden, formularinternes Signieren und mehr. Weitere Informationen finden Sie unter Verwenden von Adobe Sign in einem adaptiven Formular.

Voraussetzungen

Zur Integration von DocuSign mit AEM Forms sind folgende Elemente erforderlich:

Konfiguration der benutzerdefinierten Übermittlungsaktion und des Cloud-Service für DocuSign

AEM Forms as a Cloud Service bietet eine benutzerdefinierte Übermittlungsaktion für DocuSign. Die Übermittlungsaktion hilft Ihnen dabei, die adaptiven Formulare für elektronische Signaturen mithilfe von DocuSign-APIs zu senden. Der Code für eine benutzerdefinierte Übermittlungsaktion ist unter AEM Forms-Beispiele für öffentliches Git-Repository verfügbar. Sie können den Code so bereitstellen, wie er sich in Ihrer AEM Forms-Umgebung befindet, oder ihn gemäß den Anforderungen Ihres Unternehmens anpassen.

Führen Sie die folgenden Schritte aus, um die vorkonfigurierte benutzerdefinierte Übermittlungsaktion und den DocuSign-Cloud-Service zu konfigurieren:

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

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

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

  4. Ö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:

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

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

       <dependency>
         <groupId>com.adobe.aemforms.samples</groupId>
         <artifactId>forms.integration.docusign.all</artifactId>
         <type>zip</type>
         <version>1.0.0</version>
       </dependency>
      
  5. 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:

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

       <dependency>
          <groupId>com.adobe.aemforms.samples</groupId>
          <artifactId>forms.integration.docusign.all</artifactId>
          <type>zip</type>
       </dependency>
      
  6. Ö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.

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

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

Integration von DocuSign mit AEM Forms

Wenn alle Voraussetzungen erfüllt sind, führen Sie die folgenden Schritte aus, um DocuSign in der Autoreninstanz mit AEM Forms zu konfigurieren.

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

  2. Tippen Sie auf der Konfigurationsseite auf Erstellen, um die DocuSign-Konfiguration in AEM Forms zu erstellen.

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

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

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

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

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

  8. Tippen Sie auf 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.

  9. Tippen Sie auf Erstellen, um die DocuSign-Konfiguration zu erstellen.

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

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

Jetzt ist Ihre AEM Forms-Umgebung für die Verwendung von DocuSign konfiguriert. Stellen Sie sicher, dass Sie den für den Cloud Service verwendeten Konfigurations-Container zu allen adaptiven Formularen hinzufügen, die für DocuSign aktiviert sind. Sie können einen Konfigurations-Container in den Eigenschaften eines adaptiven Formulars angeben.

Verwenden von DocuSign in einem adaptiven Formular

Sie können DocuSign für ein vorhandenes adaptives Formular aktivieren oder ein DocuSign-fähiges adaptives Formular erstellen. Wählen Sie eine der folgenden Möglichkeiten:

Adaptives Formular für DocuSign erstellen

Erstellen eines signaturfähigen adaptiven Formulars:

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

  2. Tippen Sie auf Erstellen und wählen Sie Adaptives Formular. Eine Liste von Vorlagen wird angezeigt. Wählen Sie eine Vorlage aus und klicken Sie auf Weiter.

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

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

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

  6. Öffnen Sie Ihr adaptives Formular im Bearbeitungsmodus. Tippen Sie auf der Registerkarte Inhalt auf Formular-Container und dann auf Konfigurieren.

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

  8. Tippen Sie im Abschnitt Aktionskonfiguration auf Hinzufügen, um einen Empfänger hinzuzufügen, und geben Sie die E-Mail-Adresse des Empfängers an. Tippen Sie erneut auf Hinzufügen, um weitere Empfänger hinzuzufügen.

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

  10. Tippen Sie auf Speichern, um die Eigenschaften zu speichern.

Aktivieren von DocuSign für ein adaptives Formular

Verwenden von DocuSign in einem vorhandenen adaptiven Formular:

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

  2. Wählen Sie das adaptive Formular aus und tippen Sie auf Eigenschaften.

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

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

  5. Tippen Sie auf 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.

  6. Öffnen Sie Ihr adaptives Formular im Bearbeitungsmodus. Tippen Sie auf der Registerkarte Inhalt auf Formular-Container und dann auf Konfigurieren.

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

  8. Tippen Sie im Abschnitt Aktionskonfiguration auf Hinzufügen, um einen Empfänger hinzuzufügen, und geben Sie die E-Mail-Adresse des Empfängers an. Tippen Sie erneut auf Hinzufügen, um weitere Empfänger hinzuzufügen.

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

  10. Tippen Sie auf Speichern, um die Eigenschaften zu speichern.

Auf dieser Seite