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

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.
• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• TaskCatalog - An optional business classification of task items. This field supports only strings and String variables.
  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".

• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.
• 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 Automation Cloud. 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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any 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.

  

• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.

• GenerateInputFields - If selected, all the entries from the Form Data Collection are generated as components in the Form Designer. Leaving it empty does not add additional form fields to the designer.

• 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:

  To allow automatic actions labeling through Persistence activities, the robot account executing the workflow needs View, Create, and Delete permissions on Tags.

• Orchestrator Folder Path - The path to the Orchestrator Folder you want to use with this activity. If left empty, the current Orchestrator folder is used. This field supports only strings and String variables.

  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.

• Reference - The name used as reference for future filtering of the actions. This field supports string values only.

• TaskCatalog - An optional business classification of task items. This field supports only strings and String variables.

  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".

• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.

• Use Local Form File - enables the creation of Form Actions using a JSON form file, specified at execution. This field supports Boolean values only. When you enable it, the Form File Path property field appears in the body of the activity, where you specify the path to the JSON file, where a certain form layout is stored.

After you select Use Local Form File, click Open Form Designer, select New, and start building a form. When you finish , select Save As, and save it inside the corresponding project folder. Now you have the form that you previously created stored inside a JSON file. Input the path to this JSON file inside the Form File Path field to use that form at runtime.

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

• Storage Bucket Name - The storage bucket you want to use for large data files referenced in the form data.
• Storage Folder Path - The full path to the folder in the specified storage bucket. This field supports strings and String variables only.
  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

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.
• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• TaskCatalog - An optional business classification of task items. This field supports only strings and String variables.
  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".

• FormData - A collection of business data in the form Dictionary<String,Argument> that you want to display in a form within the Actions inbox. Modifying Out and In/Out arguments maps them back to the workflow after the task is completed. This field supports Dictionary<String,Argument> objects only.
• 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 Automation Cloud. 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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any 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.

  

• Use Local Form File - enables the creation of Form Actions using a JSON form file, specified at execution. This field supports Boolean values only. When you enable it, the Form File Path property field appears in the body of the activity, where you specify the path to the JSON file, where a certain form layout is stored.

• GenerateInputFields - If selected, all the entries from the Form Data Collection are generated as components in the Form Designer. Leaving it empty does not add form fields to the designer.

• 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:

  To allow automatic actions labeling through Persistence activities, the robot account executing the workflow needs View, Create, and Delete permissions on Tags.

• Orchestrator Folder Path - The path to the Orchestrator Folder you want to use with this activity. If left empty, the current Orchestrator folder is used. This field supports only strings and String variables.

  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.

• Reference - The name used as reference for future filtering of the actions. This field supports string values only.

• Form File Path - input the relative path to the form JSON file that you saved inside the current project.

Almacenamiento

• Storage Bucket Name - The storage bucket you want to use for large data files referenced in the form data.
• Storage Folder Path - The full path to the folder in the specified storage bucket. This field supports strings and String variables only.

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.