Unir tablas de datos

UiPath.Core.Activities.JoinDataTables

Descripción

Combina filas de dos tablas usando valores comunes entre sí, de acuerdo con una regla de unión que se especifica en la propiedad TipoDeUnión.

Compatibilidad de proyectos

Windows - Heredado | Windows | Multiplataforma

Configuración multiplataforma

• Tabla de datos 1 : la primera tabla que quieres usar en la operación de unión, almacenada en una variable DataTable . Este campo solo admite variables DataTable .

• Tabla de datos 2 : la segunda tabla que quieres usar en la operación de unión, almacenada en una variable DataTable . Este campo solo admite variables DataTable .

Nota: el orden en que se proporcionan ambas tablas es muy importante, ya que influye en la estructura de la tabla resultante, de acuerdo con la opción seleccionada en el campo de propiedad TipoDeUnión.

• TipoDeUnión: el tipo de operación de unión que quieres utilizar. Las siguientes opciones están disponibles:

  • Interno: mantiene todas las filas de la TablaDeDatos1 y de la TablaDeDatos2 que cumplen la regla de unión. Cualesquiera filas que no cumplan la regla se eliminan de la tabla resultante.
  • Dejadas: mantiene todas las filas de la TablaDeDatos1 y solo los valores de la TablaDeDatos2 que cumplen la regla de unión. Se insertan valores nulos en la columna para las filas de la TablaDeDatos1 que no tienen coincidencia en las filas de la TablaDeDatos2.

  • Completo: mantiene todas las filas de la TablaDeDatos1 y de la TablaDeDatos2, independientemente de si se cumple la condición de unión o no. Se agregan valores nulos en las filas de ambas tablas que no tienen coincidencia.

    Nota: si una columna de la TablaDeDatos2 comparte el mismo nombre con una columna de la TablaDeDatos1, entonces el nombre de la columna de la TablaDeDatos2 se cambia a [ColumnName]_1 en la tabla resultante. Si ya existe una columna con el nombre [ColumnName]_1, se usa en su lugar el número consecutivo que no esté ya en uso. Por ejemplo, si la TablaDeDatos1 tiene columnas llamadas ID, ID_1 e ID_2, y la TablaDeDatos2 tiene una columna llamada ID, después de la unión la columna de la TablaDeDatos2 se llamará ID_3.

• Reglas de unión: las condiciones para unir las tablas. Al seleccionar el campo, se abre un generador de filtros simple donde puede agregar reglas que componen el filtro.

Windows (heredado), configuración de Windows

Panel de propiedades

Común

• NombreParaMostrar: el nombre de la actividad para ser mostrado.

Entrada

• TablaDeDatos1: la primera tabla que quieres usar en la operación de unión, almacenada en una variable DataTable. Este campo solo admite variables DataTable.
• TablaDeDatos2: la segunda tabla que quieres utilizar en la operación de unión, almacenada en una variable DataTable. Este campo solo admite variables DataTable.
  Nota: el orden en que se proporcionan ambas tablas es muy importante, ya que influye en la estructura de la tabla resultante, de acuerdo con la opción seleccionada en el campo de propiedad TipoDeUnión.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Opciones

• TipoDeUnión: el tipo de operación de unión que quieres utilizar. Las siguientes opciones están disponibles:

  • Interno: mantiene todas las filas de la TablaDeDatos1 y de la TablaDeDatos2 que cumplen la regla de unión. Cualesquiera filas que no cumplan la regla se eliminan de la tabla resultante.
  • Dejadas: mantiene todas las filas de la TablaDeDatos1 y solo los valores de la TablaDeDatos2 que cumplen la regla de unión. Se insertan valores nulos en la columna para las filas de la TablaDeDatos1 que no tienen coincidencia en las filas de la TablaDeDatos2.

  • Completo: mantiene todas las filas de la TablaDeDatos1 y de la TablaDeDatos2, independientemente de si se cumple la condición de unión o no. Se agregan valores nulos en las filas de ambas tablas que no tienen coincidencia.

    Nota: si una columna de la TablaDeDatos2 comparte el mismo nombre con una columna de la TablaDeDatos1, entonces el nombre de la columna de la TablaDeDatos2 se cambia a [ColumnName]_1 en la tabla resultante. Si ya existe una columna con el nombre [ColumnName]_1, se usa en su lugar el número consecutivo que no esté ya en uso. Por ejemplo, si la TablaDeDatos1 tiene columnas llamadas ID, ID_1 e ID_2, y la TablaDeDatos2 tiene una columna llamada ID, después de la unión la columna de la TablaDeDatos2 se llamará ID_3.

Salida

• TablaDeDatos: la tabla con los valores unidos, almacenada en una variable DataTable. Este campo solo admite variables DataTable.

