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.

Esta característica solo está disponible con la actividad Crear tarea de formulario .

Para incrustar objetos, utiliza las propiedades de 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
Usuariodel Action Center	Este usuario necesita los siguientes permisos a nivel de carpeta: Ver para depósito de almacenamiento y Ver para archivo de almacenamiento.
Usuario derobot	Este usuario necesita los siguientes permisos a nivel de carpeta: Ver y Editar para Depósitode almacenamiento y Ver y Crear para Archivo de almacenamiento.

Incrustar imágenes desde depósitos de almacenamiento

Para que los usuarios de Actions Center experimenten un mejor rendimiento, le recomendamos que inserte imágenes que se hayan cargado previamente en un depósito de almacenamiento.

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

1. Usa actividades, como Cargar archivo de almacenamiento , para cargar la imagen en el depósito de almacenamiento que utiliza la actividad Crear tarea de formulario . Como parte de este paso, crea una variable String para almacenar la ruta donde se carga el archivo, por ejemplo 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. En la actividad Crear tarea de formulario , haz clic en los puntos suspensivos (...) a la derecha de DatosDelFormulario y añade un argumento con la palabra clave _storage como sufijo:
   • Nombre: image_storage.
   • Dirección: In.
   • Tipo: cadena.
   • Valor: imagePath.
   Nota: La palabra clave _storage se usa para indicar que este es un objeto que está disponible en el depósito de almacenamiento de la actividad. Para el valor, agregamos la variable donde almacenamos la ruta a la imagen cargada.
   Consejo: para imágenes de menos de 2 KB, como logotipos o iconos, puedes omitir este paso. En el siguiente paso, donde se utiliza el argumento image_storage , utiliza la variable imagePath en su lugar.
3. Añade un componente de Elemento HTML y configúralo de la siguiente manera:
   • Etiqueta HTML: div.
   • Contenido: <img src="{{ data.image_storage }}" />. Esto asigna el argumento del archivo de almacenamiento al componente del formulario. El uso de la etiqueta <img> muestra la imagen en el formulario. También puedes utilizar <a src="{{ data.image_storage }}" target=_blank> para añadir un enlace que abra la imagen en una nueva ventana.
   • Actualizar al cambiar: seleccionado.
   Nota: puedes añadir enlaces a archivos específicos haciendo referencia a ellos en la etiqueta <a href="https://link-to-file"></a> . Puede 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: los archivos TIFF no se admiten dentro de las acciones de formulario. Como alternativa, pruebe lo siguiente:

• 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. Usa actividades, como Cargar archivo de almacenamiento , para cargar el archivo PDF en el depósito de almacenamiento que utiliza la actividad Crear tarea de formulario . Como parte de este paso, crea una variable String para almacenar la ruta donde se carga el archivo, por ejemplo docPath.
2. En la actividad Crear tarea de formulario , haz clic en los puntos suspensivos (...) a la derecha de DatosDelFormulario y añade un argumento con la palabra clave _storage como sufijo:
   • Nombre: doc_storage.
   • Dirección: In.
   • Tipo: cadena.
   • Valor: docPath.
     Importante: la palabra clave _storage se usa para indicar que este es un objeto que está disponible dentro del depósito de almacenamiento de la actividad. Para el valor, agregamos la variable donde almacenamos la ruta al archivo PDF cargado.

3. Añade un componente de Elemento HTML al formulario y especifica lo siguiente:

   • Etiqueta HTML: div.
   • Contenido: <embed src={{ data.doc_storage }} width="600px" height="500px"></embed>.
   • Actualizar al cambiar: borrado.
4. Guarde sus cambios y cierre la ventana del componente para volver a la ventana del Diseñador de formularios .
5. Haz clic en Editar JSON icono para el elemento HTML.
6. En JSON del componente, busca "refreshOn" y establece su valor en el atributo de datos del formulario, para que tengas "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.
   • Dirección: In.
   • Tipo: cadena.
   • 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. Guarde sus cambios y cierre la ventana del componente para volver a la ventana del Diseñador de formularios .

Descarga este ejemplo aquí.