Action Center - Créer une tâche de formulaire

Description

Crée une action de formulaire dans les instances cloud et locales d’Action Center. Il crée également une tâche de formulaire dans On-Premises Orchestrator version 21.4 et inférieure.

Prérequis

Cette activité a besoin de la dépendance UiPath.FormActivityLibrary pour fonctionner correctement.
Assurez-vous d'utiliser UiPath.Persistence.Activities v1.2.1+ dans Studio v2021.4. Sinon, lorsque vous ouvrez le Concepteur de fiches, il ne conserve pas le focus et vous pouvez interagir avec les éléments de l'interface utilisateur de Studio.

Important : la mise en page du formulaire est limitée à 1 Mo maximum. Pour tenir dans cette limite de 1 Mo, vous devez incorporer des images dans des formulaires, en utilisant uniquement des compartiments de stockage. En outre, nous suggérons d'utiliser des images de type base64 uniquement pour les logos et les icônes de moins de 2 Ko.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Windows, Windows - Configuration héritée

Module Designer

TitreTâche : le titre de l'action que vous souhaitez créer. Ce champ prend en charge les chaînes et les variables String uniquement.
TaskPriority : permet de sélectionner le niveau de priorité de l'action. Par défaut, cette propriété est définie sur TaskPriority.Medium. Les options suivantes sont disponibles : TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
TaskCatalog : une classification métier facultative des éléments de tâche. Ce champ ne prend en charge que les chaînes et les variables String.

Attention : assurez-vous que le catalogue d'actions existe avant la création de l'action. Sinon, la création de l'action échoue avec le message d'erreur suivant : « Aucun catalogue de tâches n'existe avec le nom [action_catalog_name] Code d'erreur : 2451 ».
DonnéesFormulaires - Une collection de données métier au format Dictionary<String,Argument> que vous souhaitez afficher dans un formulaire dans la boîte de réception Actions. La modification des arguments Out et In/Out les renvoie au workflow une fois la tâche terminée. Ce champ prend en charge les objets Dictionary<String,Argument> uniquement.
ObjetTâche (Sortie) : l'objet de tâche renvoyé par Orchestrator en tant qu'objet FormTaskData après la création des Actions . Cet objet peut être transmis à l'activité Wait for Form Task and Resume afin de suspendre l'exécution du workflow jusqu'à ce que les Actions soient terminées.

Remarque : TaskObject possède plusieurs attributs qui contiennent des informations sur l'objet d'action de sortie. Par exemple, l'attribut TaskUrl vous donne l'URL de l'action à l'intérieur de l'onglet Actions dans Orchestrator On-Premises, tandis que l'attribut ActionUrl vous donne l'URL de l'action à l'intérieur de l'onglet Actions dans Automation Cloud. Pour accéder à l'action à partir d'Action Center sur site, ajoutez /actions_/tasks/taskID à l'URL de base d'Action Center, par exemple : https://laptop-name:port-number/actions_/tasks/taskID.

Cliquer sur le bouton Ouvrir le concepteur de formulaires ( Open Form Designer) ouvre l'assistant du concepteur de formulaires , qui vous permet de personnaliser le formulaire que vous souhaitez utiliser dans votre workflow.

Le bouton Ouvrir le concepteur de formulaires groupé (Open Bulk Form Designer) devient disponible lorsque la propriété Activer la modification groupée (Enable Bulk Edit) est sélectionnée. Cette option ouvre Bulk Form Designer et vous permet de concevoir des actions de formulaire qui peuvent être modifiées ou complétées de manière groupée dans l'onglet Actions de l'instance Action Center correspondante.

Panneau propriétés

Commun

Poursuite sur erreur (ContinueOnError) - Spécifie si l'automatisation doit continuer même si l'activité génère un message d'erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et si une erreur est renvoyée, l'exécution du projet s'interrompt. Si la valeur est configurée sur True, l'exécution du projet continue indépendamment de toute erreur.

Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera détectée lors de l'exécution du projet.

