Integrieren von Adobe Sign in AEM Forms

Adobe Sign aktiviert für adaptive Formulare Arbeitsabläufe für E-Signaturen. E-Signaturen verbessern die Workflows bei der Verarbeitung von Dokumenten in den Bereichen Recht, Vertrieb, Gehaltsabrechnung, Personalverwaltung u. v. a…

In einem typischen Szenario mit Adobe Sign und adaptiven Formularen füllt der Benutzer ein adaptives Formular aus, um einen Service zu beantragen. Dies könnte beispielsweise ein Antrag für eine Kreditkarte oder ein Formular für Dienstleistungen für Bürger sein. Wenn ein Benutzer das Antragsformular ausfüllt und signiert, wird dieses zur Bearbeitung an den Dienstleister gesendet. Der Dienstleister prüft den Antrag und markiert ihn mit Adobe Sign als genehmigt. Sie können Adobe Sign in AEM Forms integrieren, um ähnliche Workflows für elektronische Signaturen zu ermöglichen.

Um Adobe Sign mit AEM Forms zu verwenden, konfigurieren Sie Adobe Sign in AEM Cloud Services:

Voraussetzungen

Für die Integration von Adobe Sign in AEM Forms benötigen Sie Folgendes:

  • Ein gültiges Adobe Sign-Entwicklerkonto.
  • Einen AEM Forms-Server, auf dem SSL aktiviert ist.
  • Eine Adobe Sign API-Anwendung.
  • Anmeldeinformationen (Client-ID und Client Secret) der Adobe Sign-API-Anwendung.
  • Entfernen Sie bei der Neukonfiguration die vorhandene Adobe Sign-Konfiguration sowohl aus der Autoren- als auch aus der Veröffentlichungsinstanz.
  • Verwenden Sie identische Schlüssel für Autoren- und Veröffentlichungsinstanzen.

Konfigurieren von Adobe Sign mit AEM Forms

