Filtrar tabla de datos

UiPath.Core.Activities.FilterDataTable

Te permite filtrar una variable DataTable especificando condiciones en la ventana Asistente de filtro. La actividad puede mantener o eliminar filas o columnas de acuerdo con las condiciones lógicas que se especifiquen en el asistente. El cuerpo de la actividad contiene un botón Asistente de filtro para poder acceder al asistente y personalizar los ajustes en cualquier momento.

Importante:

Debido a cambios internos, esta actividad ya no será visible en la lista de Favoritos al actualizar a la versión 20.4 o posterior, si se añadió a la lista de Favoritos con una versión 19.4 o anterior de UiPath.System.Activities.

Compatibilidad de proyectos

Windows: heredado | Multiplataforma

Configuración multiplataforma

Propiedades

• TablaDeDatos: la variable DataTable que deseas filtrar. Este campo solo admite variables DataTable.
• Condiciones de filtro : las condiciones utilizadas para filtrar la tabla de datos.

Opciones avanzadas

• Acción : especifica si filtrar la tabla manteniendo o eliminando las filas de destino.

• Tabla de datos filtrados : la tabla de datos filtrados resultante.

• Primera fila : la primera fila de la tabla de datos que coincide con los filtros configurados.

  

Windows (heredado), configuración de Windows

Propiedades

Común

• DisplayName - The display name of the activity. This field supports only strings or String variables.

Entrada

• TablaDeDatos: la variable DataTable que deseas filtrar. Este campo solo admite variables DataTable.

Otros

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

Opciones

• ModoDeFilasDeFiltro : especifica si filtrar la tabla manteniendo o eliminando las filas de destino. Selecciona una de las dos opciones del menú desplegable: Mantener o Eliminar. El valor predeterminado es Mantener.
• SeleccionarModoDeColumnas : especifica si filtrar la tabla manteniendo o eliminando las columnas de destino. Selecciona una de las dos opciones del menú desplegable: Mantener o Eliminar. El valor predeterminado es Mantener.

Salida

• TablaDeDatos : la variable DataTable filtrada resultante. Al utilizar la misma variable que la del campo Entrada se sobrescribe la variable inicial, mientras que al añadir una nueva variable no se ve afectada la inicial. Este campo solo admite variables DataTable .
  Nota:

  • Si copias y pegas una actividad Filtrar tabla de datos personalizada dentro del panel Diseñador, no conserva su configuración.
  • No se admiten intervalos de Excel como entrada para esta actividad.

Asistente de filtro

Este asistente ayuda a construir las opciones de filtrado para una variable DataTable. Se puede abrir usando el botón Asistente de filtro del cuerpo de la actividad en el panel Diseñador. Puedes seleccionar la DataTable que deseas modificar, además de aquella en la que quieres guardar los cambios, desde los campos siguientes:

• Tabla de datos de entrada: la variable DataTable que quieres filtrar. Este campo solo admite variables DataTable.
• Tabla de datos de salida: la variable DataTable de salida. Si se usa la misma variable que está presente en el campo Entrada, se sobrescribe con los cambios. Al proporcionar una variable diferente no se modifica la variable de Entrada.

También puedes seleccionar si filtrar por Fila o por Columna dependiendo de la pestaña que selecciones. Hay dos pestañas, como sigue:

Descripciones de campo de pestaña Filtrar filas

La pestaña Filtrar filas te permite filtrar una DataTable por Filas. Para hacerlo, tienes las siguientes opciones:

1. Mantener o eliminar filas coincidentes: especifica si filtrar las filas manteniéndolas o eliminándolas. Esto puede hacerse seleccionando los botones de radio Mantener o Eliminar. Al seleccionar Mantener solo se mantienen las filas que cumplen la condición especificada, mientras que al seleccionar Eliminar se eliminan las filas que cumplen la condición especificada.
2. Y/O: especifica las conjunciones lógicas que se usarán entre condiciones. Este botón se muestra solamente si tienes más de una condición. De forma predeterminada, cuando agregas una nueva condición, el botón se muestra como Y. Haz clic en el botón para cambiar su valor a O.
3. Columna: el nombre o índice de la columna que debe cumplir la condición.
4. Operación: la condición lógica que se debe cumplir entre la Columna y el Valor.
5. Valor: el valor que debe comprobarse con la Operación y la Columna.
6. Añadir/Eliminar condición: al hacer clic en el botón + se añade otra frase a la condición, mientras que al hacer clic en el botón x se elimina una frase.
   Nota:

   Al proporcionar una variable en el cuadro de texto Columna, puedes utilizar una variable Int32 para especificar el índice de la columna, o una variable String para especificar el nombre de la columna.

Salida

La pestaña Columnas de salida te permite filtrar una DataTable por Columnas. Para hacerlo, tienes las siguientes opciones:

1. Modo de selección de columnas : especifica si se filtran las columnas manteniéndolas o eliminándolas. Esto se puede hacer seleccionando los botones de radio Mantener o Eliminar. Al seleccionar Mantener solo se mantienen las columnas que se especifican a continuación, mientras que al seleccionar Eliminar se eliminan las filas que se especifican a continuación de la entrada DataTable.
2. Columna : las columnas que quieres mantener o eliminar del DataTable.
   Nota:

   Al proporcionar una variable en el cuadro de texto Columna , puedes utilizar una variable Int32 para especificar el índice de la columna, o una variable String para especificar el nombre de la columna.

3. Añadir/Eliminar columnas: al hacer clic en el botón + se añade otra columna, mientras que al presionar el botón x se elimina la columna.
   Nota:

   El orden en el que añades columnas en el Asistente es el orden en el que se organizan las columnas en la tabla de salida.

Ejemplo de uso de la actividad Filtrar tabla de datos

Aquí puedes ver cómo se utiliza la actividad Filtrar tabla de datos en un ejemplo que incorpora varias actividades.