Forms-gecentreerde workflows op OSGi | Gebruikersgegevens verwerken

Met Forms-gerichte AEM-workflows kunt u real-world Forms-gerichte bedrijfsprocessen automatiseren. Workflows bestaan uit een reeks stappen die worden uitgevoerd in een volgorde die is opgegeven in het bijbehorende workflowmodel. Elke stap voert een specifieke actie uit zoals het toewijzen van een taak aan een gebruiker of het verzenden van een e-mailbericht. Workflows kunnen communiceren met middelen in de opslagplaats, gebruikersaccounts en services. Daarom kunnen werkstromen ingewikkelde activiteiten coördineren die om het even welk aspect van Experience Manager impliceren.

Een op formulieren gerichte workflow kan op een van de volgende manieren worden geactiveerd of gestart:

  • Een toepassing verzenden vanuit AEM Postvak In
  • Een toepassing verzenden vanuit een AEM Forms-toepassing
  • Een adaptief formulier indienen
  • Een controlemap gebruiken
  • Een interactieve communicatie of een brief indienen

Voor meer informatie over Forms-centric AEM werkschema's en mogelijkheden, zie Forms-centric werkschema op OSGi.

Gebruikersgegevens en gegevensopslag

Wanneer een werkstroom wordt geactiveerd, wordt automatisch een lading gegenereerd voor de werkstroominstantie. Aan elke werkstroominstantie wordt een unieke instantie-id en een bijbehorende ladings-id toegewezen. De payload bevat de opslaglocaties voor gebruikers- en formuliergegevens die zijn gekoppeld aan een workflowexemplaar. Daarnaast worden concepten en historische gegevens voor een werkstroominstantie ook opgeslagen in de AEM opslagplaats.

De standaardopslagplaatsen waar lading, concepten, en geschiedenis van een werkschemainstantie verblijven zijn als volgt:

OPMERKING

U kunt verschillende locaties configureren voor het opslaan van gegevens over de lading, het concept en de geschiedenis wanneer u een workflow of toepassing maakt. Als u de locaties wilt identificeren waar een workflow of toepassing gegevens heeft opgeslagen, raadpleegt u de workflow.

AEM 6.4 Forms AEM 6.3 Forms
Workflow
-instantie
/var/workflow/instances/[server_id]/<date>/[workflow-instance]/ /etc/workflow/instances/[server_id]/[date]/[workflow-instance]/
Payload /var/fd/dashboard/payload/[server_id]/[date]/
[payload-id]/
/etc/fd/dashboard/payload/[server_id]/[date]/
[payload-id]/
Concepten /var/fd/dashboard/instances/[server_id]/
[date]/[workflow-instance]/draft/[workitem]/
/etc/fd/dashboard/instances/[server_id]/
[date]/[workflow-instance]/draft/[workitem]/
Historie /var/fd/dashboard/instances/[server_id]/
[date]/[workflow_instance]/history/
/etc/fd/dashboard/instances/[server_id]/
[date]/[workflow_instance]/history/

Gebruikersgegevens openen en verwijderen

U kunt gebruikersgegevens uit een werkstroominstantie in de gegevensopslagruimte openen en verwijderen. U kunt dit bereiken door de instantie-id te kennen van de werkstroominstantie die aan de gebruiker is gekoppeld. U kunt instantie-id van een werkstroominstantie vinden met behulp van de gebruikersnaam van de gebruiker die de werkstroominstantie heeft gestart of die de huidige ontvanger van de werkstroominstantie is.

U kunt de resultaten echter niet identificeren of dubbelzinnig weergeven wanneer u werkstromen identificeert die aan een aanvrager zijn gekoppeld in de volgende scenario's:

  • Workflow geactiveerd door een gecontroleerde map: Een workflowinstantie kan niet worden geïdentificeerd met de initiator als de workflow wordt geactiveerd door een gecontroleerde map. In dit geval wordt de gebruikersinformatie gecodeerd in de opgeslagen gegevens.
  • Workflow gestart vanaf AEM instantie publiceren: Alle workflowinstanties worden gemaakt met behulp van een servicegebruiker wanneer adaptieve formulieren, interactieve communicatie of letters vanuit AEM publicatie-instantie worden verzonden. In deze gevallen wordt de gebruikersnaam van de aangemelde gebruiker niet vastgelegd in de gegevens van de workflowinstantie.

