Validation des résultats de flux avec Communications Mining

Ce guide de démarrage rapide vous aide à commencer à valider les résultats de flux en ajoutant la station de validation dans les applications UiPath® Action, puis en les envoyant pour validation via Action Center en tant qu’actions d’application. Le tutoriel utilise UiPath Studio pour automatiser le traitement des résultats de flux, UiPath Apps pour afficher la station de validation et Action Center pour effectuer la validation. Le type de document utilisé dans les exemples tout au long de ce tutoriel est un formulaire d'assurance maladie, de type formulaire de demande CMS 1500.

Les étapes de vue d'ensemble de ce guide de démarrage rapide sont les suivantes :

1. Construisez l'application d'action qui affiche le contrôle de validation.
2. Utilisez une application précédemment configurée pour concevoir l'automatisation de Studio qui traite les résultats de flux et les envoie pour validation dans Action Center.
3. Terminez l’action dans Action Center.

Étapes

1. Créer une application Action

Prérequis

Assurez-vous que votre locataire :

• Possède suffisamment de Robot Units, puisque l'application s'exécute à l'aide de robots Serverless.
• Un modèle de robot sans serveur est créé dans Orchestrator et enregistré. Pour plus d'informations sur les robots sans serveur et leur ajout à un locataire, consultez Exécution d'automatisations unattended avec des robots sans serveur.

1. Créer une application Action

Remarque : contrairement aux applications VB disponibles via le service Apps, les applications sont accessibles via Studio Web.

Pour créer une application Action (Action), procédez comme suit :

1. Accédez à Studio Web.
2. Sélectionnez Créer nouveau, puis sélectionnez Application pour créer un nouveau projet.
3. Dans l' explorateur de projets (Project Explorer) de votre application, sélectionnez Ajouter des pages, des workflows, des contrôles, des intégrations (Add pages, workflows, controls, integrations), puis sélectionnez Action (Action).

   Cette étape ajoute une action à votre application et vous permet de configurer un schéma d'action pour celle-ci.

4. Développez Action et sélectionnez SchémaAction.

   Configurez le schéma d'action avec les arguments d'entrée et de sortie souhaités pour les actions d'application dans Action Center.

   1. Pour Résultats (Outcomes), ajoutez d'autres résultats personnalisés pour votre action.
      Par exemple, vous pouvez ajouter un résultat personnalisé nommé Approve.
   2. Pour les propriétés d'entrée, ajoutez des propriétés pour les données que vous souhaitez transmettre dans l'action.

      Ces propriétés apparaîtront dans l'activité Créer une tâche d'application (Create App Task) lorsque cette application sera sélectionnée dans la liste déroulante Applications (Apps) . Les propriétés d'entrée vous permettent de transmettre des données de votre automatisation Studio à votre action.

   3. Pour les propriétés de sortie, ajoutez des propriétés pour les arguments que vous souhaitez récupérer de l'action.

      Ces propriétés seront accessibles à partir de l'activité Attendre la tâche d'application et reprendre (Wait for App Task and Resume) , via la variable Objet de tâche (sortie) .

   4. Pour les propriétés Entrée/Sortie (Input/Output) , ajoutez des propriétés qui fonctionnent comme arguments In/Out dans votre automatisation Studio.

      Ces propriétés d'entrée/de sortie apparaissent d'abord en tant que propriétés dans l'activité Créer une tâche d'application (Create App Task) , que vous transmettez à l'action. Ensuite, une fois l'action terminée, vous pouvez accéder aux mêmes propriétés qui ont été mises à jour à partir de l'activité Attendre l'application de tâche et reprendre (Wait for App Task and Resume ), via la propriété Objet de tâche (sortie) (Task Object (Output)) .

2. Ajouter et personnaliser le contrôle de validation

Un contrôle de validation intègre la station de validation utilisée dans le traitement des workflows qui contiennent des résultats de flux. Pour ajouter et personnaliser un contrôle de validation dans une application Action, suivez ces étapes :

1. Ouvrez l'application d'action souhaitée, où vous souhaitez intégrer la station de validation.
2. Sélectionnez Ouvrir la boîte à outils.
3. Sous Affichage (Display), recherchez le contrôle de validation (Validation Control) et ajoutez-le à votre application.
   L'ajout du contrôle de validation à votre application crée automatiquement une variable Var<ValidationControl_PageName> dans la section Variables d'application (App variables) de l' Explorateur de projets (Project Explorer) de votre application.
   Remarque : vous pouvez utiliser le contrôle de validation et la variable d'application correspondante pour lire les informations du contrôle de validation. Utilisez la variable d'application Var<ValidationControl_PageName> pour y écrire des informations.
