Workflows basés sur l’utilisation de Forms sur OSGi | Gestion des données utilisateur forms-centric-workflows-on-osgi-handling-user-data

Les workflows d’AEM basés sur Forms vous permettent d’automatiser des processus d’entreprise réels basés sur Forms. Les workflows se composent d’une série d’étapes qui s’exécutent dans un ordre spécifié dans le modèle de workflow associé. Chaque étape exécute une action spécifique, comme affecter une tâche à un utilisateur ou une utilisatrice ou envoyer un e-mail. Les workflows peuvent interagir avec des ressources du référentiel, les comptes d’utilisateurs et d’utilisatrices et les services. Par conséquent, les workflows peuvent coordonner des activités complexes qui impliquent tous les aspects d’Experience Manager.

Les méthodes suivantes permettent de délencher ou de lancer un workflow basé sur Forms :

  • 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
  • Utiliser un dossier de contrôle
  • Envoi d’une communication interactive ou d’une lettre

Pour plus d’informations sur les workflows et les fonctionnalités d’AEM basés sur Forms, voir Workflow basé sur Forms sur OSGi.

Données utilisateur et stockage de données user-data-and-data-stores

Le déclenchement d’un workflow entraîne la génération automatique d’une payload pour l’instance de workflow. Chaque instance de workflow se voit attribuer un ID d’instance unique et un ID de payload associé. La payload contient les emplacements de référentiel pour les données utilisateur et de formulaire associées à une instance de workflow. Les brouillons et les données historiques d’une instance de workflow sont également stockés dans le référentiel AEM.

Les emplacements de référentiel par défaut où se trouvent la payload, les brouillons et l’historique d’une instance de workflow sont les suivants :

NOTE
Vous pouvez configurer différents emplacements pour stocker la payload, les brouillons et les données historiques lors de la création d’un workflow ou d’une application. Examinez le workflow ou l’application pour identifier les emplacements où les données ont été stockées.
AEM 6.4 Forms
AEM 6.3 Forms
Instance
de workflow
/var/workflow/instances/[server_id]/<date>/[workflow-instance]/
/etc/workflow/instances/[server_id]/[date]/[workflow-instance]/
Charge utile
/var/fd/dashboard/payload/[server_id]/[date]/
[payload-id]/
/etc/fd/dashboard/payload/[server_id]/[date]/
[payload-id]/
Brouillons
/var/fd/dashboard/instances/[server_id]/
[date]/[workflow-instance]/draft/[workitem]/
/etc/fd/dashboard/instances/[server_id]/
[date]/[workflow-instance]/draft/[workitem]/
Historique
/var/fd/dashboard/instances/[server_id]/
[date]/[instance_de_workflow]/history/
/etc/fd/dashboard/instances/[server_id]/
[date]/[workflow_instance]/history/

Accès et suppression des données utilisateur access-and-delete-user-data

Vous pouvez accéder aux données utilisateur et les supprimer d’une instance de workflow dans le référentiel. Pour cela, vous devez connaître l’ID de l’instance de workflow associé à l’utilisateur ou l’utilisatrice. Vous pouvez rechercher l’ID d’instance d’une instance de workflow à l’aide du nom de l’utilisateur ou de l’utilisatrice qui a initié l’instance de workflow ou qui est la personne désignée actuelle de l’instance de workflow.

Toutefois, dans les scénarios suivants d’identification des workflows associés à un initiateur ou une initiatrice, l’identification peut échouer ou les résultats peuvent être ambigus :

  • Workflow déclenché par un dossier de contrôle  : il est impossible d’identifier une instance de workflow à l’aide de son initiateur ou initiatrice si le workflow est déclenché par un dossier de contrôle. Dans ce cas, les informations utilisateur sont codées dans les données stockées.
  • Workflow initié à partir de l’instance de publication AEM  : toutes les instances de workflow 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 d’utilisateur de la personne connectée n’est pas capturé dans les données de l’instance de workflow.

Accès aux données utilisateur access

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

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

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

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

    • Exécutez les opérations suivantes si vous connaissez l’initiateur ou l’initiatrice du workflow :

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

    • Exécutez la commande suivante si l’utilisateur des données que vous recherchez est actuellement la personne à laquelle le workflow est assigné :

    SELECT &ast; 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 workflow de l’initiateur de workflow spécifié ou de la personne à laquelle le workflow est actuellement assigné.

    Par exemple, la requête suivante renvoie le chemin d’accès de deux instances de workflow du nœud /var/workflow/instances pour lequel l’initiateur du workflow est srose.

    instance de workflow

  3. Accédez au chemin d’une instance de workflow renvoyé par la requête. La propriété Statut affiche le statut actuel de l’instance de workflow.

    status

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

    chemin_d’accès-charge_utile

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

    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 workflow renvoyées par la requête à l’étape 2.

    note note
    NOTE
    L’application AEM Forms stocke également les données en mode hors ligne. Les données d’une instance de workflow peuvent être enregistrées localement sur des appareils individuels et envoyées au serveur lorsque l’application se synchronise avec le serveur.Forms

Suppression de données utilisateur delete-user-data

Vous devez être administrateur ou administratrice AEM pour supprimer les données utilisateur des instances de workflow de la manière suivante :

  1. Suivez les instructions de la section Accès aux données utilisateur et notez ce qui suit :

    • Chemins d’accès aux instances de workflow associées à l’utilisateur ou à l’utilisatrice
    • Statut des instances de workflow
    • Chemins d’accès aux payloads des instances de workflow
    • Chemins d’accès aux brouillons et à l’historique des instances de workflow
  2. Effectuez cette étape pour des instances de workflow à l’état EN COURS,SUSPENDU ou ​OBSOLÈTE :

    1. Accédez à https://'[server]:[port]'/aem/start.html et connectez-vous avec les informations d’identification de l’administrateur.

    2. Accédez à Outils > Workflow > Instances.

    3. Sélectionnez les instances de workflow appropriées pour l’utilisateur et sélectionnez Arrêter pour arrêter les instances en cours d’exécution.

      Pour plus d’informations sur l’utilisation des instances de workflow, voir Gestion des instances de workflow.

  3. Accédez à la console CRXDE Lite, puis au chemin d’accès de la charge utile d’une instance de workflow et supprimez le nœud payload.

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

  5. Accédez au chemin d’accès de l’historique d’une instance de workflow et supprimez le nœud history.

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

    note note
    NOTE
    La suppression de l’instancier de workflow supprime l’instance de workflow pour tous les participantes et participants au workflow.
  7. Répétez les étapes 2 à 6 pour toutes les instances de workflow identifiées pour un utilisateur ou une utilisatrice.

  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 workflow afin d’éviter tout envoi au serveur.

Vous pouvez également utiliser des API pour accéder aux nœuds et propriétés et les supprimer. Consultez la documentation suivante pour en savoir plus.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2