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.
• El diseño de formulario tiene un límite de 1 MB como máximo. Para ajustarte a este límite de 1 MB, debes incrustar imágenes en 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

• TaskTitle : el título de la acción que quieres crear. Este campo solo admite cadenas y variables String .
• Prioridad de tarea: te permite seleccionar el nivel de prioridad de la acción. De forma predeterminada, esta propiedad está establecida en TaskPriority.Medium . Están disponibles las siguientes opciones: TaskPriority.Low, TaskPriority.Medium, TaskPriority.H High, TaskPriority.Crítica.

• TaskCatalog : una clasificación empresarial opcional de elementos de tareas. Este campo solo admite cadenas y variables de cadena.

  Importante: Asegúrate de que el catálogo de acciones existe 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 después de que se complete la tarea. Este campo solo admite objetos Dictionary<String,Argument> .
• ObjetoDeTarea (salida) : el objeto de la tarea que se devuelve desde Orchestrator como un objeto FormTaskData después de crear las Actions . Este objeto se puede pasar a la actividad Esperar tarea de formulario y reanudar para suspender la ejecución del flujo de trabajo hasta que se completen las Actions .

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 Automation Cloud. Para acceder a la acción desde el 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 abre el Asistente del diseñador de formularios , que te permite personalizar el formulario que deseas utilizar en el 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 Boolean (Verdadero, Falso). El valor predeterminado es Falso. Por lo tanto, si el campo está vacío y se produce un error, se detiene la ejecución del proyecto. Si el valor es Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

Nota: si se incluye esta actividad en Intentar capturar y el valor de la propiedad ContinuarEnCasoDeError es Verdadero, no se detectará error cuando el proyecto se ejecute.

• NombreParaMostrar: el nombre de la actividad para ser mostrado.
• 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 después de que se complete la tarea. Este campo solo admite objetos Dictionary<String,Argument> .
• Generar CamposDeEntrada : 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 de acciones automáticas a través de actividades de Persistencia, la cuenta del robot que ejecuta el flujo de trabajo necesita permisos Ver, Creary Eliminar en etiquetas.

• Ruta de lacarpeta de Orchestrator : la ruta de la carpeta de Orchestrator que quieres usar con esta actividad. Si se deja vacía, se utiliza la carpeta actual de Orchestrator. 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.

• TaskCatalog : una clasificación empresarial opcional de elementos de tareas. Este campo solo admite cadenas y variables de cadena.

  Importante: Asegúrate de que el catálogo de acciones existe 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".
• Prioridad de tarea: te permite seleccionar el nivel de prioridad de la acción. De forma predeterminada, esta propiedad está establecida en TaskPriority.Medium . Están disponibles las siguientes opciones: TaskPriority.Low, TaskPriority.Medium, TaskPriority.H High, TaskPriority.Crítica.
• TaskTitle : 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 . Al habilitarla, el campo de propiedad Ruta del archivo de formulario aparece en el cuerpo de la actividad, donde se especifica la ruta del 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 Nuevoy comienza a crear un formulario. Cuando termine, seleccione Guardar comoy guárdelo dentro de la carpeta de proyecto correspondiente. Ahora tiene el formulario que creó almacenado dentro de un archivo JSON. Introduce la ruta de acceso a este archivo JSON dentro del campo Ruta del archivo de formulario para utilizarlo 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

• ObjetoDeTarea (salida) : el objeto de la tarea que se devuelve desde Orchestrator como un objeto FormTaskData después de crear las Actions . Este objeto se puede pasar a la actividad Esperar tarea de formulario y reanudar para suspender la ejecución del flujo de trabajo hasta que se completen las Actions .

Almacenamiento

• Nombre del depósito de almacenamiento: el depósito de almacenamiento que quieres usar para los archivos de datos grandes a los que se hace referencia en los datos del formulario.
• Ruta de lacarpeta 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 inserción de imágenes con los depósitos de almacenamiento debe hacerse junto con la actividad Cargar archivo de almacenamiento . El nombre del argumento debe tener un sufijo en la propiedad ColecciónDeDatosDeFormulario y asignarse a una imagen en el formulario mediante el uso de guiones bajos (_) 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 .

  Tenga en cuenta que los nombres de los archivos de imágenes 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 provoca un error.

Configuración multiplataforma

• TaskTitle : el título de la acción que quieres crear. Este campo solo admite cadenas y variables String .
• Prioridad de tarea: te permite seleccionar el nivel de prioridad de la acción. De forma predeterminada, esta propiedad está establecida en TaskPriority.Medium . Están disponibles las siguientes opciones: TaskPriority.Low, TaskPriority.Medium, TaskPriority.H High, TaskPriority.Crítica.

• TaskCatalog : una clasificación empresarial opcional de elementos de tareas. Este campo solo admite cadenas y variables de cadena.

  Importante: Asegúrate de que el catálogo de acciones existe 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 después de que se complete la tarea. Este campo solo admite objetos Dictionary<String,Argument> .
• ObjetoDeTarea (salida) : el objeto de la tarea que se devuelve desde Orchestrator como un objeto FormTaskData después de crear las Actions . Este objeto se puede pasar a la actividad Esperar tarea de formulario y reanudar para suspender la ejecución del flujo de trabajo hasta que se completen las Actions .

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 Automation Cloud. Para acceder a la acción desde el 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 abre el Asistente del diseñador de formularios , que te permite personalizar el formulario que deseas utilizar en el 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 Boolean (Verdadero, Falso). El valor predeterminado es Falso. Por lo tanto, si el campo está vacío y se produce un error, se detiene la ejecución del proyecto. Si el valor es Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

Nota: si se incluye esta actividad en Intentar capturar y el valor de la propiedad ContinuarEnCasoDeError es Verdadero, no se detectará error cuando el proyecto se ejecute.

• 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 . Al habilitarla, el campo de propiedad Ruta del archivo de formulario aparece en el cuerpo de la actividad, donde se especifica la ruta del archivo JSON, donde se almacena un determinado diseño de formulario.
• Generar CamposDeEntrada : 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 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 de acciones automáticas a través de actividades de Persistencia, la cuenta del robot que ejecuta el flujo de trabajo necesita permisos Ver, Creary Eliminar en etiquetas.

• Ruta de lacarpeta de Orchestrator : la ruta de la carpeta de Orchestrator que quieres usar con esta actividad. Si se deja vacía, se utiliza la carpeta actual de Orchestrator. 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 de formulario : introduce la ruta relativa al archivo JSON de formulario que guardaste dentro del proyecto actual.

Almacenamiento

• Nombre del depósito de almacenamiento: el depósito de almacenamiento que quieres usar para los archivos de datos grandes a los que se hace referencia en los datos del formulario.
• Ruta de lacarpeta 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.