4. Préparez le schéma d'action :
   1. Dans l' explorateur de projets, sous Action, sélectionnez SchémaAction.
   2. Dans les propriétés d’entrée, sélectionnez Ajouter une propriété.
   3. Dans la barre de recherche de propriétés, sélectionnez Plus d'options (More Options).
   4. Sous Avancé (Advanced), sélectionnez DonnéesValidationContenu (ContentValidationData).
      Il s'agit de la propriété d'entrée qui s'affichera dans l'activité Créer une tâche d'application (Create App Task) . La propriété d'entrée ContentValidationData nécessite un objet ContentValidationData en tant qu'entrée, qui peut être un objet unique ou un tableau/une liste d'instances ContentValidationData . ContentValidationData contient les artefacts de la station de validation. ContentValidationData est créé à l'aide de l'activité Créer des artefacts de validation de Communications Mining .
5. Configurez le contrôle de validation (Validation Control) :
   1. Accédez aux propriétés du contrôle de validation .
   2. Dans l'entrée Source , sélectionnez l'entrée Action que vous avez définie comme type ContentValidationData .
6. Configurez le reste de l'application avec d'autres contrôles dont vous avez besoin.

3. Créer des événements pour le contrôle de validation

Vous pouvez déclencher divers événements spécifiques au contrôle de validation. Dans l' explorateur de projets, accédez au contrôle de validation et sélectionnez-le. Le panneau Événements (Events ) du contrôle de validation vous permet de définir des automatisations pour des événements spécifiques.

Le tableau suivant décrit les événements de contrôle de validation disponibles :

Tableau 1. Événements de contrôle de validation

Événement (Event)	Description
Sur prêt	Se déclenche lorsque le contrôle de validation est chargé.
Type de document modifié	Se déclenche lorsque l'utilisateur modifie le type de document à partir du contrôle de validation.
Champ sélectionné	Se déclenche lorsque l'utilisateur sélectionne l'un des champs, ou la valeur d'un champ, dans le contrôle de validation.
Valeur du champ modifiée	Se déclenche lorsque l'utilisateur ajoute, supprime ou remplace une valeur de champ dans le contrôle de validation.

4. Utiliser des activités de contrôle de validation dédiées

Vous pouvez utiliser des activités spécifiques dédiées à l'utilisation du contrôle de validation à partir du package AppEvents.Activities :

1. Définir l'accent sur le champ du contrôle de validation (Set Validation Control Field Focus) : vous permet de vous concentrer sur un champ, en fonction d'un événement configuré.
2. Enregistrer l'état du contrôle de validation (Save Validation Control State) : enregistre l'état du contrôle de validation. Vous pouvez l'utiliser lorsque vous souhaitez revoir et terminer la validation ultérieurement.

5. Publier et déployer l'application

Après avoir créé votre application Action et déclenché les automatisations pour les contrôles à l'intérieur, vous pouvez la publier. La publication de l’application la rend disponible pour la création d’actions d’application. Pour plus d’informations sur la publication d’applications, consultez la section Publication, déploiement et mise à niveau de projets d’application.

2. Créer l'automatisation de Studio

Prérequis

• Installez les versions de package d'activités suivantes :
  • CommunicationsMining.Activities version 1.5.1 ou supérieure.
  • Persistence.Activities version 1.5.5 ou supérieure.
  • AppEvents.Activities version 3.12.0 ou supérieure.
• Créez un compartiment de stockage dans Orchestrator, dans le même dossier où vous souhaitez publier l'automatisation qui traite les résultats des flux.

  Les données requises pour charger le contrôle de validation dans les applications sont stockées dans un compartiment de stockage Orchestrator.

• Ajoutez les résultats de flux que vous souhaitez traiter dans le dossier du projet Studio.
• Si vous souhaitez utiliser des capacités d'extraction ou de validation génératives, vous avez peut-être besoin d'unités AI. Pour plus d’informations sur la fonctionnalité d’extraction générative dans Communications Mining™, consultez la section Extraction générative.

1. Traiter un fichier à l'aide de Communications Mining

Ajoutez des activités qui utilisent Communications Mining pour traiter un fichier. Préparez le résultat du flux pour validation dans Action Center, via des applications, en utilisant la numérisation et l’extraction.

Après avoir ajouté les activités pour le traitement du fichier, la variable suivante doit être disponible :

• Résultat du flux de sortie : le résultat du flux est stocké dans une variable de la propriété de sortie, Résultats (Results) de l’activité Obtenir les résultats du flux (Get Stream Results) .

