Crear tarea de formulario

UiPath.Persistence.Activities.FormTask.CreateFormTask

Descripción

Crea una acción del formulario en las instancias en la nube y en las instalaciones de Action Center. También crea una tarea de formulario en On-Premises Orchestrator versión 21.4 y anteriores.

Requisitos previos

• Instala la versión 2.0.7 o posterior del paquete de UiPath.FormActivityLibrary para habilitar el diseñador de formularios.
• Las tareas de formulario tienen un límite de 1 MB como máximo. Para ajustarte a este límite de 1 MB, debes incrustar imágenes dentro de los formularios, utilizando solo depósitos de almacenamiento. Además, sugerimos utilizar imágenes de tipo base64 solo para logotipos e iconos de menos de 2 KB.

Compatibilidad de proyectos

Windows - Heredado | Windows | Multiplataforma

Windows, Windows: configuración heredada

Panel del Diseñador

• TítuloDeLaTarea : el título de la acción que quieres crear. Este campo solo admite cadenas y variables String .
• PrioridadDeLaTarea : te permite seleccionar el nivel de prioridad de la acción. De forma predeterminada, esta propiedad está establecida en TaskPriority.Medium Las siguientes opciones están disponibles: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• CatálogoDeTareas : una clasificación empresarial opcional de elementos de tareas. Este campo solo admite cadenas y variables de cadena.
  Importante:

  Asegúrese de que el catálogo de acciones exista antes de la creación de la acción. De lo contrario, la creación de la acción falla con el siguiente mensaje de error: "No existe ningún catálogo de tareas con el nombre [action_catalog_name] Código de error: 2451".

• DatosDeFormulario : una colección de datos empresariales en el formulario Dictionary<String,Argument> que quieres mostrar en un formulario dentro de la bandeja de entrada de Acciones. La modificación de los argumentos Out y In/Out los asigna de nuevo al flujo de trabajo una vez completada la tarea. Este campo solo admite objetos Dictionary<String,Argument> .
• ObjetoDeLaTarea(Salida) : el objeto de la tarea que se devuelve desde Orchestrator como un objeto FormTaskData después de crear la acción. Este objeto puede pasarse a la actividad Esperar tarea de formulario y reanudar para suspender la ejecución del flujo de trabajo hasta que se complete la acción.

Nota:

TaskObject tiene varios atributos que contienen información sobre el objeto de acción de salida. Por ejemplo, el atributo TaskUrl te da la URL de la acción dentro de la pestaña Acciones en Orchestrator On-Premises, mientras que el atributo ActionUrl te da la URL de la acción dentro de la pestaña Acciones en la plataforma en la nube. Para acceder a la acción desde Action Center local, añade /actions_/tasks/taskID a la URL base de Action Center, por ejemplo: https://laptop-name:port-number/actions_/tasks/taskID.

Al hacer clic en el botón Abrir diseñador de formularios, se abrirá el asistente del diseñador de formularios, que te permite personalizar el formulario que deseas utilizar en tu flujo de trabajo.

El botón Abrir diseñador de formularios masivos está disponible cuando se selecciona la propiedad Habilitar edición masiva. Esta opción abre el Diseñador de formularios masivos, lo que te permite diseñar acciones de formulario que se pueden editar o completar en masa en la pestaña Acciones de la instancia de Action Center correspondiente.

Panel de propiedades

Común

• ContinuarEnCasoDeError : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores booleanos (Verdadero, Falso). El valor predeterminado es Falso. Como resultado, si el campo está vacío y se produce un error, la ejecución del proyecto se detiene. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

Nota:

If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

• Nombre para mostrar: el nombre para mostrar de la actividad.
• LímiteDeTiempoEnMilisegundos: especifica la cantidad de tiempo (en milisegundos) que se debe esperar a que se ejecute la actividad antes de mostrar un error. El valor predeterminado es 30000 milisegundos (30 segundos).

Entrada

• Habilitar formularios avanzados : habilita características mejoradas y opciones de personalización para la representación y la lógica de formularios, como:

  • Plantillas personalizables para Editar cuadrículas.
  • Botones que funcionan como eventos.
  • La capacidad de personalizar formularios utilizando ES6 y JavaScript moderno.
  • La disponibilidad de las variables instance y options para personalizar formularios.

• Habilitar edición masiva : si se selecciona, el botón Abrir diseñador de formularios masivos estará disponible en el cuerpo de la actividad. Esta opción te permite generar acciones de formulario que se pueden editar o completar de forma masiva desde la pestaña Acciones en Action Center.

  

• DatosDeFormulario : una colección de datos empresariales en el formulario Dictionary<String,Argument> que quieres mostrar en un formulario dentro de la bandeja de entrada de Acciones. La modificación de los argumentos Out y In/Out los asigna de nuevo al flujo de trabajo una vez completada la tarea. Este campo solo admite objetos Dictionary<String,Argument> .

• GenerarCamposDeEntrada : si se selecciona, todas las entradas de la Recopilación de datos del formulario se generan como componentes en el Diseñador de formularios. Dejarlo vacío no añade campos de formulario adicionales al diseñador.

