Integrieren von Adobe Sign mit AEM Forms as a Cloud Service

Adobe Sign aktiviert Arbeitsabläufe für E-Signaturen für adaptive Formulare. 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 eine Dienstleistung 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 ähnliche Workflows für elektronische Signaturen ermöglichen, indem Sie Adobe Sign mit AEM Forms integrieren.

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

Voraussetzungen

Um Adobe Sign mit AEM Forms zu integrieren, benötigen Sie Folgendes:

Konfigurieren von Adobe Sign mit AEM Forms

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

  1. Navigieren Sie auf der AEM Forms-Autoreninstanz zu Tools hammer > Allgemein > 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 Konfigurations-Container für Cloud Services erstellt. Stellen Sie sicher, dass der Ordnername keine Leerzeichen enthält.

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

    HINWEIS

    Wenn Sie ein adaptives Formular erstellen, geben Sie den Namen des Containers im Feld Konfigurations-Container an.

  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 Notizblock. Diese URL benötigen Sie, um Adobe Sign in einem späteren Schritt mit AEM Forms zu konfigurieren. Tippen Sie auf Weiter.

  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 die für AEM Forms konfigurierte Anwendung aus und tippen Sie auf OAuth für Anwendung konfigurieren.
    3. Fügen Sie im Feld Umleitungs-URL die im vorherigen Schritt (Schritt 7) kopierte URL ein und klicken Sie dann auf Speichern.
    4. Aktivieren Sie den folgenden Umfang für die Anwendung Adobe Sign und klicken Sie auf Speichern.
    • aggrement_read
    • aggrement_write
    • aggrement_send
    • widget_read
    • 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. 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, die Sie im vorherigen Schritt erstellt haben.

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

  12. Tippen Sie auf Verbindung zu Adobe Sign herstellen. Geben Sie bei Aufforderung zur Eingabe der Anmeldeinformationen Benutzername und Kennwort des Kontos an, die bei der Erstellung des Adobe Sign-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 und Sie AEM Forms erlauben, auf Ihr Adobe Sign-Entwicklerkonto zuzugreifen, wird eine Erfolgsmeldung wie folgende angezeigt.

    Adobe Sign Cloud Configuration Success

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

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

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

Jetzt können Sie Adobe Sign-Felder zu einem adaptiven Formular hinzufügen. Stellen Sie sicher, dass Sie den für den Cloud Service verwendeten Konfigurations-Container zu allen adaptiven Formularen hinzufügen, die für Adobe Sign aktiviert sind. Sie können einen Konfigurations-Container in den Eigenschaften eines adaptiven Formulars angeben.

(Nur für AEM-Workflows) Konfigurieren der Adobe Sign-Planung, um den Unterzeichnungsstatus zu synchronisieren

Wenn Sie zum Unterzeichnen eines adaptiven Formulars den Adobe Sign-Workflow-Schritt verwenden, kann das Formular je nach Konfiguration des Workflow-Schritts nacheinander an jeweils einen Unterzeichner oder gleichzeitig an alle Unterzeichner gesendet werden. Adaptive Formulare für Adobe Sign werden erst dann an den Experience Manager-Formular-Server weitergeleitet, nachdem alle Unterzeichner den Unterzeichnungsvorgang abgeschlossen haben.

Standardmäßig überprüfen die Adobe Sign-Planungs-Services die Unterzeichnerreaktionen alle 24 Stunden. Sie können das Standardintervall für Ihre Umgebung ändern.

Um das Standardintervall zu ändern, geben Sie einen Cron-Ausdruck für die Eigenschaft sign.status.exp der Konfiguration des Adobe Sign-Konfigurations-Service an.

Um beispielsweise den Konfigurations-Service täglich um 0:00 Uhr auszuführen, weisen Sie 0 0 0 1/1 * ? * der Eigenschaft sign.status.exp des Adobe Sign-Konfigurations-Service zu. Folgende JSON-Datei zeigt das Beispiel einer täglichen Ausführung des Konfigurations-Service um 0:00 Uhr:

{
  "sign.status.exp":"0 0 0 1/1 * ? *"
}

Um Konfigurationswerte festzulegen, generieren Sie OSGi-Konfigurationen mit dem AEM-SDK und stellen Sie die Konfiguration in Ihrer Cloud Service-Instanz bereit.

Auf dieser Seite