2. Envoyer les informations de validation à l'application

Une fois le résultat du flux prêt à être validé, vous pouvez préparer toutes les informations à envoyer à l'application créée et déployée précédemment. Suivez ces étapes :

1. Ajoutez une activité Créer des artefacts de validation Communications Mining pour créer l'objet Content Validation Data , qui stocke les informations nécessaires au chargement du contrôle de validation dans l'application Action.
   Dans cet exemple, configurez l'activité à l'aide des variables créées ou générées précédemment :

   • Chemin du dossier du compartiment Orchestrator (Orchestrator Bucket Folder Path): le nom du dossier Orchestrator qui héberge le compartiment de stockage dans lequel vous souhaitez créer l'action.
   • Compartiment Orchestrator: storageBucketName
   • Chemin du répertoire du compartiment Orchestrator (Orchestrator Bucket Directory Path) : le chemin du répertoire dans le compartiment de stockage précédemment saisi dans lequel vous souhaitez stocker des données d'action
   • Résultat du flux d’entrée : le résultat du flux que vous souhaitez valider. Utilisez l'une des entrées de la variable de sortie de l'activité Obtenir les résultats de flux (Get Stream Results) , qui est une collection de résultats. Sélectionnez l'une des entrées en utilisant, par exemple, <getStreamResultsOuputVariable>.Results(<index>).
   • Modèle: le modèle correspondant au résultat du flux d'entrée. Utilisez la propriété Modèle de la variable de sortie de l'activité Obtenir les résultats de flux (Get Stream Results) , disponible sous <getStreamResultsOuputVariable>.Model.

   • Délai d'attente (millisecondes): spécifiez le délai d'attente (en millisecondes) pour que l'activité se connecte à Orchestrator avant qu'une erreur ne soit générée.

   • Données de validation de contenu: la variable de sortie où toutes les informations sur le résultat du flux traité et les informations sur l'emplacement des données d'action sont stockées. Vous utiliserez par la suite cette variable de sortie comme entrée de l’activité Récupérer les artefacts de validation de Communications Mining (Retrieve Communications Mining Validation Artifacts) .

2. Ajoutez une activité Créer une tâche d'application (Create App Task) , afin de pouvoir lier l'objet à l'application précédemment conçue, puis l'envoyer à Action Center pour validation.

   Dans cet exemple, configurez l'activité comme suit :

   • Titre: CVD
   • Priorité: Medium
   • Applications: Demo.Validation.Control.in.Apps
   • Version de l'application: v2.0.0

     Après avoir sélectionné l' application et la version correspondante que vous souhaitez utiliser pour créer l'action, les propriétés d'entrée de cette application s'afficheront dans le corps de l'activité.

     • Dans cet exemple, l'une des propriétés d'entrée est Action_Content_Validation_Data, qui nécessite les artefacts de validation Communications Mining précédemment créés : contentValidationData.
   Figure 1. L'activité Créer une tâche d'application (Create App Task)
   

   

   
   
3. Ajoutez une activité Attendre la tâche d’application et reprendre (Wait for App Task and Resume) pour renvoyer les informations sur l’action et reprendre le workflow.

   Dans le champ Tâche d'application créée (Created App Task) , saisissez la variable de sortie de l'activité Créer une tâche d'application (Create App Task) .

4. Ajoutez une activité Récupérer les artefacts de Communications Mining (Retrieve Communications Mining Artifacts) pour renvoyer les artefacts de validation de Communications Mining après que l’utilisateur a effectué une validation dans Action Center.

   Définissez la variable de sortie de l’activité Créer des artefacts de validation de Communications Mining (Create Communications Mining Validation Artifacts) comme entrée de l’activité Récupérer les artefacts de validation de Communications Mining (Retrieve Communications Mining Artifacts) .

3. Effectuer la validation dans Action Center

1. Ouvrez Action Center et accédez à Mes actions (My Actions) ou Gérer les actions (Manage Actions).
2. Dans l'onglet Non affectée (Unassigned) , recherchez l'action que vous venez de créer à l'aide de la précédente automatisation Studio.
3. Si vous souhaitez vous attribuer l'action, sélectionnez l'action souhaitée, puis sélectionnez Attribuer à soi-même (Assign to self).
4. Si vous souhaitez affecter l'action à un autre utilisateur, sélectionnez Plus d’options pour l’action souhaitée. Sélectionnez ensuite Affecter à l'utilisateur (Assign to user) et sélectionnez un utilisateur dans la liste déroulante.
5. Accédez à l' onglet En attente (Pending) et terminez l'action, afin que le workflow Studio puisse être repris.