DocumentatieAEM 6.5Handboek

Forms JEE-workflows | Gebruikersgegevens verwerken forms-jee-workflows-handling-user-data

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beheerder
  • Gebruiker

AEM Forms JEE-workflows bieden tools voor het ontwerpen, maken en beheren van bedrijfsprocessen. Een workflowproces bestaat uit een reeks stappen die in een opgegeven volgorde worden uitgevoerd. Elke stap voert een specifieke actie uit zoals het toewijzen van een taak aan een gebruiker of het verzenden van een e-mailbericht. Een proces kan met activa, gebruikersrekeningen, en de diensten in wisselwerking staan, en kan worden teweeggebracht gebruikend om het even welke volgende methodes:

  • Een proces starten vanuit AEM Forms Workspace
  • De SOAP- of RESTful-service gebruiken
  • Een adaptief formulier indienen
  • Gecontroleerde map gebruiken
  • E-mail gebruiken

Voor meer informatie over het creëren van het werkschemaproces van AEM Forms JEE, zie Hulp Workbench.

Gebruikersgegevens en gegevensopslag user-data-and-data-stores

Wanneer een proces wordt geactiveerd en tijdens het proces worden gegevens over de deelnemers aan het proces, gegevens die door deelnemers zijn ingevoerd in het formulier dat aan het proces is gekoppeld, en bijlagen die aan het formulier zijn toegevoegd, vastgelegd. De gegevens worden opgeslagen in de AEM Forms JEE-serverdatabase en als deze zijn geconfigureerd, worden sommige gegevens zoals bijlagen opgeslagen in de GDS-map (Global Document Storage). De GDS-map kan worden geconfigureerd op een gedeeld bestandssysteem of een database.

Gebruikersgegevens openen en verwijderen access-and-delete-user-data

Wanneer een proces wordt geactiveerd, worden een unieke procesinstantie-id en een langlevende aanroepings-id gegenereerd en gekoppeld aan de procesinstantie. U kunt gegevens voor een procesinstantie openen en verwijderen op basis van de langlevende aanroepings-id. U kunt de langlevende aanroepingsID van een procesinstantie met de gebruikersnaam van de procesinitiatiefnemer of procesdeelnemers aftrekken die hun taken hebben voorgelegd.

U kunt de procesinstantie-id voor een initiator echter niet identificeren in de volgende scenario's:

  • Proces dat door een gelete op omslag wordt teweeggebracht: Een procesinstantie kan niet worden geïdentificeerd gebruikend zijn initiatiefnemer als het proces door een gelete op omslag wordt teweeggebracht. In dit geval wordt de gebruikersinformatie gecodeerd in de opgeslagen gegevens.
  • Proces in werking gesteld van publiceren AEM instantie: Alle procesinstanties die van AEM worden teweeggebracht publiceren instantie vangen geen informatie over de initiatiefnemer. Gebruikersgegevens kunnen echter worden vastgelegd in het formulier dat is gekoppeld aan het proces, dat is opgeslagen in workflowvariabelen.
  • Proces dat door e-mail in werking wordt gesteld: E-mailidentiteitskaart van de afzender wordt gevangen als bezit in een ondoorzichtige blob kolom van de tb_job_instance gegevensbestandlijst, die niet direct kan worden gevraagd.

Id's van procesinstanties identificeren wanneer de aanvrager of deelnemer van de workflow bekend is initiator-participant

