DokumentationAEM 6.4Forms-Anleitung

Formularzentrierte Workflows unter OSGi | Umgang mit Benutzerdaten forms-centric-workflows-on-osgi-handling-user-data

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

Forms-orientierte AEM-Workflows ermöglichen die Automatisierung von Forms-orientierten Geschäftsprozessen in der Praxis. Workflows bestehen aus einer Reihe von Schritten, die in der im zugehörigen Workflow-Modell angegebenen Reihenfolge ausgeführt werden. Jeder Schritt führt eine bestimmte Aktion aus, z. B. das Zuweisen einer Aufgabe zu einem Benutzer oder das Senden einer E-Mail-Nachricht. Workflows können mit Assets im Repository, mit Benutzerkonten und mit Experience Manager-Diensten interagieren. Daher können Workflows komplexe Aktivitäten koordinieren, die einen beliebigen Aspekt des Experience Managers betreffen.

Ein formularzentrierter Workflow kann über eine der folgenden Methoden ausgelöst oder gestartet werden:

  • Senden eines Programms aus dem AEM-Posteingang
  • Senden einer Anwendung aus der AEM Forms-App
  • Senden eines adaptiven Formulars
  • Verwenden eines überwachten Ordners
  • Senden einer interaktiven Kommunikation oder eines Briefes

Weitere Informationen über die formularzentrierten AEM-Workflows und -Funktionen finden Sie unter Formularzentrierter Workflow auf OSGi.

Benutzerdaten und Datenspeicher user-data-and-data-stores

Wenn ein Workflow ausgelöst wird, wird automatisch eine Payload für die Workflow-Instanz generiert. Jeder Workflow-Instanz wird eine eindeutige Instanz-ID und eine zugeordnete Payload-ID zugewiesen. Die Payload enthält die Repository-Speicherorte für Benutzer- und Formulardaten, die mit einer Workflow-Instanz verknüpft sind. Darüber hinaus werden Entwürfe und historische Daten für eine Workflow-Instanz auch im AEM Repository gespeichert.

Die standardmäßigen Repository-Speicherorte, in denen sich Payload, Entwürfe und der Verlauf einer Workflow-Instanz befinden, lauten wie folgt:

NOTE
Sie können verschiedene Speicherorte konfigurieren, um beim Erstellen eines Workflows oder einer Anwendung Payload-, Entwurfs- und Verlaufsdaten zu speichern. Überprüfen Sie den Workflow, um die Speicherorte anzugeben, an denen ein Workflow oder eine Anwendung Daten gespeichert hat.
AEM 6.4 Forms
AEM 6.3 Forms
Workflow-
Instanz
/var/workflow/instances/[server_id]/<date>/[workflow-instance]/
/etc/workflow/instances/[server_id]/[date]/[workflow-instance]/
Nutzlast
/var/fd/dashboard/payload/[server_id]/[date]/
[payload-id]/
/etc/fd/dashboard/payload/[server_id]/[date]/
[payload-id]/
Entwürfe
/var/fd/dashboard/instances/[server_id]/
[Datum]/[Workflow-Instanz]/draft/[Arbeitselement]/
/etc/fd/dashboard/instances/[server_id]/
[Datum]/[Workflow-Instanz]/draft/[Arbeitselement]/
Verlauf
/var/fd/dashboard/instances/[server_id]/
[Datum]/[Workflow-Instanz]/history/
/etc/fd/dashboard/instances/[server_id]/
[Datum]/[Workflow-Instanz]/history/

Zugreifen auf und Löschen von Benutzerdaten access-and-delete-user-data

Sie können Benutzerdaten aus einer Workflow-Instanz im Repository aufrufen und löschen. Um dies zu erreichen, müssen Sie die Instanz-ID der Workflow-Instanz kennen, die dem Benutzer zugeordnet ist. Sie können die Instanz-ID einer Workflow-Instanz mithilfe des Benutzernamens des Benutzers finden, der die Workflow-Instanz initiiert hat oder der der aktuelle Bearbeiter der Workflow-Instanz ist.

In den folgenden Szenarien können Sie jedoch keine mehrdeutigen Ergebnisse erkennen, wenn Sie Workflows identifizieren, die mit einem Initiator verknüpft sind:

  • Workflow, der durch einen überwachten Ordner ausgelöst wird: Eine Workflow-Instanz kann nicht mit ihrem Initiator identifiziert werden, wenn der Workflow durch einen überwachten Ordner ausgelöst wird. In diesem Fall werden die Benutzerinformationen in den gespeicherten Daten kodiert.
  • Workflow, der von der Veröffentlichungs-AEM-Instanz initiiert wurde: Alle Workflow-Instanzen werden mithilfe eines Dienstbenutzers erstellt, wenn adaptive Formulare, interaktive Kommunikation oder Briefe aus AEM Veröffentlichungsinstanz gesendet werden. In diesen Fällen wird der Benutzername des angemeldeten Benutzers nicht in den Workflow-Instanzdaten erfasst.

Zugreifen auf Benutzerdaten access