NomAffichage (DisplayName) - Nom affiché de l'activité.
TimeoutMS - Spécifie la durée (en millisecondes) d'attente d'exécution de l'activité avant la génération d'un message d'erreur. La valeur par défaut est 30 000 millisecondes (30 secondes).

Entrée

Activer la modification groupée : si cette option est sélectionnée, le bouton Ouvrir le concepteur de formulaires groupé ( Open Bulk Form Designer) devient disponible dans le corps de l'activité. Cette option vous permet de générer desactions de formulaire qui peuvent être modifiées ou complétées de manière groupée à partir de l'onglet Actions dans Action Center.
DonnéesFormulaires - Une collection de données métier au format Dictionary<String,Argument> que vous souhaitez afficher dans un formulaire dans la boîte de réception Actions. La modification des arguments Out et In/Out les renvoie au workflow une fois la tâche terminée. Ce champ prend en charge les objets Dictionary<String,Argument> uniquement.
GenerateInputFields : si cette option est sélectionnée, toutes les entrées de la collecte de données de formulaire sont générées en tant que composants dans le Concepteur de formulaires. Le laisser vide n'ajoute pas de champs de formulaire supplémentaires au concepteur.
Libellés (Labels) : le robot ajoute les libellés saisis à l'action, permettant un filtrage futur. Ce champ ne prend en charge que les valeurs de chaîne et comporte des restrictions de nommage.

Remarque : pour autoriser le labellisation automatique des actions via les activités de persistance, le compte Robot exécutant le workflow doit disposer des autorisations Consultation ( View), Création ( Create) et Suppression ( Delete ) sur les balises.

Chemin d'accès au dossier Orchestrator : le chemin d'accès au dossier Orchestrator que vous souhaitez utiliser avec cette activité. Si ce champ est laissé vide, le dossier Orchestrator actuel est utilisé. Ce champ ne prend en charge que les chaînes et les variables String.

Remarque : si l’utilisateur effectuant cette action ne dispose pas des autorisations requises pour le dossier cible, la création de la tâche échoue et génère une erreur critique. Afficher plus d'informations sur les autorisations de dossier.

Référence (Reference) : le nom utilisé comme référence pour le futur filtrage des actions. Ce champ prend uniquement en charge les valeurs de chaîne.
TaskCatalog : une classification métier facultative des éléments de tâche. Ce champ ne prend en charge que les chaînes et les variables String.

Attention : assurez-vous que le catalogue d'actions existe avant la création de l'action. Sinon, la création de l'action échoue avec le message d'erreur suivant : « Aucun catalogue de tâches n'existe avec le nom [action_catalog_name] Code d'erreur : 2451 ».
TaskPriority : permet de sélectionner le niveau de priorité de l'action. Par défaut, cette propriété est définie sur TaskPriority.Medium. Les options suivantes sont disponibles : TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
TitreTâche : le titre de l'action que vous souhaitez créer. Ce champ prend en charge les chaînes et les variables String uniquement.
Utiliser un fichier deformulaire local (Use Local Form File ) : permet de créer des actions de formulaire à l'aide d'un fichier de formulaire JSON, spécifié lors de l'exécution. Ce champ prend en charge les valeurs Boolean uniquement. Lorsque vous l'activez, le champ de propriété Chemin du fichier de formulaire ( Form File Path ) apparaît dans le corps de l'activité, où vous spécifiez le chemin d'accès au fichier JSON, où une certaine mise en page de formulaire est stockée.

Après avoir sélectionné Utiliser un fichier de formulaire local (Use Local Form File), cliquez sur Ouvrir le Concepteur de formulaires ( Open Form Designer), sélectionnez Nouveau(New) et commencez à créer un formulaire. Lorsque vous avez terminé, sélectionnez Enregistrer souset enregistrez-le dans le dossier du projet correspondant. Le formulaire que vous avez précédemment créé est maintenant stocké dans un fichier JSON. Saisissez le chemin d'accès à ce fichier JSON dans le champ Chemin du fichier de formulaire ( Form File Path ) pour utiliser ce formulaire au moment de l'exécution.

