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.

This feature is available with the Create Form Task activity only.

Pour intégrer des objets, vous utilisez les propriétés de la section Stockage de l'activité Créer une tâche de formulaire pour lier à un compartiment de stockage et l'activité Télécharger le fichier de stockage 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
Action Center user	This user needs the following permissions at folder level: View for Storage Bucket and View for Storage File.
Robot user	This user needs the following permissions at folder level: View and Edit for Storage Bucket, and View and Create for Storage File.

Incorporation d'images à partir de compartiments de stockage

Pour que vos utilisateurs d'Action 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. Use activities, such as the Upload Storage File activity, to upload the image to the storage bucket that is used by the Create Form Task activity. As part of this step, create a String variable to store the path where the file is uploaded, for example 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. In the Create Form Task activity, click the ellipsis (...) to the right of FormData and add an argument with the _storage keyword as a suffix:
   • Nom : image_storage.
   • Direction: In.
   • Type: String.
   • Valeur : imagePath.
   Remarque :

   The _storage keyword is used to indicate that this is an object that is available in the activity's storage bucket. For the value, we added the variable where we stored the path to the uploaded image.

   Astuce :

   For images smaller than 2 KB, such as logos or icons, you can skip this step. In the following step where the image_storage argument is used, use the imagePath variable instead.

3. Add an HTML Element component and configure it as follows:
   • HTML Tag: div.
   • Content: <img src="{{ data.image_storage }}" />. This maps the storage file argument to the form component. Using the <img> tag displays the image in the form. Alternatively, you can use <a src="{{ data.image_storage }}" target=_blank> to add a link that opens the image in a new window.
   • Refresh On Change: selected.
   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 :

TIFF files are not supported inside Form Actions. As an alternative, try the following:

• 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 et 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. Use activities, such as the Upload Storage File activity, to upload the PDF file to the storage bucket that is used by the Create Form Task activity. As part of this step, create a String variable to store the path where the file is uploaded, for example docPath.
2. In the Create Form Task activity, click the ellipsis (...) to the right of FormData and add an argument with the _storage keyword as a suffix:
   • Nom : doc_storage.
   • Direction: In.
   • Type: String.
   • Valeur : docPath.
     Important :

     Le mot clé _storage est utilisé pour indiquer qu'il s'agit d'un objet disponible à l'intérieur du compartiment de stockage de l'activité. Pour la valeur, nous avons ajouté la variable dans laquelle nous avons stocké le chemin d’accès au fichier PDF chargé.

3. Add an HTML Element component to the form and specify the following:
   • HTML Tag: div.
   • Content: <embed src={{ data.doc_storage }} width="600px" height="500px"></embed>.
   • Refresh On Change: cleared.
4. Save your changes and close the component window, to return to the Form Designer window.
5. Cliquez sur le bouton Modifier JSON icône pour l' élément HTML.
6. Under the Component JSON, search for "refreshOn" and set its value to the form data attribute, so that you have "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é.
   Important :

   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 , pour charger le fichier PDF dans le compartiment de stockage utilisé par l’activité Créer une tâche de formulaire . Spécifiez le chemin du fichier dans le champ Chemin de l'activité Télécharger le fichier de stockage . Pour cet exemple, saisissez sample.pdf.
2. Dans l'activité Créer une tâche de formulaire , cliquez sur l'ellipse (...) à droite de FormData et ajoutez un argument avec les configurations suivantes :
   • Clé : pdf.
   • Direction: In.
   • Type: String.
   • 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 la propriété. Pour cet exemple, spécifiez pdf.
4. Save your changes and close the component window, to return to the Form Designer window.

Téléchargez cet exemple ici.