Führen Sie die folgenden Schritte aus, um Benutzerdaten für eine Workflow-Instanz zu identifizieren und darauf zuzugreifen:

  1. Navigieren Sie in der AEM-Author-Instanz zu https://[server]:[port]/crx/de und anschließend zu Tools > Abfrage.

    Auswählen SQL2 von Typ Dropdown-Liste.

  2. Führen Sie je nach den verfügbaren Informationen eine der folgenden Abfragen aus:

    • Führen Sie Folgendes aus, wenn der Workflow-Initiator bekannt ist:

    SELECT &ast; FROM [cq:Workflow] AS s WHERE ISDESCENDANTNODE([path-to-workflow-instances]) and s.[initiator]='*initiator-ID*'

    • Führen Sie Folgendes aus, wenn der Benutzer, dessen Daten Sie finden, der aktuelle Workflow-Bearbeiter ist:

    SELECT &ast; FROM [cq:WorkItem] AS s WHERE ISDESCENDANTNODE([path-to-workflow-instances]) and s.[assignee]='*assignee-id*'

    Die Abfrage gibt den Speicherort aller Workflow-Instanzen für den angegebenen Workflow-Initiator oder den aktuellen Workflow-Empfänger zurück.

    Die folgende Abfrage gibt z. B. den Pfad zweier Workflow-Instanzen vom Knoten /var/workflow/instances zurück, deren Workflow-Initiator srose ist.

    workflow-instance

  3. Navigieren Sie zu einem Workflow-Instanzpfad, der von der Abfrage zurückgegeben wird. Die Statuseigenschaft zeigt den aktuellen Status der Workflow-Instanz an.

    status

  4. Navigieren Sie im Workflow-Instanzknoten zu data/payload/. Die Eigenschaft path speichert den Pfad zur Nutzlast für die Workflow-Instanz. Sie können zu dem Pfad navigieren, um auf Daten zuzugreifen, die in der Nutzlast gespeichert sind.

    payload-path

  5. Navigieren Sie zu den Speicherorten für Entwürfe und Verlauf für die Workflow-Instanz.

    Beispiel:

    /var/fd/dashboard/instances/server0/2018-04-09/_var_workflow_instances_server0_2018-04-09_basicmodel_54/draft/

    /var/fd/dashboard/instances/server0/2018-04-09/_var_workflow_instances_server0_2018-04-09_basicmodel_54/history/

  6. Wiederholen Sie die Schritte 3 bis 5 für alle Workflow-Instanzen, die von der Abfrage in Schritt 2 zurückgegeben wurden.

NOTE
Das AEM Forms-Programm speichert auch Daten im Offline-Modus. Es ist möglich, dass Daten für eine Workflow-Instanz lokal auf einzelnen Geräten gespeichert und an den Forms-Server gesendet werden, wenn die App mit dem Server synchronisiert wird.

Löschen von Benutzerdaten delete-user-data

Sie müssen ein AEM Administrator sein, um Benutzerdaten aus Workflow-Instanzen zu löschen, indem Sie die folgenden Schritte ausführen:

  1. Folgen Sie den Anweisungen in Auf Benutzerdaten zugreifen und beachten Sie Folgendes:

    • Pfade zu Workflow-Instanzen, die dem Benutzer zugeordnet sind
    • Status der Workflow-Instanzen
    • Pfade zu Payloads für die Workflow-Instanzen
    • Pfade zu Entwürfen und Verlauf für die Workflow-Instanzen

  2. Führen Sie diesen Schritt für Workflow-Instanzen mit dem Status RUNNING, SUSPENDED oder STALE aus:

    1. Navigieren Sie zu https://[server]:[port]/aem/start.html und melden Sie sich als Administrator an.
    2. Navigieren Sie zu Tools > Workflow > Instanzen.
    3. Wählen Sie relevante Workflow-Instanzen für den Benutzer aus und tippen Sie auf Beenden , um laufende Instanzen zu beenden.

    Weitere Informationen zum Arbeiten mit Workflow-Instanzen finden Sie unter Verwalten von Workflow-Instanzen.

  3. Navigieren Sie zur CRXDE Lite-Konsole, navigieren Sie zum Payload-Pfad für eine Workflow-Instanz und löschen Sie die payload Knoten.

  4. Navigieren Sie zum Entwurfspfad für eine Workflow-Instanz und löschen Sie den Knoten draft.

  5. Navigieren Sie zu dem Verlaufspfad für eine Workflow-Instanz und löschen Sie den Knoten history.

  6. Navigieren Sie zum Workflow-Instanzpfad für eine Workflow-Instanz und löschen Sie den Knoten [workflow-instance-ID] für den Workflow.

    note note
    NOTE
    Durch Löschen des Knotens der Workflow-Instanz wird die Workflow-Instanz für alle Workflow-Teilnehmer entfernt.

  7. Wiederholen Sie die Schritte 2 bis 6 für alle Workflow-Instanzen, die für einen Benutzer identifiziert wurden.

  8. Identifizieren und löschen Sie Offline-Entwurfs- und -Sendedaten aus dem AEM Forms-App-Postausgang von Workflow-Teilnehmern, um eine Übermittlung an den Server zu vermeiden.

Sie können APIs auch verwenden, um auf Knoten und Eigenschaften zuzugreifen und sie zu entfernen. Weitere Informationen finden Sie in den folgenden Dokumenten.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da