Validar documentos con acciones de la aplicación

Esta guía de inicio rápido te ayuda a empezar a validar documentos añadiendo la Estación de validación dentro de las aplicaciones de UiPath® Action y luego enviándolas para su validación a través de Action Center como acciones de la aplicación. El tutorial utiliza UiPath Studio para automatizar el procesamiento de documentos, UiPath Apps para mostrar la estación de validación y Action Center para realizar la validación. El tipo de documento que se utiliza en los ejemplos de este tutorial es un formulario de seguro médico, de tipo formulario de reclamación CMS 1500.

Los pasos generales de esta guía de inicio rápido son:

1. Crea la aplicación de acción que muestra el control de validación.
2. Utiliza una aplicación previamente configurada para diseñar la automatización de Studio que procesa el documento y lo envía para su validación en Action Center.
3. Completa la acción en Action Center.

Pasos

1. Crea una aplicación de acción

Requisitos previos

Asegúrese de que su tenant:

• Tiene suficientes Robot Units, ya que la aplicación se ejecuta con robots sin servidor.
• Se crea una plantilla de robot sin servidor en Orchestrator y se aprovisiona. Para obtener más información sobre los robots sin servidor y añadirlos a un tenant, consulta Ejecutar automatizaciones desatendidas con robots sin servidor.

1. Crear una aplicación de acción

Nota: A diferencia de las aplicaciones VB disponibles a través del servicio Apps, se puede acceder a las aplicaciones a través de Studio Web.

Para crear una aplicación de acción, sigue estos pasos:

1. Ve a Studio Web.
2. Selecciona Crear nuevo > Aplicación para crear un nuevo proyecto.
3. En el Explorador de proyectos de tu aplicación, selecciona Añadir páginas, flujos de trabajo, controles, integraciones > Acción.

   Este paso añade una acción a tu aplicación y te permite configurar un esquema de acción para ella.

4. Expande Acción y selecciona ActionSchema.

   Configura el esquema de acción con los argumentos de entrada y salida que quieras para las acciones de la aplicación en Action Center.

   1. Para Resultados, añade otros resultados personalizados que quieras que tenga la acción.

      Por ejemplo, puedes añadir un resultado personalizado, llamado "Aprobar".

   2. Para Propiedades de entrada, añade propiedades para los datos que quieres pasar a la acción.

      Estas propiedades aparecerán en la actividad Crear tarea de aplicación , cuando se seleccione esta aplicación en la lista desplegable Aplicaciones . Las propiedades de entrada te permiten pasar datos de tu automatización de Studio a tu acción.

   3. Para Propiedades de salida, añade propiedades para los argumentos que quieres recuperar de la acción.

      Estas propiedades serán accesibles desde la actividad Esperar la tarea de la aplicación y reanudar , a través de la variable Objeto de tarea (salida) .

   4. Para las propiedades de entrada/salida , añade propiedades que funcionen como argumentos de entrada/salida en tu automatización de Studio.

      Estas propiedades de entrada/salida aparecen primero como propiedades en la actividad Crear tarea de aplicación , que se pasa a la acción. Y luego, una vez completada la acción, puedes acceder a las mismas propiedades, que se actualizaron, desde la actividad Esperar la tarea de la aplicación y reanudar , a través de la propiedad Objeto de tarea (salida) .

2. Añade y personaliza el control de validación

Un control de validación incorpora la estación de validación, utilizada en los flujos de trabajo de procesamiento de documentos. Para añadir y personalizar un control de validación dentro de una aplicación de acción, sigue estos pasos:

1. Abre la aplicación de acción deseada, donde quieres incorporar la estación de validación.
2. Selecciona Abrir caja de herramientas.
3. En Pantalla, busca el Control de validación y añádelo a tu aplicación.
   Al añadir el Control de validación a tu aplicación, se crea automáticamente una variable Var<ValidationControl_PageName> en la sección Variables de la aplicación desde el Explorador de proyectos de tu aplicación.
   Nota: Puedes utilizar el Control de validación y la Variable de aplicación correspondiente para leer la información del Control de validación. Utiliza la variable de aplicación Var<ValidationControl_PageName> para escribir información en ella.
