Incorporation d'objets dans des actions de formulaire

Vous pouvez concevoir vos actions de formulaire pour afficher des images ou des fichiers PDF, pour personnaliser simplement l'apparence avec des logos et des icônes, ou pour fournir des documents qui peuvent aider les utilisateurs de l'Action Center à réaliser l'action.

Cette fonctionnalité est disponible uniquement avec l’activité Créer une tâche de formulaire (Create Form Task) .

Pour intégrer des objets, vous utilisez les propriétés sous la section Stockage (Storage) de l'activité Créer une tâche de formulaire (Create Form Task) pour créer un lien vers un compartiment de stockage et l'activité Télécharger un fichier de stockage ( Upload Storage File ) pour ajouter des fichiers.

Vous pouvez intégrer n'importe quel type d'objet pris en charge par les compartiments de stockage.

La vidéo ci-dessous montre le comportement d'un fichier PDF intégré dans Action Center :

Prérequis

Pour utiliser les capacités d'incorporation d'objets dans les actions de formulaire, les utilisateurs ont besoin des autorisations suivantes :

Type d’utilisateur	Autorisations
UtilisateurAction Center	Cet utilisateur a besoin des autorisations suivantes au niveau du dossier : Afficher pour le compartiment de stockage et Afficher pour le fichier de stockage.
Utilisateurdu robot	Cet utilisateur a besoin des autorisations suivantes au niveau du dossier : Consultation ( View ) et modification ( Edit ) pour le compartiment de stockage ( Storage Bucket) et Consultation ( View and Create ) pour le fichier de stockage ( Storage File).

Incorporation d'images à partir de compartiments de stockage

Pour que vos utilisateurs d' Actions Center bénéficient de meilleures performances, nous vous recommandons d'intégrer des images qui ont été précédemment téléchargées dans un compartiment de stockage.

Pour incorporer une image dans une action de formulaire :

1. Utilisez des activités, telles que l'activité Télécharger le fichier de stockage ( Upload Storage File ), pour télécharger l'image dans le compartiment de stockage utilisé par l'activité Créer une tâche de formulaire (Create Form Task) . Dans le cadre de cette étape, créez une variable String pour stocker le chemin de téléchargement du fichier, par exemple imagePath.
   Important : le téléchargement du compartiment de stockage convertit le signe + en un espace, ce qui peut entraîner une erreur lors du rendu du formulaire.
2. Dans l'activité Créer une tâche de formulaire (Create Form Task) , cliquez sur les points de suspension (...) à droite de DonnéesFormulaires et ajoutez un argument avec le mot clé _storage comme suffixe :
   • Nom : image_storage.
   • Direction : dans.
   • Type : chaîne.
   • Valeur : imagePath.
   Remarque : le mot clé _storage est utilisé pour indiquer qu'il s'agit d'un objet disponible dans le compartiment de stockage de l'activité. Pour la valeur, nous avons ajouté la variable où nous avons stocké le chemin d'accès à l'image téléchargée.
   Conseil : pour les images inférieures à 2 Ko, telles que les logos ou les icônes, vous pouvez ignorer cette étape. Dans l'étape suivante où l'argument image_storage est utilisé, utilisez plutôt la variable imagePath .
3. Ajoutez un composant Élément HTML et configurez-le comme suit :
   • Balise HTML: div.
   • Contenu: <img src="{{ data.image_storage }}" />. Cela mappe l'argument du fichier de stockage au composant de formulaire. L'utilisation de la balise <img> affiche l'image dans le formulaire. Vous pouvez également utiliser <a src="{{ data.image_storage }}" target=_blank> pour ajouter un lien qui ouvre l'image dans une nouvelle fenêtre.
   • Actualiser en cas de modification: sélectionné.
   Remarque : vous pouvez ajouter des liens vers des fichiers spécifiques en les référençant dans la balise <a href="https://link-to-file"></a> . Vous pouvez ignorer les erreurs de validation qui apparaissent dans le champ Contenu , elles n'affectent pas le rendu du formulaire au moment de l'exécution.

Important : les fichiers TIFF ne sont pas pris en charge dans les actions de formulaire. Vous pouvez également essayer les solutions suivantes :

