Trabajo con origen de datos y enlace de valor

Información en segundo plano

Los campos Origen de datos y Vinculación de valor de un control tienen vinculación bidireccional, lo que significa que pueden actualizar los datos de origen vinculados a dicho control.

Para entender mejor esto podemos usar un ejemplo simple. Puedes intentar añadir una etiqueta y un cuadro de texto a una aplicación, luego crear una variable de aplicación. Asigna la propiedad Vinculación de valor del control de cuadro de texto y la propiedad Texto del control de etiqueta a la variable. Al previsualizar la aplicación, observa que cuando cambias el valor del cuadro de texto, la variable de aplicación también se actualiza. Por otro lado, la propiedad Texto es un campo de vinculación unidireccional, que solo muestra los datos y no puede actualizarlos.

Ejemplo

En este ejemplo construiremos una aplicación donde el usuario puede seleccionar varios elementos de una lista personalizada que proviene de un proceso.

Para este ejemplo construiremos lo siguiente:

• Un proceso de automatización
• Una aplicación usando UiPath Apps

Construcción del flujo de trabajo

El primer paso de este ejemplo es construir el flujo de trabajo en UiPath Studio. Se trata de un flujo de trabajo simple que consta de unos pocos argumentos.

1. Abre Studio y crea un nuevo Proceso.

2. Crea los siguientes argumentos:

   Nombre de Argumento	Dirección	Tipo de argumento	Valor predeterminado
   out_DataTable	Salida	TablaDeDatos	-
   in_SelectedItems	En	TablaDeDatos	new DataDable
   filtered_SelectedItems	Salida	TablaDeDatos	-

3. Arrastra una Secuencia al Diseñador de flujo de trabajo.

4. Añade una actividad Construir tabla de datos dentro del contenedor Secuencia.

   • Añade el argumento out_DataTable en el campo Tabla de datos.

   • Añade una columna llamada Seleccionado.

   • Configura la tabla como en la figura siguiente:

     

5. Añade una actividad If bajo la actividad Construir tabla de datos y sigue los pasos que se indican a continuación para configurarla.

   • Añade in_SelectedItems.Rows.Count > 0 en el campo Condición.

   • Configure Then and Else as displayed below.

     Then

     1. Drag a Sequence inside the Then container.

     2. Añade una actividad Asignar dentro del contenedor Secuencia.

     • Add filtered_SelectedItems in the To field.

     • Add (from r In in_SelectedItems.Select() Where r("Selected").Equals(true) Select r).CopyToDataTable in the Value field.

     3. Añade una actividad Mensaje de registro debajo de la actividad Asignar.

     • Set LogLevel to Info.

     • Add filtered_SelectedItems.ToString in the Message field.

     Else

     1. Arrastra una Secuencia dentro del contenedor Else.

     2. Añade una actividad Mensaje de registro debajo de la actividad Asignar.

     • Set LogLevel to Info.

     • Add "First run or empty" in the Message field.

Resultado

Al final, el flujo de trabajo debería parecerse al que se ve en la figura siguiente.

Importante:

Si tu proceso hace uso de un objeto .NET complejo en su entrada o salida (por ejemplo, TablaDeDatos), App Studio no sabe cuáles son los campos de ese objeto por defecto. Hay dos maneras de especificar esto:

• Run your process before adding it to your app. If a process uses an object, Apps will check its Job History to automatically detect the schema/fields of that object.
• Especifica manualmente los campos del objeto para la entrada/salida del proceso. Si tu proceso no tiene historial de trabajos, después de añadirlo a tu aplicación deberás especificar manualmente sus campos para poder utilizarlos en la app.

Los parámetros añadidos manualmente a un proceso se eliminarán si el proceso se actualiza.

Construcción de la aplicación

After publishing the workflow build during the Building the workflow procedure to your Orchestrator, it's time to build the app itself.

1. Crea una nueva app.

2. Consulta el proceso creado más arriba.

3. Añade un control Lista personalizada y un control Tabla a la aplicación, uno al lado del otro.

4. En el campo Origen de datos de la tabla, añade Out: out_DataTable del proceso.

   

5. Añade un control Casilla de verificación y un control Cuadro de texto a la lista personalizada y configúralos de la siguiente manera:

   • Añade el elemento Out: Item de la sección Out: out_DataTable del proceso en el campo Etiqueta del control de casilla de verificación.
   • Añade el elemento Out: Selected de la sección Out: out_DataTable del proceso en el campo Vinculación de valor del control de casilla de verificación.
   • Añade el elemento Out: Quantity de la sección Out: out_DataTable del proceso en el campo Vinculación de valor del control del cuadro de texto.

6. Añade un control Botón y llámalo Run. Configura la regla Seleccionado de la siguiente manera:

   • Añade una regla Iniciar proceso.

   • Añade un nombre en el campo Nombre de trabajo y márcalo como Atendido.

   • Añade in_SelectedItems y Out.out_DataTable en el campo Anular entrada.

     

7. Añade un contenedor debajo del botón.

8. Añade dos controles Etiqueta uno al lado del otro.

   • Añade el elemento filtered_SelectedItems.Item de la sección Out: filtered_SelectedItems del proceso en el campo Texto de la primera etiqueta.
     • Añade el elemento filtered_SelectedItems.Quantity de la sección Out: filtered_SelectedItems del proceso en el campo Texto de la primera etiqueta.

Conclusión

Al previsualizar la aplicación podrás seleccionar elementos en una lista personalizada que proviene de un proceso.

La clave de este ejemplo es entender mejor la diferencia entre Origen de datos, Vinculación de valor y entrada:

• Origen de datos y Vinculación de valor cuentan con vinculación bidireccional. Esto significa que ambos pueden actualizar los datos de origen vinculados a un control.
• Anulación de entrada te permite pasar objetos de otras fuentes, como una tabla de datos de un proceso o una entidad de Data Service.