4. Prepara el esquema de acción:
   1. En el Explorador de proyectos, en Acción, selecciona EsquemaDeAcción.
   2. En las Propiedades de entrada, selecciona Añadir propiedad.
   3. En la barra de búsqueda de propiedades, selecciona Más opciones.
   4. En Avanzado, selecciona ContentValidationData.
      Esta es la propiedad de entrada que se mostrará en la actividad Crear tarea de aplicación . La propiedad de entrada ContentValidationData requiere un objeto ContentValidationData como entrada, que puede ser un único objeto o una matriz/lista de instancias ContentValidationData . ContentValidationData contiene los artefactos de la Estación de validación. ContentValidationData se crea utilizando la actividad Crear artefactos de validación de documentos .
5. Configura el control de validación:
   1. Ve a las propiedades del Control de validación.
   2. En la entrada Origen , selecciona la entrada Acción que has definido como tipo ContentValidationData .
6. Configura el resto de la aplicación con otros controles que necesites.

3. Acceder a los datos de control de validación y sus propiedades

Se puede acceder a varias propiedades del Control de validación, como Taxonomía, Resultado de extracción, Tipo de documento seleccionado, Campo seleccionado y Fuente de datos, utilizando la variable Control de validación (VarValidationControl_PageName). Puedes cambiar los valores mostrados en el Control de validación a través de la variable de aplicación correspondiente. Sigue los pasos descritos en Editar datos de control de validación para añadir, modificar o eliminar un valor de campo.

La siguiente tabla describe las propiedades a las que puedes acceder desde el Control de validación, su tipo de datos y descripciones.

Tabla 1. Propiedades del control de validación

Propiedad	Tipo de datos	Descripción
Taxonomy	UiPath.DocumentProcessing.Contracts.Taxonomy.DocumentTaxonomy	El objeto de taxonomía con el que se preparó el contenido para su visualización. Contiene información sobre tipos de documentos, campos y propiedades de visualización.
ResultadoDeExtracción	UiPath.DocumentProcessing.Contracts.Results.ExtractionResult	Los resultados de la extracción, tal como son (con o sin cambios humanos), desde el Control de validación.
TipoDeDocumentoSeleccionado	System.String	El nombre del tipo de documento actualmente seleccionado en el Control de validación.
SelectedField	UiPath.DocumentProcessing.Contracts.Apps.FieldValueDetails	El campo actualmente seleccionado en el Control de validación junto con su valor.
DataSource	UiPath.DocumentProcessing.Contracts.Actions.ContentValidationData	Los datos de validación de contenido que actualmente son el origen del control de validación.
Hidden	boolean	El estado de la propiedad de control que rige si el control está visible u oculto.
Disabled	boolan	El estado de la propiedad de control que rige si el control es editable o no.
IsValid	boolean	Comprueba la validez del valor de Control de validación. Si es verdadero, indica que es válido.

4. Editar datos de control de validación

Puedes cambiar los valores mostrados en el Control de validación a través de la variable de aplicación correspondiente. Por ejemplo, puedes cambiar los valores de Resultado de extracción que se muestran en el Control de validación a través de la variable de aplicación correspondiente.

El siguiente ejemplo muestra cómo actualizar un valor de campo regular:

1. Selecciona cualquier Control en tu aplicación y ve a Eventos.
2. Selecciona Definir automatización.

   Esta acción abre el panel del diseñador de Studio Web, donde puedes crear una automatización de desencadenador para un determinado control de la aplicación.

3. En el contexto de los Resultados de extracción del documento, para añadir o cambiar un valor de campo para campos regulares, añade una actividad Establecer valor de variable en la automatización.
   1. Para el campo A variable , utiliza AppVariable.VarValidationControl_PageName.Field("<field name>").Value.
      Esta expresión representa el campo que quieres cambiar, al que se accede a través de la variable VarValidationControl_PageName .
   2. En el campo Para , introduce el valor deseado para el campo al que se hace referencia.
   Además de los campos regulares, la variable AppVariable.VarValidationControl_PageName también puede manipular campos multivalor utilizando AppVariable.VarValidationControl_PageName.Field("<field name>", <index>) e interactuar con celdas de tabla utilizando AppVariable.VarValidationControl_PageName.Field("<table field name").Field("<column name>", <row index>).
   Para eliminar valores, selecciona el valor de destino de forma similar y utiliza el marcador .DeleteValue establecido en Verdadero.

   Las propiedades de los valores que puedes actualizar en el control de validación incluyen:

   • Valor textual (.Value)
   • Estado confirmado (.Confirmed)
   • Nivel de confianza del valor (.Confidence)
   • Marca de eliminación (.DeleteValue)
   • Marcar para eliminar una referencia de valor (.KeepReference)

