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

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.
• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• TaskCatalog - An optional business classification of task items. This field supports only strings and String variables.
  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 ».

• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.
• 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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  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.

  

• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.

• GenerateInputFields - If selected, all the entries from the Form Data Collection are generated as components in the Form Designer. Leaving it empty does not add additional form fields to the designer.

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

  To allow automatic actions labeling through Persistence activities, the robot account executing the workflow needs View, Create, and Delete permissions on Tags.

• Orchestrator Folder Path - The path to the Orchestrator Folder you want to use with this activity. If left empty, the current Orchestrator folder is used. This field supports only strings and String variables.

  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.

• Reference - The name used as reference for future filtering of the actions. This field supports string values only.

• TaskCatalog - An optional business classification of task items. This field supports only strings and String variables.

  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 - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.

• Use Local Form File - enables the creation of Form Actions using a JSON form file, specified at execution. This field supports Boolean values only. When you enable it, the Form File Path property field appears in the body of the activity, where you specify the path to the JSON file, where a certain form layout is stored.

After you select Use Local Form File, click Open Form Designer, select New, and start building a form. When you finish , select Save As, and save it inside the corresponding project folder. Now you have the form that you previously created stored inside a JSON file. Input the path to this JSON file inside the Form File Path field to use that form at runtime.

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

• Storage Bucket Name - The storage bucket you want to use for large data files referenced in the form data.
• Storage Folder Path - The full path to the folder in the specified storage bucket. This field supports strings and String variables only.
  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

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.
• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• TaskCatalog - An optional business classification of task items. This field supports only strings and String variables.
  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 ».

• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.
• 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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  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.

  

• Use Local Form File - enables the creation of Form Actions using a JSON form file, specified at execution. This field supports Boolean values only. When you enable it, the Form File Path property field appears in the body of the activity, where you specify the path to the JSON file, where a certain form layout is stored.

• GenerateInputFields - If selected, all the entries from the Form Data Collection are generated as components in the Form Designer. Leaving it empty does not add form fields to the designer.

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

  To allow automatic actions labeling through Persistence activities, the robot account executing the workflow needs View, Create, and Delete permissions on Tags.

• Orchestrator Folder Path - The path to the Orchestrator Folder you want to use with this activity. If left empty, the current Orchestrator folder is used. This field supports only strings and String variables.

  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.

• Reference - The name used as reference for future filtering of the actions. This field supports string values only.

• Form File Path - input the relative path to the form JSON file that you saved inside the current project.

Stockage

• Storage Bucket Name - The storage bucket you want to use for large data files referenced in the form data.
• Storage Folder Path - The full path to the folder in the specified storage bucket. This field supports strings and String variables only.

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.