- Notas relacionadas
- Antes de empezar
- Primeros pasos
- Instalación y actualización
- Actividades
- Diseñar flujos de trabajo de larga duración
- Comenzar trabajo y obtener referencia
- Esperar trabajo y continuar
- Agregar elemento de la cola y obtener referencia
- Esperar elemento de la cola y continuar
- Crear tarea de formulario
- Esperar la tarea de formulario y continuar
- Reanudar después del retraso
- Asignar tareas
- Crear Tarea Externa
- Esperar la Tarea Externa y continuar
- Complete Task
- Forward Task
- Get Form Tasks
- Get Task Data
- Agregar comentario de tarea
- Actualizar etiquetas de la tarea
- Acciones
- Procesos
- Solución de problemas
Crear tarea de formulario
UiPath.Persistence.Activities.FormTask.CreateFormTask
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.
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ú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 acciones fallará 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 argumentosOut
yIn/Out
los asigna de nuevo al flujo de trabajo después de que se complete la tarea. Este campo solo admite objetosDictionary<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 .
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 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 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.
- 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
yoptions
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 argumentosOut
yIn/Out
los asigna de nuevo al flujo de trabajo después de que se complete la tarea. Este campo solo admite objetosDictionary<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 un filtrado futuro. Este campo solo admite valores de cadena y tiene restricciones de nombre.
- 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.
- 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ú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 acciones fallará 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.
- 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ú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 acciones fallará 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 argumentosOut
yIn/Out
los asigna de nuevo al flujo de trabajo después de que se complete la tarea. Este campo solo admite objetosDictionary<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 .
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 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 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.
- 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
yoptions
para personalizar formularios.
- Habilitar edición masiva : si se selecciona, el botón Abrir diseñador de formularios masivos está disponible en el cuerpo de la actividad. Esta opción te permite generar acciones desde el formulario que pueden editarse en masa o completarse desde la pestaña Acciones en el 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 un filtrado futuro. Este campo solo admite valores de cadena y tiene restricciones de nombre.
- 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.
- 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
.
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:
- Abre el Diseñador de formularios.
- Edita cualquier componente del formulario y guarda los cambios.
- Guarda el formulario entero.
- 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.