Puedes utilizar los mismos pasos para cambiar otros datos de Control de validación en tiempo de ejecución. La única diferencia es que utilizas una variable diferente, en el campo A variable , por lo que corresponde a los datos de Control de validación que quieres cambiar. Por ejemplo, puedes utilizar la variable AppVariable.ValidationControl.SelectedDocumentType si quieres actualizarla con un valor diferente.

Figura 1. Las actividades Establecer valor de variable a través de las cuales puede actualizar los datos del Control de validación

5. Crear eventos para el control de validación

Puedes desencadenar varios eventos específicos del control de validación. En el Explorador de proyectos, navega hasta el Control de validación y selecciónalo. El panel Eventos del Control de validación te permite definir automatizaciones para eventos específicos.

La siguiente tabla describe los eventos de control de validación disponibles:

Tabla 2. Eventos de control de validación

Evento	Descripción
Listo	Se activa cuando se carga el control de validación.
El tipo de documento ha cambiado	Se activa cuando el usuario cambia el tipo de documento desde el Control de validación.
Campo seleccionado	Se activa cuando el usuario selecciona uno de los campos, o el valor de un campo, en el Control de validación.
Valor de campo cambiado	Se activa cuando el usuario añade, elimina o reemplaza un valor de campo en el Control de validación.

6. Utiliza actividades de control de validación dedicadas

Puedes utilizar actividades específicas dedicadas a trabajar con el control de validación, desde el paquete AppEvents.Activities :

1. Establecer enfoque de campo de control de validación: te permite centrarte en un campo, en función de un evento configurado.
2. Guardar estado del control de validación: guarda el estado del control de validación. Puedes utilizarlo cuando quieras volver a visitar y completar la validación más tarde.

Expresiones de control de validación comunes

Cuando creas tu aplicación que contiene un Control de validación, puedes utilizar las siguientes expresiones para acceder a varios datos expuestos por el Control de validación. La siguiente tabla describe las expresiones más comunes que puedes utilizar al trabajar con el control de validación:

Tabla 3. Expresiones comunes de control de validación

Propósito	Expresión
Acceder a los resultados de extracción mostrados en el control de validación	AppVariable.VarValidationControl_PageName.ExtractionResult PáginaPrincipal.ControlDeValidación.ResultadoDeExtracción
Acceder a la taxonomía cargada en el Control de validación	AppVariable.VarValidationControl_PageName.Taxonomy MainPage.ValidationControl.Taxonomy
Acceder al campo seleccionado en el Control de validación	AppVariable.VarValidationControl_PageName.SelectedField MainPage.ValidationControl.SelectedField Las propiedades del campo seleccionado pueden ser: Field.FieldName : nombre del campo. Field.FieldType : tipo de campo. Field.ValidatorNotes : las notas del validador del campo. Field.Values : todos los valores de un campo seleccionado. Field.Value : información relacionada con el valor del campo: FieldValue.Value FieldValue.Confidence FieldValue.OperatorConfirmed FieldValue.FieldValueIndex (para campos multivalor devuelve el índice al que pertenece el valor de campo seleccionado).
Acceder a propiedades adicionales de Control de validación	MainPage.ValidationControl.<PropertyName>
Leer datos de resultados de extracción	Utiliza los métodos expuestos por la clase Resultado de extracción.
Leer datos de taxonomía	Utiliza los métodos expuestos por la clase Taxonomía.
Acceder a un valor de campo para actualizarlo en el Control de validación	AppVariable.<ValidationControlVariable>.Field("<FieldName>").Value
Recuperar la lista de nombres de campo que se muestra en el Control de validación	AppVariable.<ValidationControlVariable>.ExtractionResult.GetFields().Select(Function(f) f.FieldName)

6. Publicar e implementar la aplicación

Después de crear tu aplicación de acción y desencadenar automatizaciones para los controles dentro de ella, puedes publicarla. Al publicar la aplicación, estará disponible para crear acciones de la aplicación. Para obtener más información sobre la publicación de aplicaciones, consulta Publicar, implementar y actualizar proyectos de aplicaciones.

2. Crear automatización de Studio

Requisitos previos

• Instala las siguientes versiones del paquete de actividades:
  • IntelligentOCR.Activities versión 6.24.0
  • Persistence.Activities versión 1.5.5 o superior.
  • AppEvents.Activities versión 3.12.0 o superior.
• Crea un depósito de almacenamiento en Orchestrator, en la misma carpeta donde quieres publicar la automatización del procesamiento de documentos.

  Los datos necesarios para cargar el control de validación dentro de las aplicaciones se almacenan en un depósito de almacenamiento de Orchestrator.