Divers

Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Sortie

ObjetTâche (Sortie) : l'objet de tâche renvoyé par Orchestrator en tant qu'objet FormTaskData après la création des Actions . Cet objet peut être transmis à l'activité Wait for Form Task and Resume afin de suspendre l'exécution du workflow jusqu'à ce que les Actions soient terminées.

Stockage

Nom du compartiment de stockage : le compartiment de stockage que vous souhaitez utiliser pour les fichiers de données volumineux référencés dans les données du formulaire.
Chemin d'accès au dossier de stockage (Storage Folder Path) - Chemin d'accès complet au dossier dans le compartiment de stockage spécifié. Ce champ prend en charge les chaînes et les variables String uniquement.

Astuce :
L'utilisation de l'intégration d'image avec les compartiments de stockage doit être effectuée conjointement avec l'activité. Le nom de l'argument doit être suffixé dans la propriété CollecteDonnéesFormulaire et mappé à une image du formulaire, en utilisant le trait de soulignement (_) dans un composant Élément HTML.

Le nom de l'argument (<key>_storage) doit être mappé à la valeur de stockage dans la propriété Destination de l'activité Télécharger le fichier de stockage ( Upload Storage File ).

Notez que les noms de fichiers image ne doivent pas contenir un signe plus (+), car ce caractère est masqué par le processus de téléchargement du compartiment de stockage, ce qui entraîne une erreur.

Configuration multiplateforme

TitreTâche : le titre de l'action que vous souhaitez créer. Ce champ prend en charge les chaînes et les variables String uniquement.
TaskPriority : permet de sélectionner le niveau de priorité de l'action. Par défaut, cette propriété est définie sur TaskPriority.Medium. Les options suivantes sont disponibles : TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
TaskCatalog : une classification métier facultative des éléments de tâche. Ce champ ne prend en charge que les chaînes et les variables String.

Attention : assurez-vous que le catalogue d'actions existe avant la création de l'action. Sinon, la création de l'action échoue avec le message d'erreur suivant : « Aucun catalogue de tâches n'existe avec le nom [action_catalog_name] Code d'erreur : 2451 ».
DonnéesFormulaires - Une collection de données métier au format Dictionary<String,Argument> que vous souhaitez afficher dans un formulaire dans la boîte de réception Actions. La modification des arguments Out et In/Out les renvoie au workflow une fois la tâche terminée. Ce champ prend en charge les objets Dictionary<String,Argument> uniquement.
ObjetTâche (Sortie) : l'objet de tâche renvoyé par Orchestrator en tant qu'objet FormTaskData après la création des Actions . Cet objet peut être transmis à l'activité Wait for Form Task and Resume afin de suspendre l'exécution du workflow jusqu'à ce que les Actions soient terminées.

Remarque : TaskObject possède plusieurs attributs qui contiennent des informations sur l'objet d'action de sortie. Par exemple, l'attribut TaskUrl vous donne l'URL de l'action à l'intérieur de l'onglet Actions dans Orchestrator On-Premises, tandis que l'attribut ActionUrl vous donne l'URL de l'action à l'intérieur de l'onglet Actions dans Automation Cloud. Pour accéder à l'action à partir d'Action Center sur site, ajoutez /actions_/tasks/taskID à l'URL de base d'Action Center, par exemple : https://laptop-name:port-number/actions_/tasks/taskID.

Cliquer sur le bouton Ouvrir le concepteur de formulaires (Open Form Designer) ouvre l'assistant, qui vous permet de personnaliser le formulaire que vous souhaitez utiliser dans votre workflow.

Le bouton Ouvrir le concepteur de formulaires groupé (Open Bulk Form Designer) devient disponible lorsque la propriété Activer la modification groupée (Enable Bulk Edit) est sélectionnée. Cette option vous permet de concevoir des actions de formulaire qui peuvent être modifiées ou complétées de manière groupée dans l'onglet Actions de l'instance Action Center correspondante.

Options avancées