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

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.

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 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 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é ( 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 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 : 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.

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 (Folder Permissions).

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

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.

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

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.

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.

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

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 (Folder Permissions).

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

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.