Gebruikersgegevens openen

Voer de volgende stappen uit om gebruikersgegevens te identificeren en te benaderen die voor een workflowinstantie zijn opgeslagen:

  1. Ga bij AEM auteurinstantie naar https://[server]:[port]/crx/de en navigeer naar Tools > Query.

    Selecteer SQL2 van Type drop-down.

  2. Voer afhankelijk van de beschikbare informatie een van de volgende query's uit:

    • Voer het volgende uit als de werkstroominitiator bekend is:

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

    • Voer het volgende uit als de gebruiker van wie u gegevens vindt de huidige werkschema toegewezen is:

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

    De query retourneert de locatie van alle werkstroominstanties voor de opgegeven werkstroominitiator of de huidige werkstroomontvanger.

    De volgende query retourneert bijvoorbeeld twee pad naar workflowinstanties van het knooppunt /var/workflow/instances waarvan de initiator van de workflow srose is.

    workflow-instance

  3. Ga naar een pad voor workflowinstanties dat door de query wordt geretourneerd. De statuseigenschap geeft de huidige status van de werkstroominstantie weer.

    status

  4. Navigeer in het knooppunt voor workflowinstanties naar data/payload/. In de eigenschap path wordt het pad naar de nuttige lading voor de werkstroominstantie opgeslagen. U kunt naar het pad navigeren om toegang te krijgen tot gegevens die zijn opgeslagen in de payload.

    payload-path

  5. Navigeer naar de locaties voor concepten en historie voor de workflowinstantie.

    Bijvoorbeeld:

    /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. Herhaal stap 3 - 5 voor alle werkstroominstanties die door de query in stap 2 zijn geretourneerd.

OPMERKING

In de AEM Forms-app worden ook gegevens opgeslagen in de offlinemodus. Het is mogelijk dat gegevens voor een workflowinstantie lokaal op afzonderlijke apparaten worden opgeslagen en naar de Forms-server worden verzonden wanneer de app synchroniseert met de server.

Gebruikersgegevens verwijderen

U moet een AEM beheerder zijn om gebruikersgegevens uit workflowinstanties te verwijderen door de volgende stappen uit te voeren:

  1. Volg de instructies in Toegang tot gebruikersgegevens en neem nota van het volgende:

    • Paden naar werkstroominstanties die aan de gebruiker zijn gekoppeld
    • Status van de workflowinstanties
    • Paden naar ladingen voor de workflowinstanties
    • Paden naar concepten en historie voor workflowinstanties
  2. Voer deze stap uit voor workflowinstanties in RUNNING, SUSPENDED of STALE status:

    1. Ga naar https://[server]:[port]/aem/start.html en login met beheerdergeloofsbrieven.
    2. Ga naar Tools > Workflow> Instances.
    3. Selecteer relevante workflowinstanties voor de gebruiker en tik Terminate om actieve exemplaren te beëindigen.

    Zie Workflowinstanties beheren voor meer informatie over het werken met workflowinstanties.

  3. Ga naar de console van CRXDE Lite, navigeer aan de nuttige weg voor een werkschemainstantie, en schrap payload knoop.

  4. Navigeer naar het pad naar concepten voor een workflowinstantie en verwijder het knooppunt draft.

  5. Navigeer naar het historiepad voor een workflowinstantie en verwijder het knooppunt history.

  6. Navigeer naar het pad van de workflowinstantie voor een workflowinstantie en verwijder het knooppunt [workflow-instance-ID] voor de workflow.

    OPMERKING

    Als u het knooppunt voor workflowinstanties verwijdert, wordt de instantie van de workflow voor alle workflowdeelnemers verwijderd.

  7. Herhaal stap 2 - 6 voor alle workflowinstanties die voor een gebruiker zijn geïdentificeerd.

  8. Offline concept- en verzendgegevens van deelnemers aan de AEM Forms-app opsporen en verwijderen om verzending naar de server te voorkomen.

U kunt API's ook gebruiken om knooppunten en eigenschappen te openen en te verwijderen. Zie de volgende documenten voor meer informatie.

Op deze pagina