Formulaire rapide

Suspendez un workflow et demandez à un humain d'examiner, d'approuver ou de remplir un formulaire que vous créez sur le nœud, puis de poursuivre avec sa réponse.

Quick Form suspend le workflow et attribue une tâche à un humain: un formulaire que vous créez directement sur le nœud. L'humain l'examine, le remplit et sélectionne un résultat, tel que Approuver ou Rejeter, et le workflow se poursuit sur le chemin de ce résultat. Il se trouve dans la catégorie Human (humain) du panneau Add node (Ajouter un nœud) .

Utilisez des formulaires rapides pour les approbations et la collecte simple des données. Lorsque vous avez besoin d'une interface plus enrichie, de la réutiliser dans les workflows ou d'afficher les données que le workflow ne transporte pas déjà, utilisez plutôt une application d'action . Ajoutez une approbation humaine à un workflow qui parcourt un formulaire rapide étape par étape.

Quand utiliser le formulaire rapide vs la Décision

Utilisez le formulaire rapide lorsqu’un humain doit examiner les informations et répondre avant que le workflow ne continue. Utilisez Décision lorsque la branche peut être résolue automatiquement à partir des données existantes, sans intervention humaine.

Configuration

Champ	Requis	Default	Description
Critères d’attribution	Oui (Yes)	Utilisateur unique	Contrôle la façon dont le nœud sélectionne l'utilisateur qui obtient la tâche. Choisissez entre Utilisateur unique, Tous les utilisateurs, Round Robin, Charge de travail ou Personnalisé.
Schéma	Oui (Yes)	Envoyer le résultat	Structure du formulaire, y compris les champs que le bénéficiaire voit ou remplit et les résultats qu'il peut sélectionner. La section Schéma décrit la structure complète.
Canaux de livraison	—	Définir par votre administrateur	En lecture seule sur le nœud. Les canaux disponibles proviennent des paramètres de votre administrateur et s'affichent comme des cases à cocher désactivées. La section Canaux de livraison contient des détails.
Titre de la tâche	Non (No)	Aucun (None)	Titre affiché au destinataire dans sa liste de tâches.
Priorité (Priority)	Non (No)	Aucun (None)	Priorité affichée dans Action Center : Faible, Moyenne ou Élevée.
Libellés	Non (No)	Aucun (None)	Libellés séparés par des virgules pour l'organisation des tâches, par exemple finance,approval.

Critères d’attribution

Les critères d'affectation contrôlent les utilisateurs qui reçoivent la tâche. La sélection d'un critère modifie le deuxième champ pour qu'il corresponde — un sélecteur d'utilisateur pour Utilisateur unique, un sélecteur de groupe pour les critères basés sur les groupes.

Critères	Qui obtient la tâche	Utilisez-le lorsque
Utilisateur unique	Un utilisateur nommé.	Une personne spécifique est propriétaire de cette décision: un approbateur nommé, un réviseur unique
Tous les utilisateurs	Chaque membre du groupe à la fois. La première qui se termine ferme la tâche pour tout le monde.	Vous vous souciez de la vitesse de propriété. Celui qui est libre le récupère
Charge de travail	Le membre du groupe avec le moins de tâches ouvertes	Vous souhaitez que la file d'attente soit répartie uniformément au sein d'une équipe
Round Robin	Membres du groupe à leur tour, parcourant la liste des membres	Vous souhaitez que chaque membre puisse recevoir une part égale, quelle que soit la vitesse de travail
Personnalisé	Le membre ayant le moins de tâches ouvertes, choisi dans une liste d'utilisateurs que vous fournissez au moment du runtime plutôt que parmi l'adhésion complète à un groupe.	Modifications de l'éligibilité par exécution — ignorer les utilisateurs qui sont absents du bureau, hors décalage ou en dehors du rôle ou de la région approprié(e).

Exigences et limites

Important :

La charge de travail et Round Robin nécessitent un groupe local. Les groupes Active Directory sont rejetés pour les deux. Utilisez Utilisateur unique ou Tous les utilisateurs si vos bénéficiaires font partie d'un groupe Active Directory.

Dans le débogage, l'attribution de groupe ne fonctionne pas. Une exécution de test crée la tâche et n’est visible que par vous, les membres du groupe ne peuvent donc pas l’ouvrir. La tâche reste Non affectée et aucune notification n’est envoyée. Ceci est normal. Pour tester l’attribution de groupe, déployez le workflow et démarrez une exécution. L'affectation à un utilisateur unique fonctionne normalement dans le débogage.

Erreurs que vous pouvez voir:

Erreur	Signification
NoUsersFoundInLocalGroup	Le groupe sélectionné ne comprend aucun membre.
NoEligibleUsersFoundInGroup	Chaque membre a été exclu, il ne reste donc plus personne à affecter.

Schéma

Le schéma définit ce que voit le bénéficiaire et ce qu'il renvoie au processus. Il comporte deux parties: les champs et les résultats.

Champs

Le schéma peut également être modifié directement au format JSON. La référence complète du schéma JSON se trouve dans les tâches de formulaire rapide. Dans la vue Formulaire, chaque champ a ces paramètres:

Paramètre	Ce qu’il fait
Label	Le nom complet affiché pour le bénéficiaire.
Saisie de texte	Contrôle la validation et le rendu de l’entrée. Types disponibles: Texte, Nombre, Nombre décimal, Date, Date et heure, Oui ou non, Sélection unique, Sélection multiple, Tableau, Fichier.
Liaison	Une expression qui préremplit le champ, par exemple $vars.requestAmt. Accepte toute expression de workflow, et pas seulement une référence de variable.
Modifiable	Le cadenas à côté de la valeur. Verrouillé signifie que le bénéficiaire peut lire la valeur mais pas la modifier.
Variable	Affiché sous la forme d'un badge (x) à côté du nom du champ. Générée automatiquement à partir des champs Libellé pour la sortie et Entrée/Sortie, exposant la valeur sous forme de variable de processus nommée en plus de $vars.<nodeName>.output.<fieldId>. Non présent dans les champs d'entrée.

Directions du champ

Les champs transportent des données dans et hors de la tâche. Chaque champ a une direction.

• Les champs Entrée constituent un contexte en lecture seule pour le destinataire, lié à une valeur de processus, par exemple $vars.start.output.employeeName.
• Les champs Sortie sont remplis par le destinataire et renvoyés au processus.
• Les champs In/Out font les deux : ils affichent au destinataire une valeur de processus comme point de départ et il peut la modifier avant qu'elle ne soit renvoyée au processus.

La direction d'un champ n'est pas un paramètre distinct. Elle est le résultat de deux contrôles: si le champ est lié détermine s'il arrive pré-rempli, et s'il est déverrouillé détermine si le bénéficiaire peut le modifier.

Liaison	Verrouillez	Direction	Voir le bénéficiaire	Modifiable et amp; Retourné
Ensemble	Verrouillé 🔃	Entrée	La valeur liée	Non (No)
Ensemble	Déverrouillé 🔓	Entrée/Sortie	La valeur liée	Oui (Yes)
Aucun (None)	Déverrouillé 🔓	Sortie	Un champ vide	Oui (Yes)
Aucun (None)	Verrouillé 🔃	Non valide	Un champ vide	Non (No)

Résultats

Les résultats sont les boutons que le destinataire utilise pour terminer la tâche, par exemple Approuver et Rejeter. Le schéma par défaut a un seul résultat Envoyer. Le premier résultat est marqué comme action primaire.

Chaque résultat ajoute sa propre gestion de sortie au nœud. Lorsque le bénéficiaire sélectionne un résultat, le processus se poursuit à partir du contrôle de ce résultat, vous permettant d’acheminer chaque résultat vers un chemin différent. La section Ramification sur le résultat montre comment.

Canaux de livraison

Les tâches sont livrées à:

• Action Center
• E-mail (Email)
• Slack
• Microsoft Teams

Important :

Seul un administrateur peut modifier les canaux de livraison dans Paramètres d’administration. Les cases à cocher sur le nœud sont désactivées et affichent les paramètres actuels.

Slack et Microsoft Teams ont besoin d’une connexion. Les notifications exploitables couvrent la configuration du connecteur.

Sortie

Accédez à la sortie du nœud dans $vars.<nodeName>.output et au résultat sélectionné dans $vars.<nodeName>.status.

sortie

Le résultat de la tâche : un objet contenant les valeurs que le destinataire a envoyées, classées par champ de sortie. Lisez un seul champ avec $vars.<nodeName>.output.<fieldId>. L'objet transporte également une propriété Action définie sur le résultat sélectionné.

statut

Le résultat que le destinataire a sélectionné, par exemple Approve. Ramifiez sur cette valeur pour acheminer le processus.

Branchement sur le résultat

Chaque résultat que vous définissez ajoute une gestion de sortie au nœud. Lorsque le bénéficiaire termine la tâche, le processus se poursuit à partir du gestionnaire pour le résultat qu'il a sélectionné. Connectez chaque gestion de résultat au nœud qui doit s’exécuter pour ce chemin. Vous n'avez pas besoin d'un nœud de décision pour diviser le résultat.

Quick Form
  ├─ Approve → continue processing
  └─ Reject  → notify the requester and terminate

Lisez un champ soumis dans n'importe quel nœud en aval avec $vars.<nodeName>.output.<fieldId> :

// In a Script node on one of the outcome paths
return $vars.approval.output.comment;

Le résultat sélectionné est également disponible comme $vars.<nodeName>.status si vous en avez besoin dans une expression.

Problèmes couramment rencontrés

La tâche n'apparaît pas pour le destinataire

Vérifiez que le destinataire, qu'il s'agisse d'un utilisateur ou d'un groupe, est correct et a accès à Action Center.

Une valeur de sortie est manquante

Confirmez que le champ est défini dans le schéma avec la direction Sortie.

Un résultat est acheminé vers le mauvais chemin

Confirmez que la gestion de sortie de chaque résultat est connectée au nœud souhaité. Chaque résultat que vous définissez dans le schéma dispose de son propre handle sur le nœud.

Remarques

Remarque :

Pour tester sans bénéficiaire réel, utilisez la sortie simulée pour simuler une réponse status et output . Ajouter une approbation humaine à un workflow comporte les étapes.

• Si le destinataire est un groupe, n'importe quel membre de ce groupe peut revendiquer et terminer la tâche.
• Pour obtenir une interface plus riche qu'un formulaire, utilisez plutôt une application d'action .

Prochaines étapes

• Ajouter une approbation humaine à un workflow
• Application d’action
• Décision
• Terminate
• Tâches de formulaire rapides
• Community (Communauté): posez des questions et partagez des workflows avec d'autres développeurs sur le forum UiPath.