Nachdem die Voraussetzungen erfüllt sind, führen Sie die folgenden Schritte aus, um Adobe Sign mit AEM Forms in der Autoreninstanz zu konfigurieren:

  1. Navigieren Sie in der AEM Forms-Autoreninstanz zu Tools hammer > Allgemeinl > Konfigurations-Browser.

  2. Tippen Sie auf der Seite Konfigurations-Browser auf Erstellen.

  3. Legen Sie im Dialogfeld Konfiguration erstellen einen Titel für die Konfiguration fest und aktivieren Sie Cloud-Konfigurationen. Anschließend tippen Sie auf Erstellen. Es wird ein Konfigurationscontainer für Cloud-Dienste erstellt.

  4. Navigieren Sie zu Tools hammer > Cloud-Services > Adobe Sign und wählen Sie den Konfigurationscontainer aus, den Sie im obigen Schritt erstellt haben.

    HINWEIS

    Sie können die Schritte 1 bis 4 ausführen, um einen neuen Konfigurationscontainer und eine Adobe Sign-Konfiguration im Container zu erstellen, oder den vorhandenen Ordner global in Tools Hammer > Cloud-Services > Adobe Sign verwenden. Wenn Sie die Konfiguration im neuen Konfigurations-Container erstellen, dürfen Sie beim Erstellen eines adaptiven Formulars nicht vergessen, den Container-Namen im Feld Konfigurations-Container anzugeben.

    HINWEIS

    Vergewissern Sie sich, dass die URL der Cloud-Dienste-Konfigurationsseite mit HTTPS beginnt. Andernfalls müssen Sie für den AEM Forms Server SSL aktivieren.

  5. Tippen Sie auf der Konfigurationsseite auf Erstellen, um die Adobe Sign-Konfiguration in AEM Forms zu erstellen.

  6. Geben Sie auf der Registerkarte Allgemein auf der Seite Adobe Sign-Konfiguration erstellen einen Namen für die Konfiguration an und tippen Sie auf Weiter. Sie können optional einen Titel angeben und durchsuchen, um ein Miniaturbild für die Konfiguration auszuwählen.

  7. Kopieren Sie die URL im aktuellen Browser-Fenster in einen Texteditor. Es ist erforderlich, das Programm Adobe Sign mit AEM Forms zu konfigurieren.

  8. Auf der Registerkarte Einstellungen enthält das Feld OAuth URL die Standard-URL. Das Format der URL ist:

    https://<shard>/public/oAuth/v2

    Beispiel:
    https://secure.na1.echosign.com/public/oauth/v2

    Hierbei gilt:

    na1 bezieht sich auf die Standarddatenbank-Shard. Sie können den Wert für die Datenbank-Shard ändern. Stellen Sie sicher, dass die Adobe Sign-Cloud-Konfigurationen auf die korrekte Shard verweisen.

    Wenn Sie eine weitere Adobe Sign-Konfiguration für eine Funktion oder Komponente von Adobe Experience Manager erstellen, vergewissern Sie sich, dass alle Adobe Sign-Cloud-Konfigurationen auf dieselbe Shard verweisen.

    HINWEIS

    Lassen Sie die Seite Adobe Sign-Konfiguration erstellen geöffnet. Schließen Sie sie nicht. Nachdem Sie die OAuth-Einstellungen für die Anwendung Adobe Sign wie in den nächsten Schritten beschrieben konfiguriert haben, können Sie die Client-ID und den geheimen Client-Schlüssel abrufen.

  9. Konfigurieren Sie OAuth-Einstellungen für das Adobe Sign-Programm:

    1. Öffnen Sie ein Browser-Fenster und melden Sie sich beim Adobe Sign-Entwicklerkonto an.
    2. Wählen Sie das für AEM Forms konfigurierte Programm aus und tippen Sie auf OAuth für Anwendung konfigurieren.
    3. Kopieren Sie Client-ID und Client-Geheimnis in ein Notizbuch.
    4. Fügen Sie dem Feld Umleitungs-URL die HTTPS-URL hinzu, die Sie im vorherigen Schritt kopiert haben.
    5. Aktivieren Sie die folgenden OAuth-Einstellungen für das Adobe Sign-Programm und klicken Sie auf Speichern.
    • aggrement_read
    • aggrement_write
    • aggrement_send
    • widget_write
    • workflow_read

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

    OAuth Config

  10. Kehren Sie zur Seite Adobe Sign-Konfiguration erstellen zurück. Auf der Registerkarte Einstellungen wird im Feld OAuth URL die folgende Standard-URL angegeben. Das Format der URL ist:

    https://<shard>/public/oAuth/v2

    Beispiel:
    https://secure.na1.echosign.com/public/oauth/v2

    Hierbei gilt:

    na1 bezieht sich auf die Standarddatenbank-Shard.

    Sie können den Wert für die Datenbank-Shard ändern. Starten Sie den Server neu, um den neuen Wert für die Datenbank-Shard verwenden zu können.

    HINWEIS

    Stellen Sie sicher, dass die Konfigurationen der Autoren- und Veröffentlichungsinstanz auf dieselbe Shard verweisen. Wenn Sie mehrere Adobe Sign-Konfigurationen für eine Organisation erstellen, stellen Sie sicher, dass alle Konfigurationen dieselbe Shard verwenden.

  11. Kehren Sie zur Seite Adobe Sign-Konfiguration erstellen zurück. Geben Sie auf der Registerkarte Einstellungen die Client-ID (auch als Anwendungs-ID bezeichnet) und den geheimen Client-Schlüssel an. Verwenden Sie die Client-ID und den geheimen Client-Schlüssel der Adobe Sign-Anwendung, den Sie für AEM Forms erstellt haben.

  12. Wählen Sie die Option auch für Anhänge aktivieren, um Dateien, die an einem adaptiven Formular angehängt sind, an ein entsprechendes Adobe Sign-Dokument, das zum Signiren geschickt wurde, anzuhängen.Adobe Sign

  13. Tippen Sie auf Verbindung zu Adobe Sign herstellen. Geben Sie bei Aufforderung zur Eingabe der Anmeldeinformationen den Benutzernamen und das Kennwort des Kontos an, die bei der Erstellung des Adobe Sign-Programms verwendet wurden.

  14. Tippen Sie auf Erstellen, um die Adobe Sign-Konfiguration zu erstellen.

  15. Öffnen Sie die AEM Web-Konsole. Die URL lautet https://'[server]:[port]'/system/console/configMgr.

  16. Öffnen Sie Forms Common-Konfigurations-Service.

  17. Wählen Sie im Feld Zulassen Alle Benutzer – alle Benutzer, anonym oder angemeldet, können Anhänge in der Vorschau ansehen, Formulare überprüfen und unterzeichnen – und klicken Sie auf Speichern. Autoreninstanz ist konfiguriert, um Adobe Sign zu verwenden.

  18. Veröffentlichen Sie die Konfiguration.

  19. Verwenden Sie Replikation, um eine identische Konfiguration für die entsprechenden Veröffentlichungsinstanzen zu erstellen.

Jetzt ist Adobe Sign mit AEM Forms integriert und kann in adaptiven Formularen verwendet werden. Um Adobe Sign service in einem adaptiven Formular zu nutzen, geben Sie den Konfigurationscontainer an, der oben in den Einstellungen für adaptive Formulare erstellt wurde.

Konfigurieren des Adobe Sign-Scheduler-Service, um den Signaturstatus zu synchronisieren

Ein Adobe Sign-fähiges adaptives Formular wird nur übermittelt, nachdem alle Unterzeichner den Unterzeichnungsvorgang abgeschlossen haben. Standardmäßig werden die Adobe Sign-Scheduler-Services so geplant, dass sie die Unterzeichnerantwort alle 24 Stunden abfragen. Sie können das Standardintervall für Ihre Umgebung ändern. Führen Sie zum Anpassen des Standardintervalls folgende Schritte durch:

  1. Melden Sie sich beim AEM Forms-Server mit den Admin-Anmeldedaten an und gehen Sie zu Tools > Vorgänge > Web-Konsole.

    Sie können auch folgende URL in einem Browser-Fenster öffnen:
    https://[localhost]:'port'/system/console/configMgr

  2. Suchen und öffnen Sie die Option Adobe Sign-Konfigurationsdienst. Geben Sie einen Cron-Ausdruck in das Feld Status-Aktualisierungs-Scheduler-Ausdruck und klicken Sie auf Speichern. Um beispielsweise den Konfigurations-Service täglich um 00:00 Uhr auszuführen, geben Sie 0 0 0 1/1 * ? * im Feld Ausdruck für Status-Update-Planung an.

Das Standardintervall für den Synchronisationsstatus von Adobe Sign wurde jetzt geändert.

Auf dieser Seite