Create Form Task

UiPath.Persistence.Activities.FormTask.CreateFormTask

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

• 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.

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 ne prend en charge que les chaînes et les variables String .
• PrioritéTâche : 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.Critique.
• CatalogueTâches : classification métier facultative des éléments de tâches. 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éesFormulaire : 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 après la fin de la tâche. Ce champ ne prend en charge que les objets Dictionary<String,Argument> .
• ObjetTâche(Sortie) : l'objet de tâche renvoyé par Orchestrator en tant qu'objet FormTaskData après la création de l'action. Cet objet peut être transmis à l'activité Wait for Form Task and Resume afin de suspendre l'exécution du workflow jusqu'à ce que l'action soit terminée.

Remarque :

ObjetTâche a 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 depuis la version locale d'Action Center, 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

• ContinuerSurErreur (ContinueOnError) : spécifie si l’automatisation doit se poursuivre même lorsque l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (Vrai (True), Faux (False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l’exécution du projet se poursuit même en cas d’erreur.

Remarque :

Si cette activité est incluse dans Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est 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 les formulaires avancés : active les fonctionnalités et les options de personnalisation améliorées pour le rendu et la logique des formulaires, telles que :

  • Modèles personnalisables pour l'activité Modifier les grilles.
  • Boutons fonctionnant comme Événements.
  • Possibilité de personnaliser des formulaires à l'aide d'ES6 et de JavaScript moderne.
  • La disponibilité des variables instance et options 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é 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 d'Action Center.

  

• DonnéesFormulaire : 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 après la fin de la tâche. Ce champ ne prend en charge que les objets Dictionary<String,Argument> .

• GénérerChampsEntrée : 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 futur. Ce champ ne prend en charge que les valeurs de chaîne et comporte des restrictions d'affectation de noms.

Remarque :

Pour permettre la labellisation automatique des actions via les activités de Persistance, le compte Robot exécutant le workflow a besoin des autorisations Consultation, Création et Supprimer par rapport aux 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 sera 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 Autorisations de dossier.

• Référence - Le nom utilisé comme référence pour le futur filtrage des actions. Ce champ ne prend en charge que les valeurs de chaîne.

• CatalogueTâches : classification métier facultative des éléments de tâches. 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 ».

• PrioritéTâche : 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.Critique.

• TitreTâche : le titre de l'action que vous souhaitez créer. Ce champ ne prend en charge que les chaînes et les variables String .

• Utiliser le fichier de formulaire local : 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 uniquement en charge les valeurs Boolean . Lorsque vous activez cette option, le champ de propriété Chemin du fichier de formulaire s'affiche 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 le fichier de formulaire local, cliquez sur Ouvrir le concepteur de formulaires, sélectionnez Nouveau et commencez à créer un formulaire. Lorsque vous avez terminé , sélectionnez Enregistrer sous et enregistrez-la dans le dossier de projet correspondant. Vous avez maintenant le formulaire que vous avez créé précédemment stocké dans un fichier JSON. Saisissez le chemin d'accès à ce fichier JSON dans le champ Chemin du fichier de formulaire 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 de l'action. Cet objet peut être transmis à l'activité Wait for Form Task and Resume afin de suspendre l'exécution du workflow jusqu'à ce que l'action soit terminée.

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 de formulaire.
• Chemin du dossier de stockage : le chemin complet du dossier dans le compartiment de stockage spécifié. Ce champ ne prend en charge que les chaînes et les variables String .
  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 . 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é Charger le fichier de stockage . Notez que les noms de fichiers image ne doivent pas contenir 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 ne prend en charge que les chaînes et les variables String .
• PrioritéTâche : 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.Critique.
• CatalogueTâches : classification métier facultative des éléments de tâches. 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éesFormulaire : 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 après la fin de la tâche. Ce champ ne prend en charge que les objets Dictionary<String,Argument> .
• ObjetTâche(Sortie) : l'objet de tâche renvoyé par Orchestrator en tant qu'objet FormTaskData après la création de l'action. Cet objet peut être transmis à l'activité Wait for Form Task and Resume afin de suspendre l'exécution du workflow jusqu'à ce que l'action soit terminée.

Remarque :

ObjetTâche a 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 depuis la version locale d'Action Center, 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

• ContinuerSurErreur (ContinueOnError) : spécifie si l’automatisation doit se poursuivre même lorsque l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (Vrai (True), Faux (False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l’exécution du projet se poursuit même en cas d’erreur.

Remarque :

Si cette activité est incluse dans Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

• 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 : active les fonctionnalités et les options de personnalisation améliorées pour le rendu et la logique des formulaires, telles que :

  • Modèles personnalisables pour l'activité Modifier les grilles.
  • Boutons fonctionnant comme Événements.
  • Possibilité de personnaliser des formulaires à l'aide d'ES6 et de JavaScript moderne.
  • La disponibilité des variables instance et options 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é 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 d'Action Center.

  

• Utiliser le fichier de formulaire local : 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 uniquement en charge les valeurs Boolean . Lorsque vous activez cette option, le champ de propriété Chemin du fichier de formulaire s'affiche 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.

• GénérerChampsEntrée : 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 futur. Ce champ ne prend en charge que les valeurs de chaîne et comporte des restrictions d'affectation de noms.

Remarque :

Pour permettre la labellisation automatique des actions via les activités de Persistance, le compte Robot exécutant le workflow a besoin des autorisations Consultation, Création et Supprimer par rapport aux 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 sera 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 Autorisations de dossier.

• Référence - Le nom utilisé comme référence pour le futur filtrage des actions. Ce champ ne prend en charge que les valeurs de chaîne.
• Chemin du fichier de formulaire : saisissez le chemin d'accès relatif au fichier JSON de 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 de formulaire.
• Chemin du dossier de stockage : le chemin complet du dossier dans le compartiment de stockage spécifié. Ce champ ne prend en charge que les chaînes et les variables String .

Problème connu

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 :

1. Ouvrez le Concepteur de formulaires.
2. Modifiez n'importe quel composant dans le formulaire, puis enregistrez les modifications.
3. Enregistrez le formulaire entier.
4. 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.