Incrustar Objetos en acciones de formulario

Puedes diseñar tus acciones de formulario para mostrar imágenes o archivos PDF, para personalizar simplemente el aspecto con logotipos e iconos o para proporcionar materiales que puedan ayudar a los usuarios de Action Center a completar la acción.

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

Para incrustar objetos, utiliza las propiedades en la sección Almacenamiento de la actividad Crear tarea de formulario para vincular a un Depósito de almacenamiento y la actividad Cargar archivo de almacenamiento para añadir archivos.

Puede insertar cualquier tipo de objeto compatible con depósitos de almacenamiento.

El siguiente vídeo muestra cómo se comporta un archivo PDF incrustado en Action Center:

Requisitos previos

Para usar las capacidades de insertar objetos en acciones de formulario, los usuarios necesitan los siguientes permisos:

Tipo de usuario	Permisos
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.

Incrustar imágenes desde depósitos de almacenamiento

Para que tus usuarios de Action Center experimenten un mejor rendimiento, te recomendamos que incrustes imágenes que se hayan cargado previamente en un Depósito de almacenamiento.

Para insertar una imagen en una acción de formulario:

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

   La carga del depósito de almacenamiento convierte el signo + en un espacio, lo que puede provocar un error durante la representación del formulario.

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:
   • Nombre: image_storage.
   • Direction: In.
   • Type: String.
   • Valor: imagePath.
   Nota:

   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.

   Consejo:

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

   Puedes añadir enlaces a archivos específicos haciendo referencia a ellos en la etiqueta <a href="https://link-to-file"></a> . Puedes ignorar cualquier error de validación que aparezca en el campo Contenido , no afectan a la representación del formulario en tiempo de ejecución.

Importante:

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

• Convierta los archivos TIFF a JPEG o PNG antes de cargarlos a un depósito de almacenamiento, usando actividades personalizadas dentro del flujo de trabajo con el que está trabajando.
• Haz referencia al archivo dentro del depósito de almacenamiento con una etiqueta <href> .

Flujo de trabajo de muestra

Para seguir los pasos del tutorial y probarlo tú mismo, descarga el flujo de trabajo de muestra.

Incrustar archivos PDF desde depósitos de almacenamiento

Incrustar un archivo PDF desde un depósito de almacenamiento es diferente para los formularios regulares que para los formularios avanzados. Los formularios avanzados ofrecen un rendimiento de representación mejorado y un uso avanzado de los componentes y su lógica. Puedes crear formularios avanzados seleccionando Habilitar formularios avanzados en la actividad Crear tarea de formulario .

Formularios regulares

También puede agregar archivos PDF que se cargaron en un depósito de almacenamiento a una acción de formulario para que los usuarios de Action Center puedan revisarlo.

Para incrustar un PDF en una tarea de formulario regular:

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:
   • Nombre: doc_storage.
   • Direction: In.
   • Type: String.
   • Valor: docPath.
     Importante:

     La palabra clave _storage se utiliza para indicar que se trata de un objeto que está disponible dentro del depósito de almacenamiento de la actividad. Para el valor, añadimos la variable donde almacenamos la ruta al archivo PDF cargado.

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. Haz clic en Editar JSON icono para el elemento 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. Asegúrate de que el texto que se genera automáticamente para el campo _storage esté disponible en el formulario. Se puede marcar como campo oculto.
   Importante:

   Si utilizas UiPath.FormActivitiyLibrary v1.1.10, Ten en cuenta que el componente JSON no muestra la opción "refreshOn" . Sin embargo, puedes añadir manualmente la clave "refreshOn" y establecer su valor como se ha mencionado anteriormente.

Descarga este ejemplo aquí.

Formularios avanzados

Para incrustar un PDF en una tarea de formulario avanzado:

1. Utiliza actividades, como la actividad Cargar archivo de almacenamiento , para cargar el archivo PDF en el depósito de almacenamiento que utiliza la actividad Crear tarea de formulario . Especifica la ruta del archivo en el campo Ruta de la actividad Cargar archivo de almacenamiento . Para este ejemplo, introduce sample.pdf.
2. En la actividad Crear tarea de formulario , haz clic en los puntos suspensivos (...) a la derecha de FormData y añade un argumento con las siguientes configuraciones:
   • Clave: pdf.
   • Direction: In.
   • Type: String.
   • Valor: "sample.pdf".
3. Añade un componente PDF al formulario y especifica el nombre del argumento añadido previamente como Nombre de la propiedad. Para este ejemplo, especifica pdf.
4. Save your changes and close the component window, to return to the Form Designer window.

Descarga este ejemplo aquí.