Flux de travail basé sur l’utilisation de Forms sur OSGi | Gestion des données utilisateur

Les flux de travail AEM basé sur l’utilisation de Forms vous permettent d’automatiser les processus réels d’entreprise axés sur les formulaires. Les flux de travail se composent d’une série d’étapes effectuées dans un ordre spécifique dans le modèle de flux de travail associé. Chaque étape exécute une action spécifique, par exemple, attribuer une tâche à un utilisateur ou envoyer un message électronique. Les flux de travail peuvent interagir avec des ressources dans le référentiel, les comptes utilisateur, et dans les services. Les flux de travail peuvent donc coordonner des activités complexes qui impliquent tous les aspects d’Experience Manager.

Un flux de travail basé sur l’utilisation de Forms peut être déclenché ou lancé à l’aide de l’une des méthodes suivantes :

• Envoi d’une demande depuis la boîte de réception AEM
• Envoi d’une demande depuis l’application AEM Forms
• Envoi d’un formulaire adaptatif
• Utilisation d’un dossier de contrôle
• Envoi d’une communication interactive ou d’une lettre

Pour plus d’informations sur les flux de travail et les fonctionnalités AEM basés sur l’utilisation de Forms, voir Flux de travail basé sur l’utilisation de Forms sur OSGi.

Données utilisateur et stockage de données

Lorsqu’un flux de travail est déclenché, une charge utile est générée automatiquement pour l’instance de flux de travail. Chaque instance de flux de travail se voit attribuer un ID d’instance unique et un ID de charge utile associé. La charge utile contient les emplacements de référentiel pour les données d’utilisateur et de formulaire associées à une instance de flux de travail. Par ailleurs, les données d’historique et de brouillon d’une instance de flux de travail sont également stockées dans le référentiel AEM.

Les emplacements de référentiel par défaut où la charge utile, les brouillons et l’historique d’une instance de flux de travail résident sont les suivants :

Accès et suppression des données utilisateur

Vous pouvez accéder et supprimer des données utilisateur d’une instance de flux de travail dans le référentiel. Pour ce faire, vous devez connaître l’ID de l’instance de flux de travail associé à l’utilisateur. Vous pouvez rechercher l’ID d’une instance de flux de travail à l’aide du nom de l’utilisateur qui a initié l’instance de flux de travail ou à qui l’instance de flux de travail est actuellement attribuée.

Notez toutefois que l’identification est impossible ou les résultats sont ambigus lors de l’identification des flux de travail associés à un initiateur dans les cas suivants :

• Flux de travail déclenché par un dossier de contrôle : une instance de flux de travail ne peut pas être identifiée à l’aide de son initiateur si le flux de travail est déclenché par un dossier de contrôle. Dans ce cas, les informations de l’utilisateur sont codées dans les données stockées.
• Flux de travail initié à partir de l’instance de publication AEM : toutes les instances de flux de travail sont créées à l’aide d’un utilisateur de service lorsque les formulaires adaptatifs, les communications interactives ou les lettres sont envoyés depuis l’instance de publication AEM. Dans ce cas, le nom de l’utilisateur connecté n’est pas capturé dans les données de l’instance de flux de travail.

Accès aux données utilisateur

Pour identifier et accéder aux données utilisateur stockées pour une instance de flux de travail, procédez comme suit :

1. Sur AEM instance d’auteur, accédez à https://[server]:[port]/crx/de et à Outils > Requête.

   Sélectionnez SQL2 dans le menu déroulant Type.

2. Selon les informations disponibles, effectuez l’une des requêtes suivantes :

   • Exécutez la commande suivante si l’initiateur de flux de travail est connu :

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

   • Exécutez les actions suivantes si l’utilisateur dont vous recherchez les données est la personne désignée pour le flux de travail actuel :

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

   La requête renvoie l’emplacement de toutes les instances de flux de travail de l’initiateur de flux de travail spécifié ou de la personne à laquelle le flux de travail est actuellement assigné.

   Par exemple, la requête suivante renvoie deux chemins d’accès d’instances de flux de travail à partir du noeud /var/workflow/instances dont l’initiateur de flux de travail est srose.

   

3. Accédez à un chemin d’instance de flux de travail renvoyé par la requête. La propriété Etat affiche l’état actuel de l’instance de flux de travail.

   

4. Dans le noeud d’instance de processus, accédez à data/payload/. La propriété path enregistre le chemin de la charge utile de l’instance de flux de travail. Vous pouvez accéder au chemin d’accès des données stockées dans la charge utile.

   

5. Accédez aux emplacements des brouillons et de l’historique de l’instance de flux de travail.

   Par exemple :

   /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. Répétez les étapes 3 à 5 pour toutes les instances de flux de travail renvoyées par la requête à l’étape 2.

Suppression de données utilisateur

Vous devez être un administrateur AEM pour supprimer des données utilisateur des instances de flux de travail en suivant la procédure suivante :

1. Suivez les instructions indiquées dans la section Accès aux données utilisateur et notez les éléments suivants :

   • Chemins d’accès aux instances de flux de travail associées à l’utilisateur
   • Etat des instances de flux de travail
   • Chemins d’accès aux charges utiles pour les instances de flux de travail
   • Chemins d’accès aux brouillons et à l’historique des instances de flux de travail

2. Effectuez cette étape pour les instances de flux de travaux dans l’état EN COURS, SUSPENDU ou STALE :

   1. Accédez à https://[server]:[port]/aem/start.html et connectez-vous avec les informations d’identification de l’administrateur.
   2. Accédez à Outils > Flux de travail > Modèles.
   3. Sélectionnez les instances de flux de travail correspondant à l’utilisateur et appuyez sur Arrêter pour arrêter les instances en cours d’exécution.

   Pour plus d’informations sur l’utilisation des instances de processus, voir Administration des instances de processus.

3. Accédez à la console du CRXDE Lite, accédez au chemin de charge utile d’une instance de processus et supprimez le noeud payload.

4. Accédez au chemin d’accès des brouillons d’une instance de flux de travail et supprimez le nœud draft.

5. Accédez au chemin d’accès à l’historique d’une instance de processus et supprimez le noeud history.

6. Accédez au chemin d’accès de l’instance de workflow pour une instance de workflow et supprimez le noeud [workflow-instance-ID] du workflow.

   REMARQUE

   La suppression du nœud d’une instance de flux de travail entraîne la suppression de l’instance de flux de travail pour tous les participants au flux.

7. Répétez les étapes 2 à 6 pour toutes les instances de flux de travail identifiées pour un utilisateur.

8. Identifiez et supprimez les données de brouillon et d’envoi hors ligne dans la boîte d’envoi de l’application AEM Forms des participants au flux de travail afin d’éviter tout envoi au serveur.

Vous pouvez également utiliser des API pour accéder et supprimer des nœuds et des propriétés. Consultez les documents suivants pour plus d’informations.

• Comment accéder au JCR AEM par programmation
• Suppression des nœuds et propriétés
• Guide de référence des API