Voer de volgende stappen uit zodat u procesinstantie-id's kunt identificeren voor een workflowaanvrager of een deelnemer:

  1. Voer het volgende bevel in het gegevensbestand van de Server van AEM Forms uit om belangrijkste identiteitskaart voor werkschemageinitiator of deelnemer van de edcprincipalentity gegevensbestandlijst terug te winnen.

    code language-sql 
    select id from edcprincipalentity where canonicalname='user_ID'

    De query retourneert de hoofd-id voor de opgegeven user_ID .

  2. (voor werkschemaminitiator) voer het volgende bevel uit om alle taken terug te winnen verbonden aan belangrijkste identiteitskaart voor de initiatiefnemer van de tb_task gegevensbestandlijst.

    code language-sql 
    select * from tb_task where start_task = 1 and create_user_id= 'initiator_principal_id'

    De query retourneert taken die door de opgegeven initiator_ principal_id zijn gestart. De taken zijn van twee typen:

    • Voltooide taken: Deze taken zijn voorgelegd en tonen een alfanumerieke waarde op het process_instance_id gebied. Neem nota van alle procesinstantie IDs voor voorgelegde taken en ga met de stappen verder.
    • in werking gestelde maar niet volledige Taken: Deze taken hebben in werking gesteld maar nog niet voorgelegd. De waarde op het process_instance_id gebied voor deze taken is 0 (nul). In dit geval, neem nota van overeenkomstige taak IDs en zie Werk met wezen taken.

  3. (voor werkschemadeelnemers) voer het volgende bevel uit om procesinstantie IDs terug te winnen verbonden aan belangrijkste identiteitskaart van de procesdeelnemer voor de initiatiefnemer van de tb_assignment gegevensbestandlijst.

    code language-sql 
    select distinct a.process_instance_id from tb_assignment a join tb_queue q on a.queue_id = q.id where q.workflow_user_id='participant_principal_id'

    De vraag keert instantie IDs voor alle processen verbonden aan de deelnemer, met inbegrip van die terug waar de deelnemer geen taak heeft voorgelegd.

    Neem nota van alle procesinstantie IDs voor voorgelegde taken en ga met de stappen verder.

    Voor wezen taken of taken waar process_instance_id 0 (nul) is, neem nota van overeenkomstige taak IDs en zie Werk met wezen taken.

  4. Volg de instructies in zuivert gebruikersgegevens van werkschemainstanties die op de sectie van identiteitskaarts van de procesinstantieworden gebaseerd zodat kunt u gebruikersgegevens voor geïdentificeerde procesinstantie IDs schrappen.

Id's van procesinstanties identificeren wanneer gebruikersgegevens worden opgeslagen in primitieve variabelen primitive

Een workflow kan zo worden ontworpen dat de gebruikersgegevens worden vastgelegd in een variabele die als een blob in de database wordt opgeslagen. In dergelijke gevallen kunt u alleen gebruikersgegevens opvragen als deze zijn opgeslagen in een van de volgende primitieve variabelen:

  • Koord: Bevat direct de gebruiker - identiteitskaart of als substring en kan worden gevraagd gebruikend SQL.
  • Numeriek: Bevat direct gebruiker - identiteitskaart
  • XML: Bevat gebruiker - identiteitskaart als substring binnen de tekst die als tekstkolommen in gegevensbestand wordt opgeslagen en kan als koorden worden gevraagd.

Voer de volgende stappen uit zodat u kunt bepalen of een werkschema dat gegevens in primitieve-type variabelen opslaat gegevens voor de gebruiker bevat:

  1. Voer de volgende databaseopdracht uit:

    code language-sql 
    select database_table from omd_object_type where name='pt_<app_name>/<workflow_name>'

    De query retourneert een tabelnaam in tb_<number> -indeling voor de opgegeven toepassing ( app_name ) en workflow ( workflow_name ).

    note note
    NOTE
    De waarde van de eigenschap name kan complex zijn als de workflow in submappen in de toepassing is genest. Zorg ervoor dat u het exacte volledige pad naar de workflow opgeeft, dat u kunt ophalen uit de databasetabel omd_object_type .

  2. Controleer het tb_<number> tabelschema. De tabel bevat variabelen die gebruikersgegevens voor de opgegeven workflow opslaan. De variabelen in de tabel komen overeen met de variabelen in de workflow.

    Identificeer en neem nota van de variabele die aan werkschemavariabele beantwoordt die de gebruiker - identiteitskaart bevat Als de geïdentificeerde variabele van primitief-type is, kunt u een vraag in werking stellen om werkschemamonstanties te bepalen verbonden aan een gebruiker - identiteitskaart

  3. Voer het volgende gegevensbestandbevel uit. In deze opdracht is user_var de variabele van het primitieve type die de gebruiker-id bevat.

    code language-sql 
    select process_instance_id from <tb_name> where <user_var>=<user_ID>

    De query retourneert alle procesinstantie-id's die aan de opgegeven user_ID zijn gekoppeld.

  4. Volg de instructies in zuivert gebruikersgegevens van werkschemainstanties die op de sectie van identiteitskaarts van de procesinstantieworden gebaseerd zodat kunt u gebruikersgegevens voor geïdentificeerde procesinstantie IDs schrappen.

Gebruikersgegevens uit workflowinstanties wissen op basis van procesinstantie-id's purge

Nu u de procesinstantie-id's hebt geïdentificeerd die aan een gebruiker zijn gekoppeld, gaat u als volgt te werk om gebruikersgegevens te verwijderen uit de respectieve procesinstanties.

  1. Voer de volgende opdracht uit, zodat u de aanroepings-id en -status voor een procesinstantie van lange duur kunt ophalen uit de tabel tb_process_instance .

    code language-sql 
    select long_lived_invocation_id, status from tb_process_instance where id='process_instance_id'

    De query retourneert de langlevende aanroepings-id en -status voor de opgegeven process_instance_id .

  2. Maak een instantie van de openbare ProcessManager client ( com.adobe.idp.workflow.client.ProcessManager ) met behulp van een ServiceClientFactory -instantie met de juiste verbindingsinstellingen.

    Voor meer informatie, zie Java™ API verwijzing voor ProcessManager van de Klasse.

  3. Controleer de status van de workflowinstantie. Als de status anders is dan 2 (COMPLETE) of 4 (TERMINATED), beëindigt u de instantie eerst door de volgende methode aan te roepen:

    ProcessManager.terminateProcess(<long_lived_invocation_id>).

  4. Wis de werkstroominstantie door de volgende methode aan te roepen:

    ProcessManager.purgeProcessInstance(<long_lived_invocation_id>)

    De methode purgeProcessInstance verwijdert alle gegevens voor de opgegeven oproepings-id volledig uit de AEM Forms Server-database en GDS, indien geconfigureerd.

Werken met wezen orphan

Orphan-taken zijn de taken waarvan het omvattende proces is gestart maar nog niet is ingediend. In dit geval, is process_instance_id 0 (nul). Daarom kunt u gebruikersgegevens die voor wezen taken worden opgeslagen niet volgen gebruikend procesinstantie IDs. Nochtans, kunt u het vinden gebruikend taakidentiteitskaart voor een wezen taak. U kunt taken IDs van de tb_task lijst voor een gebruiker identificeren zoals die in wordt beschreven identificeer procesinstantie IDs wanneer werkschemaminitiator of deelnemergekend is.

Als u de taak-id's hebt, voert u de volgende handelingen uit om de bijbehorende bestanden en gegevens te wissen met een wezen-taak uit GDS en de database.

  1. Voer de volgende opdracht uit in de AEM Forms Server-database, zodat u id's voor de geïdentificeerde taak-id's kunt ophalen.

    code language-sql 
    select id from tb_form_data where task_id=<task_id>

    De query retourneert een lijst met id's. Voor elke id ( fd_id) die in de resultaten wordt geretourneerd, maakt u als volgt een lijst met sessie-id-tekenreeksen:

    • _ wfattach<task_id>
    • _wftask<fd_id>
    • _wftaskformid<fd_id>

  2. Voer een van de volgende stappen uit, afhankelijk van het feit of uw GDS naar een bestandssysteem of database verwijst:

    1. GDS in dossiersysteem

      In het GDS-bestandssysteem:

      1. Zoek naar dossiers met de volgende koorden van zitting ID als hun uitbreidingen:

      • _wfattach<task_id>
      • _wftask<fd_id>
      • _wftaskformid<fd_id>

      De bestanden met deze extensies zijn de markeringsbestanden. Ze worden opgeslagen met bestandsnamen in de volgende indeling:

      <file_name_guid>.session<session_id_string>

      1. Verwijder alle markeringsbestanden en andere bestanden met de exacte bestandsnaam als <file_name_guid> uit het bestandssysteem.

    2. GDS in gegevensbestand

      Voer de volgende bevelen voor elke zitting-identiteitskaart uit:

      code language-sql 
      delete from tb_dm_chunk where documentid in (select documentid from tb_dm_session_reference where sessionid=<session_id>)
delete from tb_dm_session_reference where sessionid=<session_id>
delete from tb_dm_deletion where sessionid=<session_id>

  3. Voer de volgende opdrachten uit, zodat u gegevens voor taak-id's kunt verwijderen uit de AEM Forms Server-database:

    code language-sql 
    delete from tb_task_acl where task_id=<task_id>
delete from tb_task_attachment where task_id=<task_id>
delete from tb_form_data where task_id=<task_id>
delete from tb_assignment where task_id=<task_id>
delete from tb_task where id=<task_id>
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2