• Añade el documento que quieres procesar dentro de la carpeta del proyecto de Studio.
• Opcionalmente, si desea utilizar capacidades de extracción o validación generativas, necesita unidades de servicio específicas
  • Si te inscribiste en el plan Flex , necesitas unidades de IA

  Para obtener más información sobre las características generativas de Document Understanding, consulta Características generativas.

1. Procesar un archivo utilizando Document Understanding

Añade actividades que utilizan Document Understanding para procesar un archivo. Prepara el documento para su validación en Action Center, a través de aplicaciones, utilizando la digitalización y la extracción.

Después de añadir las actividades para procesar el archivo, las siguientes variables deberían estar disponibles:

• DocumentTaxonomy (Taxonomía): recuperado a través de la actividad Cargar taxonomía .
• Dom (Modelo de objeto de documento) y text (Texto de documento): adquiridos a través de la actividad Digitalizar documento .
• doc (Ruta del documento): representa la ruta al archivo procesado.
• autoExtractionResults (ExtractionResults): este es el resultado de la actividad Ámbito de extracción de datos , independientemente de los métodos de extracción utilizados.

2. Envía la información de validación a la aplicación

Una vez que el documento esté listo para ser validado, puedes preparar toda la información para enviarla a la aplicación creada e implementada previamente. Sigue estos pasos:

1. Añade una actividad Crear artefactos de validación de documentos para crear el objeto Content Validation Data que almacena la información necesaria para cargar el Control de validación dentro de la aplicación Acción.
   En este ejemplo, configura la actividad utilizando las variables previamente creadas o generadas:

   • Ruta de la carpeta del depósito: el nombre de la carpeta de Orchestrator donde se creó el depósito de almacenamiento.
   • Nombre del depósito: storageBucketName
   • Ruta del directorio del depósito: la ruta del directorio dentro del depósito de almacenamiento introducido anteriormente, donde quieres almacenar los datos de la acción.
   • RutaDeDocumento: doc
   • Texto del documento: text
   • Modelo de objeto de documento: dom
   • Taxonomía: taxonomy
   • Resultados de extracción automática: autoExtractionResults
2. Añade una actividad Crear tarea de aplicación , para que puedas vincular el objeto Content Validation Data a la aplicación diseñada previamente y luego enviarlo a Action Center para su validación.

   En este ejemplo, configura la actividad de la siguiente manera:

   • Título: CVD
   • Prioridad: Medium
   • Aplicaciones: Demo.Validation.Control.in.Apps
   • Versión de la aplicación: v2.0.0

     Después de seleccionar la aplicación y la versión correspondiente que deseas utilizar para crear la acción, las propiedades de entrada de esa aplicación se mostrarán en el cuerpo de la actividad.

     • En este ejemplo, una de las propiedades de entrada es Action_Content_Validation_Data, que requiere los artefactos de validación de documentos creados previamente: contentValidationData.
   Figura 2. La actividad Crear tarea de aplicación
   

   

   
   
3. Añade una actividad Esperar tarea de aplicación y reanudar para devolver la información sobre la acción y reanudar el flujo de trabajo.

   En el campo Tarea de aplicación creada , introduce la variable de salida de la actividad Crear tarea de aplicación .

4. Añade una actividad Recuperar artefactos de validación de documentos , para devolver los artefactos de validación de documentos después de que el usuario haya realizado la validación en Action Center.

   Pasa la variable de salida de la actividad Crear artefactos de validación de documentos como la entrada de la actividad Recuperar artefactos de validación de documentos .

   Consejo: También puedes crear variables de salida dedicadas para información adicional almacenada en los artefactos de validación, como ResultadosDeExtracciónAutomáticos y ResultadosDeExtracciónValidados.

3. Realizar la validación en Action Center

1. Abre Action Center y ve a Mis acciones o Administrar acciones.
2. En la pestaña Sin asignar , busca la acción que acabas de crear utilizando la automatización de Studio anterior.
3. Si quieres asignarte la acción a ti mismo, selecciona la acción deseada y luego selecciona Asignar a uno mismo.
4. Si quieres asignar la acción a otro usuario, selecciona Más opciones para la acción deseada. A continuación, selecciona Asignar a usuario y selecciona un usuario de la lista desplegable.
5. Ve a la pestaña Pendiente y completa la acción, para que se pueda reanudar el flujo de trabajo de Studio.