• Etiquetas : el robot añade las etiquetas introducidas a la acción, lo que permite futuros filtrados. Este campo solo admite valores de cadena y tiene restricciones de nombre.

Nota:

Para permitir el etiquetado automático de acciones a través de actividades de Persistencia, la cuenta de robot que ejecuta el flujo de trabajo necesita permisos para Ver, Crear y Eliminar en Etiquetas.

• Ruta de la carpeta de Orchestrator: la ruta de la carpeta de Orchestrator que quieres usar con esta actividad. Si se deja vacía se usa la carpeta de Orchestrator actual. Este campo solo admite cadenas y variables de cadena.

Nota:

Si el usuario que realiza esta acción no tiene los permisos necesarios para la carpeta de destino, la creación de la tarea falla y arroja un error crítico. Consulta más información sobre los permisos de carpeta.

• Referencia : el nombre utilizado como referencia para el filtrado futuro de las acciones. Este campo solo admite valores de cadena.
• CatálogoDeTareas : una clasificación empresarial opcional de elementos de tareas. Este campo solo admite cadenas y variables de cadena.
  Importante:

  Asegúrese de que el catálogo de acciones exista antes de la creación de la acción. De lo contrario, la creación de la acción falla con el siguiente mensaje de error: "No existe ningún catálogo de tareas con el nombre [action_catalog_name] Código de error: 2451".

• PrioridadDeLaTarea : te permite seleccionar el nivel de prioridad de la acción. De forma predeterminada, esta propiedad está establecida en TaskPriority.Medium Las siguientes opciones están disponibles: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• TítuloDeLaTarea : el título de la acción que quieres crear. Este campo solo admite cadenas y variables String .
• Usar archivo de formulario local : permite la creación de acciones de formulario utilizando un archivo de formulario JSON, especificado en la ejecución. Este campo solo admite valores Boolean . Cuando se habilita, el campo de propiedad Ruta del archivo de formulario aparece en el cuerpo de la actividad, donde se especifica la ruta al archivo JSON, donde se almacena un determinado diseño de formulario.

Después de seleccionar Usar archivo de formulario local, haz clic en Abrir diseñador de formularios, selecciona Nuevo y comienza a crear un formulario. Cuando termines, selecciona Guardar como y guárdalo dentro de la carpeta del proyecto correspondiente. Ahora tienes el formulario que creaste previamente almacenado dentro de un archivo JSON. Introduce la ruta a este archivo JSON dentro del campo Ruta del archivo de formulario para utilizar ese formulario en tiempo de ejecución.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Salida

• ObjetoDeLaTarea(Salida) : el objeto de la tarea que se devuelve desde Orchestrator como un objeto FormTaskData después de crear la acción. Este objeto puede pasarse a la actividad Esperar tarea de formulario y reanudar para suspender la ejecución del flujo de trabajo hasta que se complete la acción.

Almacenamiento

• Nombre del depósito de almacenamiento : el depósito de almacenamiento que quieres utilizar para los archivos de datos grandes a los que se hace referencia en los datos del formulario.
• Ruta de la carpeta de almacenamiento : la ruta completa a la carpeta en el depósito de almacenamiento especificado. Este campo solo admite cadenas y variables String .
  Consejo:

  El uso de la incrustación de imágenes con los Depósitos de almacenamiento debe realizarse junto con la actividad Cargar archivo de almacenamiento . El nombre del argumento debe tener el sufijo en la propiedad RecopilaciónDeDatosDeFormulario y asignarse a una imagen en el formulario, utilizando el guion bajo (_) en un componente de elemento HTML . El nombre del argumento (<key>_storage) debe asignarse al valor de almacenamiento en la propiedad Destino de la actividad Cargar archivo de almacenamiento . Ten en cuenta que los nombres de los archivos de imagen no deben contener el signo más (+), ya que este carácter está enmascarado por el proceso de carga del depósito de almacenamiento, lo que da lugar a un error.

Configuración multiplataforma

• TítuloDeLaTarea : el título de la acción que quieres crear. Este campo solo admite cadenas y variables String .
• PrioridadDeLaTarea : te permite seleccionar el nivel de prioridad de la acción. De forma predeterminada, esta propiedad está establecida en TaskPriority.Medium Las siguientes opciones están disponibles: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• CatálogoDeTareas : una clasificación empresarial opcional de elementos de tareas. Este campo solo admite cadenas y variables de cadena.
  Importante:

  Asegúrese de que el catálogo de acciones exista antes de la creación de la acción. De lo contrario, la creación de la acción falla con el siguiente mensaje de error: "No existe ningún catálogo de tareas con el nombre [action_catalog_name] Código de error: 2451".

• DatosDeFormulario : una colección de datos empresariales en el formulario Dictionary<String,Argument> que quieres mostrar en un formulario dentro de la bandeja de entrada de Acciones. La modificación de los argumentos Out y In/Out los asigna de nuevo al flujo de trabajo una vez completada la tarea. Este campo solo admite objetos Dictionary<String,Argument> .
• ObjetoDeLaTarea(Salida) : el objeto de la tarea que se devuelve desde Orchestrator como un objeto FormTaskData después de crear la acción. Este objeto puede pasarse a la actividad Esperar tarea de formulario y reanudar para suspender la ejecución del flujo de trabajo hasta que se complete la acción.

