- Notes de publication
- Avant de commencer
- Démarrage
- Activités (Activities)
- Concevoir des workflows de longue durée
- Start Job And Get Reference
- Wait for Job and Resume
- Add Queue Item And Get Reference
- Wait For Queue Item And Resume
- Create Form Task
- Wait for Form Task and Resume
- Reprendre après le délai
- Assign Tasks
- Create External Task
- Wait For External Task and Resume
- Terminer la tâche
- Forward Task
- Get Form Tasks
- Get Task Data
- Add Task Comment
- Update Task Labels
- Actions
- Processus (Processes)
- Notifications
Create Form Task
UiPath.Persistence.Activities.FormTask.CreateFormTask
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
- Installez le package UiPath.FormActivityLibrary version 2.0.7 ou ultérieure pour activer le concepteur de formulaires.
- Les tâches de formulaire ont une limite de 1 Mo maximum. Pour respecter cette limite de 1 Mo, vous devez intégrer des images à l'intérieur des formulaires, en utilisant des compartiments de stockage uniquement. Nous vous suggérons d’utiliser uniquement des images de type
base64
pour les logos et les icônes de moins de 2 Ko.
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.
Important : 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 argumentsOut
etIn/Out
les renvoie au workflow une fois la tâche terminée. Ce champ prend en charge les objetsDictionary<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.
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
.
Cliquez sur le bouton Ouvrir le concepteur de formulaires (Open Form Designer) pour ouvrir l'assistant Form Designer, 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.
- 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 les formulaires avancés ( Enable Advanced Forms ) : permet d'activer des fonctionnalités améliorées et des options de personnalisation pour le rendu et la logique des formulaires, telles que :
- Modèles personnalisables pour Modifier les grilles (Edit Grids).
- Boutons fonctionnant comme des Événements.
- Possibilité de personnaliser des formulaires à l'aide d'ES6 et de JavaScript moderne.
- La disponibilité des variables
instance
etoptions
pour la personnalisation des formulaires.
- 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 des actions 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 argumentsOut
etIn/Out
les renvoie au workflow une fois la tâche terminée. Ce champ prend en charge les objetsDictionary<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 : le robot ajoute les libellés saisis à l'action, ce qui permet un filtrage ultérieur. Ce champ prend en charge les valeurs de chaîne uniquement et comporte des restrictions de nommage.
- 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.
- 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.
Important : 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é Télécharger le fichier de stockage ( Upload Storage File ). Le nom de l'argument doit être suffixé dans la propriété FormCollecteDonnées 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.
- 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.
Important : 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 argumentsOut
etIn/Out
les renvoie au workflow une fois la tâche terminée. Ce champ prend en charge les objetsDictionary<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.
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
.
Cliquez sur le bouton Ouvrir le concepteur de formulaires (Open Form Designer) pour ouvrir l'assistant Form Designer, 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.
Options avancées
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.
- 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 les formulaires avancés ( Enable Advanced Forms ) : permet d'activer des fonctionnalités améliorées et des options de personnalisation pour le rendu et la logique des formulaires, telles que :
- Modèles personnalisables pour Modifier les grilles (Edit Grids).
- Boutons fonctionnant comme des Événements.
- Possibilité de personnaliser des formulaires à l'aide d'ES6 et de JavaScript moderne.
- La disponibilité des variables
instance
etoptions
pour la personnalisation des formulaires.
- Activer la modification en bloc (Enable Bulk Edit ) : si cette option est sélectionnée, le bouton Ouvrir le concepteur de formulaires en bloc ( Open Bulk Form Designer) devient disponible dans le corps de l'activité. Cette option vous permet de générer des actions de formulaire qui peuvent être modifiées ou complétées en bloc à partir de l'onglet Actions dans Action Center.
- 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. - 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 au concepteur.
- Libellés : le robot ajoute les libellés saisis à l'action, ce qui permet un filtrage ultérieur. Ce champ prend en charge les valeurs de chaîne uniquement et comporte des restrictions de nommage.
- 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.
- 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.
- Chemin du fichier de formulaire (Form File Path ) : saisissez le chemin d'accès relatif au fichier JSON du formulaire que vous avez enregistré dans le projet actuel.
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.
Le concepteur de formulaires peut ne pas se mettre à jour automatiquement lorsqu'une nouvelle colonne est ajoutée aux composants de grille. Pour résoudre ce problème, vous pouvez utiliser la solution de contournement suivante :
- Ouvrez le Concepteur de formulaires.
- Modifiez n'importe quel composant dans le formulaire, puis enregistrez les modifications.
- Enregistrez le formulaire entier.
- Rouvrez le formulaire, annulez les modifications que vous avez apportées précédemment et enregistrez-le à nouveau.
Le formulaire devrait maintenant être réinitialisé et les nouvelles colonnes devraient être visibles.