• Convertissez les fichiers TIFF en JPEG ou PNG avant de les télécharger dans un compartiment de stockage, en utilisant des activités personnalisées dans le workflow avec lequel vous travaillez.
• Référencez le fichier à l'intérieur du compartiment de stockage, à l'aide d'une balise <href> .

Exemple de workflow

Pour suivre les étapes du tutoriel et l’essayer vous-même, téléchargez l’ exemple de workflow.

Incorporation de fichiers PDF à partir de compartiments de stockage

L'intégration d'un fichier PDF à partir d'un compartiment de stockage est différente pour les formulaires standard que pour les formulaires avancés. Les formulaires avancés offrent des performances de rendu améliorées ainsi qu’une utilisation avancée des composants et de leur logique. Vous pouvez créer des formulaires avancés en sélectionnant Activer les formulaires avancés dans l’activité Créer une tâche de formulaire .

Formulaires réguliers

Vous pouvez également ajouter des fichiers PDF téléchargés dans un compartiment de stockage à une action de formulaire afin que les utilisateurs de l'Action Center puissent la réviser.

Pour intégrer un PDF dans une tâche de formulaire standard :

1. Utilisez des activités, telles que l'activité Télécharger le fichier de stockage ( Upload Storage File ), pour télécharger le fichier PDF dans le compartiment de stockage utilisé par l'activité Créer une tâche de formulaire (Create Form Task) . Dans le cadre de cette étape, créez une variable String pour stocker le chemin de téléchargement du fichier, par exemple docPath.
2. Dans l'activité Créer une tâche de formulaire (Create Form Task) , cliquez sur les points de suspension (...) à droite de DonnéesFormulaires et ajoutez un argument avec le mot clé _storage comme suffixe :
   • Nom : doc_storage.
   • Direction : dans.
   • Type : chaîne.
   • Valeur : docPath.
     Important : le mot clé _storage est utilisé pour indiquer qu'il s'agit d'un objet disponible dans le compartiment de stockage de l'activité. Pour la valeur, nous avons ajouté la variable où nous avons stocké le chemin d'accès au fichier PDF téléchargé.

3. Ajoutez un composant Élément HTML au formulaire et spécifiez les éléments suivants :

   • Balise HTML: div.
   • Contenu: <embed src={{ data.doc_storage }} width="600px" height="500px"></embed>.
   • Actualiser en cas de modification: décochée.
4. Enregistrez vos modifications et fermez la fenêtre du composant pour revenir à la fenêtre du Concepteur de fiches.
5. Cliquez sur l' option Modifier JSON (Edit JSON) icône de l’ élément HTML.
6. Sous le composant JSON, recherchez "refreshOn" et définissez sa valeur sur l'attribut de données de formulaire, de sorte que vous ayez "refreshOn": "doc_storage".
7. Assurez-vous que le texte généré automatiquement pour le champ _storage est disponible dans le formulaire. Il peut être marqué comme un champ masqué.
   Attention : si vous utilisez UiPath.FormActivitiyLibrary v1.1.10, notez que le composant JSON n’énumère pas l’option "refreshOn" . Toutefois, vous pouvez ajouter manuellement la touche "refreshOn" et définir sa valeur comme mentionné ci-dessus.

Téléchargez cet exemple ici.

Formulaires avancés

Pour intégrer un PDF dans une tâche de formulaire avancée :

1. Utilisez des activités, telles que l'activité Charger le fichier de stockage ( Upload Storage File ), pour télécharger le fichier PDF dans le compartiment de stockage utilisé par l'activité Create Form Task . Spécifiez le chemin du fichier dans le champ Chemin (Path) de l'activité Télécharger le fichier de stockage ( Upload Storage File ). Pour cet exemple, entrez sample.pdf.
2. Dans l’activité Créer une tâche de formulaire , cliquez sur l’ellipse (...) à droite de DonnéesFormulaire et ajoutez un argument avec les configurations suivantes :
   • Clé : pdf.
   • Direction : dans.
   • Type : chaîne.
   • Valeur : "sample.pdf".
3. Ajoutez un composant PDF au formulaire et spécifiez le nom de l'argument ajouté auparavant en tant que Nom de propriété (Property Name). Pour cet exemple, spécifiez pdf.
4. Enregistrez vos modifications et fermez la fenêtre du composant pour revenir à la fenêtre du Concepteur de fiches.

Téléchargez cet exemple ici.