Nota:

TaskObject tiene varios atributos que contienen información sobre el objeto de acción de salida. Por ejemplo, el atributo TaskUrl te da la URL de la acción dentro de la pestaña Acciones en Orchestrator On-Premises, mientras que el atributo ActionUrl te da la URL de la acción dentro de la pestaña Acciones en la plataforma en la nube. Para acceder a la acción desde Action Center local, añade /actions_/tasks/taskID a la URL base de Action Center, por ejemplo: https://laptop-name:port-number/actions_/tasks/taskID.

Al hacer clic en el botón Abrir diseñador de formularios, se abrirá el asistente del diseñador de formularios, que te permite personalizar el formulario que deseas utilizar en tu flujo de trabajo.

El botón Abrir diseñador de formularios masivos está disponible cuando se selecciona la propiedad Habilitar edición masiva. Esta opción abre el Diseñador de formularios masivos, lo que te permite diseñar acciones de formulario que se pueden editar o completar en masa en la pestaña Acciones de la instancia de Action Center correspondiente.

Opciones avanzadas

Común

• ContinuarEnCasoDeError : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores booleanos (Verdadero, Falso). El valor predeterminado es Falso. Como resultado, si el campo está vacío y se produce un error, la ejecución del proyecto se detiene. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

Nota:

If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

• LímiteDeTiempoEnMilisegundos: especifica la cantidad de tiempo (en milisegundos) que se debe esperar a que se ejecute la actividad antes de mostrar un error. El valor predeterminado es 30000 milisegundos (30 segundos).

Entrada

• Habilitar formularios avanzados : habilita características mejoradas y opciones de personalización para la representación y la lógica de formularios, como:

  • Plantillas personalizables para Editar cuadrículas.
  • Botones que funcionan como eventos.
  • La capacidad de personalizar formularios utilizando ES6 y JavaScript moderno.
  • La disponibilidad de las variables instance y options para personalizar formularios.

• Habilitar edición masiva : si se selecciona, el botón Abrir diseñador de formularios masivos estará disponible en el cuerpo de la actividad. Esta opción te permite generar acciones de formulario que se pueden editar o completar de forma masiva desde la pestaña Acciones en Action Center.

  

• Usar archivo de formulario local : permite la creación de acciones de formulario utilizando un archivo de formulario JSON, especificado en la ejecución. Este campo solo admite valores Boolean . Cuando se habilita, el campo de propiedad Ruta del archivo de formulario aparece en el cuerpo de la actividad, donde se especifica la ruta al archivo JSON, donde se almacena un determinado diseño de formulario.

• GenerarCamposDeEntrada : si se selecciona, todas las entradas de la Recopilación de datos del formulario se generan como componentes en el Diseñador de formularios. Si se deja vacío, no se añaden campos de formulario al diseñador.

• Etiquetas : el robot añade las etiquetas introducidas a la acción, lo que permite futuros filtrados. Este campo solo admite valores de cadena y tiene restricciones de nombre.

Nota:

Para permitir el etiquetado automático de acciones a través de actividades de Persistencia, la cuenta de robot que ejecuta el flujo de trabajo necesita permisos para Ver, Crear y Eliminar en Etiquetas.

• Ruta de la carpeta de Orchestrator: la ruta de la carpeta de Orchestrator que quieres usar con esta actividad. Si se deja vacía se usa la carpeta de Orchestrator actual. Este campo solo admite cadenas y variables de cadena.

Nota:

Si el usuario que realiza esta acción no tiene los permisos necesarios para la carpeta de destino, la creación de la tarea falla y arroja un error crítico. Consulta más información sobre los permisos de carpeta.

• Referencia : el nombre utilizado como referencia para el filtrado futuro de las acciones. Este campo solo admite valores de cadena.
• Ruta del archivo del formulario : introduce la ruta relativa al archivo JSON del formulario que guardaste dentro del proyecto actual.

Almacenamiento

• Nombre del depósito de almacenamiento : el depósito de almacenamiento que quieres utilizar para los archivos de datos grandes a los que se hace referencia en los datos del formulario.
• Ruta de la carpeta de almacenamiento : la ruta completa a la carpeta en el depósito de almacenamiento especificado. Este campo solo admite cadenas y variables String .

Problema conocido

El Diseñador de formularios puede no actualizarse automáticamente cuando se añade una nueva columna a los componentes de la cuadrícula. Para solucionarlo, puedes utilizar la siguiente solución alternativa:

1. Abre el Diseñador de formularios.
2. Edita cualquier componente del formulario y guarda los cambios.
3. Guarda el formulario entero.
4. Vuelve a abrir el formulario, deshaz los cambios anteriores que has realizado y guárdalo de nuevo. Ahora el formulario deberá restablecerse y las nuevas columnas deberán estar visibles.