Asistente de unión

Este asistente te ayuda a configurar las propiedades de la actividad Unir tablas de datos. Se puede abrir usando el botón Asistente de unión del cuerpo de la actividad en el panel Diseñador.

Desde la sección superior del asistente puedes seleccionar ambas variables DataTable que deseas utilizar en la operación, el tipo de unión y la variable de salida de los campos siguientes:

• TablaDeDatos1 de entrada: la variable DataTable que contiene la primera tabla que quieres usar.
• TablaDeDatos2 de entrada: la variable DataTable que contiene la segunda tabla que quieres usar.
• TablaDeDatos de salida: la variable DataTable en la que quieres almacenar la tabla resultante.
• Tipo de unión: el tipo de operación de unión que quieres usar. Las siguientes opciones están disponibles:
• Interno: mantiene todas las filas de la TablaDeDatos1 y de la TablaDeDatos2 que cumplen la regla de unión. Cualesquiera filas que no cumplan la regla se eliminan de la tabla resultante.
• Dejadas: mantiene todas las filas de la TablaDeDatos1 y solo los valores de la TablaDeDatos2 que cumplen la regla de unión. Se insertan valores nulos en la columna para las filas de la TablaDeDatos1 que no tienen coincidencia en las filas de la TablaDeDatos2.
• Completo: mantiene todas las filas de la TablaDeDatos1 y de la TablaDeDatos2, independientemente de si se cumple la condición de unión o no. Se agregan valores nulos en las filas de ambas tablas que no tienen coincidencia.

Desde la sección inferior del asistente puedes configurar la estructura de la tabla resultante añadiendo expresiones que indican relaciones entre columnas. Cada una de estas expresiones tiene tres elementos, a saber:

• Columna tabla 1: el nombre de la columna en la primera tabla. Este campo solo admite variables String que contienen el nombre de columna, variables Int32 que contienen el índice de columna o variables ExcelColumn.

• Operación: la operación que define la relación entre las columnas. Las siguientes opciones están disponibles:

  • =: Igual a
  • !=: No igual a
  • > - mayor que
  • < - Menor que
  • > = - Mayor o igual a
  • <= - Menor que o igual a
• Columna Tabla 2: el nombre de la columna de la segunda tabla. Este campo solo admite variables String que contienen el nombre de columna, variables Int32 que contienen el índice de columna o variables ExcelColumn.

Ejemplo de uso de la actividad Unir tablas de datos

Para poner un ejemplo de cómo usar esta actividad, hemos creado un proyecto que une dos hojas de un libro de trabajo en otra hoja de dicho libro de trabajo. La primera hoja contiene detalles de pedidos, mientras que la segunda hoja contiene detalles de clientes. Ambas hojas tienen una columna común, IDDeCliente, que se utiliza para la operación de unión. El proyecto se puede descargar aquí.

1. Crea un Proyecto en blanco.
2. Arrastra un contenedor Secuencia en el panel Diseñador.
3. Arrastra un Ámbito de aplicación Excel y coloca la ruta del libro de trabajo de Excel en la propiedad Ruta del libro de trabajo.
4. Crea dos variables DataTable, una para la hoja Clientes y una más para la hoja Pedidos.
5. Dentro del Ámbito de aplicación Excel, arrastra dos actividades Leer rango.
6. Establece las dos actividades Leer rango para que lean cada una de las hojas del libro de trabajo de Excel y guárdalas en sus variables correspondientes.
7. Crea una variable DataTable para almacenar la tabla resultante.
8. Arrastra una actividad Unir tablas de datos en el contenedor de ámbito.
9. Haz clic en el botón Asistente de unión del cuerpo de la actividad. Se abre el Asistente de unión de tablas de datos.
10. Establece la variable que contiene la hoja Clientes dentro del campo TablaDeDatos de Entrada 1.
11. Establece la variable que contiene la hoja Pedidos en el campo TablaDeDatos de salida 2.
12. Establece la variable creada para almacenar la tabla resultante en el campo TablaDeDatos de Salida.
13. En el menú desplegable Tipo de unión, selecciona Interno.
14. En el campo Columna tabla 1, establece como entrada la columna que corresponde a la columna IDDeCliente de la hoja Clientes.
15. En el menú desplegable Operación, selecciona =.

16. En el campo Columna Tabla 2, establece como entrada la columna que corresponde a la columna IDDeCliente de la hoja Pedidos. El Asistente debe parecerse a esto:

    
    

    

    
    
17. Arrastra una actividad Escribir intervalo al panel Diseñador.
18. Configura Escribir intervalo para que escriba la variable DataTable que contiene la tabla resultante en una nueva hoja en el libro de trabajo inicial.

19. El flujo de trabajo final debe parecerse a este: