Workflows AEM Forms JEE | Gestion des données utilisateur forms-jee-workflows-handling-user-data

Exécutez la commande suivante dans la base de données du serveur AEM Forms pour récupérer l’ID principal de l’initiateur ou l’initiatrice ou du participant ou de la participante du workflow dans la table de base de données edcprincipalentity.

select id from edcprincipalentity where canonicalname='user_ID'

La requête renvoie l’ID principal pour l’ID user_ID spécifié.

(Pour l’initiateur de workflow) Exécutez la commande suivante pour récupérer toutes les tâches associées à l’ID principal pour l’initiateur dans la table de base de données tb_task.

select * from tb_task where start_task = 1 and create_user_id= 'initiator_principal_id'

La requête renvoie des tâches déclenchées par l’initiator_ principal_id spécifié. Il existe deux types de tâche :

• Tâches terminées  : ces tâches ont été envoyées et affichent une valeur alphanumérique dans le champ process_instance_id. Notez tous les ID d’instance de processus pour les tâches envoyées et suivez les étapes.
• Tâches lancées mais non terminées  : ces tâches sont lancées mais n’ont pas encore été envoyées. La valeur du champ process_instance_id pour ces tâches est 0 (zéro). Dans ce cas, notez les ID de tâche correspondants et consultez l’article Utilisation de tâches orphelines.

(Pour les participants au workflow) Exécutez la commande suivante pour récupérer les ID d’instance de processus associés à l’ID principal du participant au processus pour l’initiateur dans la table de base de données tb_assignment.

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'

La requête renvoie les ID d’instance pour tous les processus associés au participant ou à la participante, y compris ceux où le participant ou la participante n’a envoyé aucune tâche.

Notez tous les ID d’instance de processus pour les tâches envoyées et suivez les étapes.

Pour des tâches orphelines ou des tâches où la valeur de process_instance_id est 0 (zéro), notez les identifiants de tâche correspondants et consultez l’article Utilisation de tâches orphelines.

Suivez les instructions indiquées dans la section Purger les données utilisateur des instances de workflows en fonction des ID de l’instance de processus pour supprimer les données utilisateur des ID d’instance de processus identifiés.

Exécutez la commande de base de données suivante :

select database_table from omd_object_type where name='pt_<app_name>/<workflow_name>'

La requête renvoie un nom de table au format tb_<number> pour l’application spécifiée (app_name) et le workflow (workflow_name).

Consultez le schéma du tableau tb_<number>. Le tableau contient des variables qui stockent les données utilisateur pour le workflow spécifié. Les variables de la table correspondent aux variables du workflow.

Identifiez et notez la variable qui correspond à la variable de workflow contenant l’ID utilisateur. Si la variable identifiée est de type primitif, vous pouvez exécuter une requête pour déterminer les instances de workflow associées à un ID utilisateur.

Exécutez la commande de base de données suivante : Dans cette commande, user_var est la variable de type primitif qui contient l’ID utilisateur.

select process_instance_id from <tb_name> where <user_var>=<user_ID>

La requête renvoie tous les ID d’instance de processus associés à l’ID user_ID spécifié.

Suivez les instructions indiquées dans la section Purger les données utilisateur des instances de workflow en fonction des ID d’instance de processus pour supprimer les données utilisateur des ID d’instance de processus identifiés.

Exécutez la commande suivante pour récupérer l’ID d’appel de longue durée et le statut d’une instance de processus dans le tableau tb_process_instance.

select long_lived_invocation_id, status from tb_process_instance where id='process_instance_id'

La requête renvoie l’ID d’appel de longue durée et le statut pour l’ID process_instance_id spécifié.

Créez une instance du client ProcessManager public (com.adobe.idp.workflow.client.ProcessManager) à l’aide d’une instance ServiceClientFactory en utilisant les paramètres de connexion appropriés.

Pour plus d’informations, voir Référence de l’API Java™ pour Class ProcessManager.

Vérifiez le statut de l'instance de workflow. Si le statut n’est pas 2 (TERMINÉ) ou 4 (ARRÊTÉ), arrêtez d’abord l’instance en appelant la méthode suivante :

ProcessManager.terminateProcess(<long_lived_invocation_id>).

Purgez l’instance de workflow en appelant la méthode suivante :

ProcessManager.purgeProcessInstance(<long_lived_invocation_id>)

La méthode purgeProcessInstance supprime définitivement toutes les données de l’ID d’appel spécifié dans la base de données du serveur AEM Forms et du répertoire de stockage global de documents, s’il est configuré.

Exécutez la commande suivante sur la base de données du serveur AEM Forms afin de récupérer les ID des tâches identifiés.

select id from tb_form_data where task_id=<task_id>

La requête renvoie une liste d’ID. Pour chaque ID (fd_id) renvoyé dans les résultats, créez une liste de chaînes d’ID de session comme suit :

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

Selon que votre stockage global de document pointe vers un système de fichiers ou une base de données, effectuez l’une des opérations suivantes :

1. Répertoire de stockage global de documents dans le système de fichiers

   Dans le système de fichiers du répertoire de stockage global de documents :

   1. Recherchez les fichiers avec les extensions de chaînes d’ID de session suivantes :

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

   Les fichiers possédant ces extensions sont les fichiers de marquage. Ils sont stockés avec des noms de fichier au format suivant :

   <file_name_guid>.session<session_id_string>

   1. Supprimez tous les fichiers de marquage et d’autres fichiers portant le nom de fichier exact <file_name_guid> du système de fichiers.

2. GSD dans la base de données

   Exécutez les commandes suivantes pour chaque ID de session :

   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>

Exécutez les commandes suivantes afin de pouvoir supprimer les données des ID de tâche de la base de données du serveur AEM Forms :

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>