Documentation – Agregar campos de fila y columna a una tabla dinámica en Aspose.Cells para .NET

Java: Filtrar Tablas Dinámicas por Etiqueta o Valor

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells ofrece cinco estrategias prácticas para filtrar los datos mostrados en una tabla dinámica. Puede aplicar filtros de etiqueta a campos de fila o columna basados en texto, usar filtros de fecha cuando el campo contiene únicamente celdas de fecha-hora o en blanco, aplicar filtros de valor contra números agregados, usar filtros top 10 para clasificar por un campo de valor, o ocultar y mostrar manualmente elementos individuales de la tabla dinámica usando la propiedad IsHidden. Cada estrategia se expone a través de API dedicadas en las clases PivotField y PivotItem.

Introducción

Las tablas dinámicas son potentes herramientas analíticas, pero los resúmenes sin procesar a menudo contienen mucha más información de la que necesita presentar. El filtrado es el mecanismo principal para reducir una tabla dinámica a las filas, columnas o valores que importan para un informe específico. Aspose.Cells for Java refleja las capacidades de filtrado disponibles en Microsoft Excel, exponiéndolas mediante programación para que la generación de informes pueda ser completamente automatizada.

Las siguientes estrategias de filtrado se cubren en este artículo:

Filtro de Etiqueta — filtra los elementos de un campo de fila o columna basándose en sus etiquetas de texto.
Filtro de Fecha — filtra campos de fila o columna que contienen únicamente valores de fecha-hora (o en blanco).
Filtro de Valor — filtra elementos basándose en los valores agregados de un campo de datos.
Filtro Top 10 — muestra solo los N elementos superiores o inferiores clasificados por un campo de valor.
Ocultar / Mostrar Elementos de la Tabla Dinámica — controla manualmente la visibilidad de cada elemento individual en un campo.

Cada enfoque utiliza un método diferente en la clase PivotField o una propiedad en la clase PivotItem. Después de aplicar cualquier filtro, debe llamar a refreshData() y calculateData() en la tabla dinámica para que los datos en caché y los valores calculados reflejen el nuevo estado del filtro.

Filtro de Etiqueta

Un filtro de etiqueta le permite filtrar los elementos de un campo de fila o columna comparando sus textos de etiqueta con un patrón. Esto es útil cuando desea mostrar solo los productos cuyos nombres comienzan con una letra específica, contienen una palabra particular, o cumplen con algún otro criterio basado en la etiqueta.

Aspose.Cells expone el filtrado de etiquetas a través del método PivotField.filterByLabel(PivotFilterType, String). La enumeración PivotFilterType incluye valores como CaptionBeginsWith, CaptionContains, CaptionEndsWith, CaptionDoesNotContain, CaptionIsNotBlank, CaptionIsBlank, etc. El segundo argumento proporciona la cadena de etiqueta utilizada para la comparación.

El siguiente ejemplo carga un libro de trabajo que contiene una tabla dinámica existente, aplica un filtro de etiqueta para que solo permanezcan visibles los elementos cuyas etiquetas comiencen con un prefijo específico, actualiza la tabla dinámica y guarda el resultado.

import com.aspose.cells.*;

String fileName = "sample.xlsx";
String prefix = "B";

// Cargar el libro de trabajo existente que contiene una tabla dinámica
Workbook workbook = new Workbook(fileName);

// Acceder a la hoja de trabajo por índice (primera hoja de trabajo)
Worksheet worksheet = workbook.getWorksheets().get(0);

// Acceder a la tabla dinámica por índice
PivotTable pivotTable = worksheet.getPivotTables().get(0);

// Obtener el primer campo de fila PivotField
PivotField rowField = pivotTable.getRowFields().get(0);

// Aplicar el filtro de etiqueta - mostrar solo los elementos de fila cuyas etiquetas comiencen con el prefijo proporcionado
rowField.filterByLabel(PivotFilterType.CAPTION_BEGINS_WITH, prefix, "");

// Actualizar y recalcular los datos de la tabla dinámica para que el filtro surta efecto
pivotTable.refreshData();

// Guardar el libro de trabajo de vuelta en el disco
workbook.save(fileName);

Filtro de Fecha

Los filtros de fecha le permiten reducir una tabla dinámica mediante criterios basados en fechas como hoy, la semana pasada, este mes, el próximo trimestre, o un rango de fechas específico. Son filtros especializados que funcionan solo contra campos que almacenan información de fecha-hora.

El filtro de fecha solo funciona cuando el área de filas o columnas contiene únicamente celdas de fecha-hora o valores en blanco. Si el campo subyacente contiene otros tipos de datos como números o texto, el filtro de fecha no producirá el resultado esperado. Asegúrese de que el campo esté formateado como fecha y que todos los valores sean instancias válidas de DateTime o celdas vacías antes de aplicar este filtro.

Aspose.Cells expone el filtrado de fechas a través del método PivotField.filterByDate(PivotFilterType, params DateTime[] values). La enumeración PivotFilterType contiene valores de fecha dedicados como Today, Yesterday, LastWeek, ThisWeek, NextWeek, LastMonth, ThisMonth, NextMonth, LastQuarter, ThisQuarter, NextQuarter, LastYear, ThisYear, NextYear, y Between. Según el tipo de filtro elegido, pasa uno o dos valores DateTime (para Between, pasa las fechas de inicio y fin).

El siguiente ejemplo carga un libro de trabajo con una tabla dinámica cuyo área de filas contiene un campo de fecha, aplica un filtro de fecha que limita los elementos visibles a un rango de fechas particular, actualiza la tabla dinámica y guarda el libro de trabajo.

import java.io.File;
import java.io.FileNotFoundException;

String inputPath = "sample.xlsx";
String outputPath = "output_filtered.xlsx";

if (!new File(inputPath).exists())
{
    throw new FileNotFoundException("Source workbook not found: " + inputPath);
}

// Cargar el libro existente que contiene la tabla dinámica
Workbook workbook = new Workbook(inputPath);

// Acceder a la hoja de cálculo que contiene la tabla dinámica (por índice)
Worksheet worksheet = workbook.getWorksheets().get(0);

// Acceder a la tabla dinámica por índice
PivotTable pivotTable = worksheet.getPivotTables().get(0);

// Recuperar el PivotField de fecha del área de filas
// (El filtro de fecha solo funciona cuando el área de filas/columnas contiene solo celdas de fecha-hora o están vacías)
PivotField dateField = pivotTable.getRowFields().get(0);

// Definir el criterio de fecha para el filtro Entre
DateTime startDate = new DateTime(2020, 1, 1);
DateTime endDate = new DateTime(2020, 12, 31);

// Aplicar el filtro de fecha en el campo dinámico
dateField.filterByDate(PivotFilterType.DATE_BETWEEN, startDate, endDate);

// Actualizar y recalcular la tabla dinámica para que el filtro surta efecto
pivotTable.refreshData();

// Guardar el libro
workbook.save(outputPath);

Filtro de Valor

Los filtros de valor operan sobre los valores agregados que una tabla dinámica calcula en su área de datos. En lugar de coincidir con etiquetas de texto, comparan totales numéricos con un umbral. Los casos de uso típicos incluyen mostrar solo los productos cuya suma de ventas excede una cantidad objetivo o solo las regiones cuyo conteo de transacciones está dentro de un rango.

Aspose.Cells expone el filtrado de valores a través del método PivotField.filterByValue(PivotField valueField, PivotFilterType filterType, params Object[] values). El parámetro filterType usa valores como ValueGreaterThan, ValueLessThan, ValueBetween, ValueEqual, ValueNotEqual, ValueGreaterThanOrEqual, y ValueLessThanOrEqual. El parámetro valueField especifica qué campo de datos debe evaluarse, y los argumentos finales proporcionan el valor o valores umbral.

El siguiente ejemplo carga un libro de trabajo con una tabla dinámica, aplica un filtro de valor que mantiene solo los elementos cuyas ventas agregadas exceden un umbral numérico, actualiza la tabla dinámica y guarda el libro de trabajo.

import com.aspose.cells.*;

Workbook workbook = new Workbook("sample.xlsx");
Worksheet worksheet = workbook.getWorksheets().get(0);
PivotTable pivotTable = worksheet.getPivotTables().get(0);

PivotField rowField = pivotTable.getRowFields().get(0);
PivotField dataField = pivotTable.getDataFields().get(0);

// Encontrar el índice del campo de datos manualmente ya que PivotFieldCollection no tiene IndexOf
int dataFieldIndex = -1;
for (int i = 0; i < pivotTable.getDataFields().getCount(); i++)
{
    if (pivotTable.getDataFields().get(i) == dataField)
    {
        dataFieldIndex = i;
        break;
    }
}

if (dataFieldIndex >= 0)
{
    rowField.filterByValue(dataFieldIndex, PivotFilterType.VALUE_GREATER_THAN, 5000, Double.MAX_VALUE);
}

pivotTable.refreshData();

workbook.save("output.xlsx");

Filtro Top 10

El filtro top 10 es una forma especializada de filtro de valor que retiene solo los N elementos superiores o inferiores basados en un campo de valor elegido. Se usa comúnmente para informes de clasificación como “los 10 mejores productos por ingresos” o “las 5 regiones inferiores por conteo de ventas”.

El filtro top 10 solo es efectivo cuando la tabla dinámica tiene uno o más campos de valor en el área de datos. Sin al menos un campo de valor, no hay ninguna medida agregada contra la cual clasificar los elementos, y el filtro no se puede aplicar.

Aspose.Cells expone el filtrado top 10 a través del método PivotField.filterTop10(int itemCount, boolean isTop, PivotField valueField, PivotFilterType filterType). El parámetro itemCount define cuántos elementos retener, isTop indica si se deben mantener los elementos superiores (true) o los elementos inferiores (false), valueField hace referencia al campo de datos usado para la clasificación, y filterType controla cómo se calcula el valor (típicamente Sum, pero también Count y Percent).

El siguiente ejemplo carga un libro de trabajo con una tabla dinámica que contiene un campo de valor, aplica un filtro top 10 para mantener solo los 10 elementos superiores por la suma de ventas, actualiza la tabla dinámica y guarda el libro de trabajo.

import com.aspose.cells.*;

// Cargar el libro existente que contiene la tabla dinámica
String inputPath = "input.xlsx";
String outputPath = "output.xlsx";
Workbook workbook = new Workbook(inputPath);

// Acceder a la hoja de cálculo que contiene la tabla dinámica (índice 0)
Worksheet worksheet = workbook.getWorksheets().get(0);

// Acceder a la tabla dinámica por índice
PivotTable pivotTable = worksheet.getPivotTables().get(0);

// Confirmar que hay al menos un PivotField de valor en el área de datos
if (pivotTable.getDataFields().getCount() == 0)
{
    throw new RuntimeException("Pivot table has no value (data) PivotField.");
}
PivotField valueField = pivotTable.getDataFields().get(0);

// Obtener el PivotField de fila objetivo (el campo al que queremos aplicar Top 10)
PivotField rowField = pivotTable.getRowFields().get(0);

// El primer (y único) campo de datos está en el índice 0; Top 10 clasifica por él.
int valueFieldIndex = 0;

// Aplicar el filtro Top 10 en el campo de fila:
//   - itemCount   = 10
//   - filterType  = PivotFilterType.SUM
//   - isTop       = true (top N; false significaría bottom N)
//   - valueFieldIndex = el índice del campo de datos utilizado para clasificar elementos
rowField.filterTop10(10, PivotFilterType.SUM, true, valueFieldIndex);

// Actualizar los datos de la tabla dinámica y recalcularla para que el filtro surta efecto
pivotTable.refreshData();

// Guardar el libro
workbook.save(outputPath);

Filtrar Ocultando o Mostrando Elementos de la Tabla Dinámica

Además de las API de filtrado estructurado, Aspose.Cells le permite controlar la visibilidad de cada elemento individual de la tabla dinámica directamente. Al iterar a través de la colección PivotItems de un PivotField y alternar la propiedad IsHidden, puede suprimir selectivamente elementos específicos sin aplicar un filtro basado en fórmulas. Establecer IsHidden = true oculta el elemento de la tabla dinámica; establecer IsHidden = false lo muestra y lo hace visible nuevamente.

Este enfoque es útil cuando la regla de filtrado es irregular o específica del elemento, como ocultar un pequeño número de categorías nombradas que no deben aparecer en un informe particular. El ejemplo a continuación carga una tabla dinámica, oculta un elemento específico por nombre, demuestra cómo mostrarlo, actualiza la tabla dinámica y guarda el libro de trabajo.

import com.aspose.cells.*;

// Cargar un libro existente que contiene una tabla dinámica
Workbook workbook = new Workbook("pivot_table_sample.xlsx");

// Acceder a la primera hoja de cálculo que contiene la tabla dinámica
Worksheet sheet = workbook.getWorksheets().get(0);

// Acceder a la tabla dinámica por índice (la primera tabla dinámica en la hoja)
PivotTable pivotTable = sheet.getPivotTables().get(0);

// Recuperar el PivotField objetivo (el primer campo de etiqueta de fila en el que ocultaremos/mostraremos elementos)
PivotField pivotField = pivotTable.getRowFields().get(0);

// Iterar a través de la colección PivotItems del PivotField seleccionado
int itemCount = pivotField.getPivotItems().getCount();
for (int i = 0; i < itemCount; i++)
{
    PivotItem item = pivotField.getPivotItems().get(i);

    // Ocultar elementos dinámicos que coincidan con un nombre/criterio específico
    if (item.getName() == "Item1" || item.getName() == "Item2")
    {
        item.setHidden(true);
    }

    // Demostrar cómo mostrar: volver a mostrar un elemento dinámico previamente ocultado
    if (item.getName() == "Item3")
    {
        item.setHidden(false);
    }
}

// Refrescar y recalcular la tabla dinámica para que los cambios surtan efecto
pivotTable.refreshData();

// Guardar el libro: los elementos ocultos permanecen en los datos subyacentes
// pero se excluyen de la salida mostrada de la tabla dinámica
workbook.save("output_pivot_filtered.xlsx");

Resumen

Aspose.Cells for Java ofrece un conjunto completo de capacidades de filtrado de tablas dinámicas que coinciden con las que se encuentran en Microsoft Excel. Los filtros de etiqueta, fecha y valor cubren los escenarios analíticos más comunes, mientras que el filtro top 10 maneja los informes de clasificación. Cuando la regla de filtrado es irregular, la propiedad PivotItem.IsHidden ofrece una alternativa flexible a nivel de elemento. Combinar estas estrategias — por ejemplo, aplicar un filtro de etiqueta y luego ocultar elementos específicos — le permite construir informes de tablas dinámicas precisamente dirigidos completamente desde código.

Java: Orden personalizado en la tabla dinámica

Mon, 01 Jan 0001 00:00:00 +0000

Orden personalizado en la tabla dinámica

Al utilizar la API de Aspose.Cells, puede ordenar las tablas dinámicas según los valores del campo. El siguiente fragmento de código carga el archivo de Excel de muestra y agrega tres tablas dinámicas. La primera tabla dinámica está sin orden personalizado, la segunda tabla dinámica está ordenada en los valores del campo de la fila “Frutos de Mar” y la tercera tabla dinámica está ordenada en los valores del campo de la columna “28/07/2000”.

El archivo fuente de ejemplo y los archivos de salida se pueden descargar desde aquí para probar el código de ejemplo:

Archivo de Excel Fuente

Archivo de Excel de Salida

Archivo de PDF de Salida

Java: Especificar la posición absoluta del ítem de tabla dinámica

Mon, 01 Jan 0001 00:00:00 +0000

A veces, el usuario necesita especificar la posición absoluta de los ítems de tabla dinámica, la API de Aspose.Cells ha expuesto algunas nuevas propiedades y un método para cumplir con este requisito del usuario.

Se agregó la propiedad PivotItem.setPosition() que se puede usar para especificar el índice de posición en todos los PivotItems independientemente del nodo padre. Se agregó la propiedad PivotItem.setPositionInSameParentNode() que se puede utilizar para especificar el índice de posición en los PivotItems bajo el mismo nodo padre.
Se agregó el método PivotItem.move(int count, boolean isSameParent) para mover el ítem hacia arriba o hacia abajo en función del valor del contador, donde el contador es el número de posiciones para mover el PivotItem hacia arriba o hacia abajo. Si el valor del contador es menor que cero, el ítem se moverá hacia arriba, mientras que si el valor del contador es mayor que cero, el PivotItem se moverá hacia abajo, el parámetro de tipo Boolean isSameParent especifica si la operación de movimiento debe realizarse en el mismo nodo padre o no.
Se ha vuelto obsoleto el método PivotItem.move(int count), por lo tanto, se sugiere usar el nuevo método PivotItem.move(int count, boolean isSameParent) en su lugar.

Tenga en cuenta que es necesario llamar a los métodos PivotTable.refreshData y PivotTable.calculateData antes de usar las propiedades PivotItem.setPosition(), PivotItem.setPositionInSameParentNode() y PivotItem.move(int count, boolean isSameParent).

Código de Muestra

El siguiente código de muestra crea una tabla dinámica y luego especifica las posiciones de los ítems de tabla dinámica en el mismo nodo padre.

Java: Agrupar campos de pivote en la tabla dinámica

Mon, 01 Jan 0001 00:00:00 +0000

Escenarios de uso posibles

Microsoft Excel te permite agrupar campos de pivote de la tabla dinámica. Cuando hay una gran cantidad de datos relacionados con un campo de pivote, a menudo es útil agruparlos en secciones. Aspose.Cells también proporciona esta función mediante el método PivotTable.setManualGroupField().

Agrupar campos de la tabla dinámica

El siguiente código de muestra carga el archivo de Excel de ejemplo y realiza la agrupación en el primer campo de pivote utilizando el método PivotTable.setManualGroupField(). Luego actualiza y calcula los datos de la tabla dinámica y guarda el libro de trabajo como el archivo de Excel de salida. La captura de pantalla muestra el efecto del código de ejemplo en el archivo de Excel de muestra. Como se puede ver en la captura de pantalla, el primer campo de pivote ahora está agrupado por meses y trimestres.

Código de muestra

Java: Ocultar y ordenar datos de la tabla dinámica

Mon, 01 Jan 0001 00:00:00 +0000

Ocultar y ordenar datos de la tabla dinámica

Aspose.Cells admite ocultar y ordenar datos en la tabla dinámica. El siguiente fragmento de código demuestra esta característica ordenando la columna de Puntuación en orden descendente y luego ocultando las filas con una puntuación inferior a 60.

Se adjuntan los archivos de Excel de origen y de salida utilizados en el fragmento de código como referencia.

Archivo de origen

Archivo de salida

Java: Borrar filtro en tabla dinámica

Mon, 01 Jan 0001 00:00:00 +0000

Escenarios de uso posibles

Cuando creas una tabla dinámica con datos conocidos y quieres filtrar la tabla dinámica, necesitas aprender y usar filtro. Puede ayudarte a filtrar efectivamente los datos que deseas. Al utilizar la API de Aspose.Cells, puedes operar el filtro en los valores de campo en las Tablas Dinámicas.

Limpiar filtro en Tabla Dinámica en Excel

Limpiar filtro en Tabla Dinámica en Excel, sigue estos pasos:

Selecciona la Tabla Dinámica de la que deseas eliminar el filtro.
Haz clic en la flecha desplegable para el filtro que deseas borrar en la tabla dinámica.
Selecciona “Limpiar filtro” en el menú desplegable.
Si deseas borrar todos los filtros de la tabla dinámica, también puedes hacer clic en el botón “Limpiar filtros” en la pestaña Analizar tabla dinámica en la cinta de Excel.

Limpiar filtro en Tabla Dinámica

Consulta el siguiente código de ejemplo. Establece los datos y crea una Tabla Dinámica basada en ello. Luego agrega un filtro en el campo de fila de la tabla dinámica. Finalmente, guarda el libro en formato XLSX de salida. Después de ejecutar el código de ejemplo, se añade un filtro top10 a la hoja de cálculo. Después de agregar un filtro, cuando necesitamos datos sin filtrar, podemos borrar el filtro en un campo de tabla dinámica específico. Después de ejecutar el código para borrar el filtro, este se eliminará en el campo de tabla dinámica específico. Consulta el XLSX de salida.

Código de muestra

Java: Filtro dinámico

Mon, 01 Jan 0001 00:00:00 +0000

Escenarios de uso posibles

Cuando creas una tabla dinámica con datos conocidos y deseas filtrar la tabla dinámica, necesitas aprender y usar el filtro. Puede ayudarte a filtrar eficazmente los datos que deseas. Usando la API de Aspose.Cells Java, puedes agregar un filtro en los valores de campo en Tablas Dinámicas.

Agregar filtro en tabla dinámica en Excel

Agregar filtro en tabla dinámica en Excel, sigue estos pasos:

Selecciona la Tabla Dinámica de la que deseas eliminar el filtro.
Haz clic en la flecha desplegable del filtro que deseas agregar en la tabla dinámica.
Selecciona “Los 10 principales” en el menú desplegable.
Establece el modo de exhibición y el número de filtros.

Agregar filtro en tabla dinámica

Por favor, vea el siguiente código de muestra. Establece los datos y crea una Tabla Dinámica basada en ellos. Luego añade un filtro en el campo de fila de la tabla dinámica. Finalmente, guarda el libro de trabajo en formato XLSX de salida. Después de ejecutar el código de ejemplo, se agrega una tabla dinámica con filtro top10 a la hoja de cálculo.

Código de muestra

Borrar filtro en tabla dinámica en Excel

Limpiar filtro en Tabla Dinámica en Excel, sigue estos pasos:

Selecciona la Tabla Dinámica de la que deseas eliminar el filtro.
Haz clic en la flecha desplegable para el filtro que deseas borrar en la tabla dinámica.
Selecciona “Limpiar filtro” en el menú desplegable.
Si deseas borrar todos los filtros de la tabla dinámica, también puedes hacer clic en el botón “Limpiar filtros” en la pestaña Analizar tabla dinámica en la cinta de Excel.

Borrar filtro en tabla dinámica

Código de muestra

Java: Obtener el objeto Celda por el Nombre de Visualización del Campo de Tabla Dinámica de la Tabla Dinámica

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells proporciona el método PivotTable.getCellByDisplayName() que puede usar para acceder al objeto de celda por el nombre de pantalla del campo pivote. Este método es útil cuando desea resaltar o dar formato a su encabezado del campo pivote. Este artículo explica cómo recuperar el objeto de celda por el nombre de pantalla del campo de datos y luego aplicar formato a este.

Obtener el objeto Celda por el Nombre de Visualización del Campo de Tabla Dinámica de la Tabla Dinámica

El siguiente código accede a la primera tabla dinámica de la hoja de cálculo y luego obtiene la celda por el nombre de visualización del segundo campo de datos de la tabla dinámica. Luego cambia el color de relleno y el color de fuente de la celda a azul claro y negro respectivamente. A continuación se muestran capturas de pantalla de cómo se ve la tabla dinámica antes y después de la ejecución del código.

Documentation – Agregar campos de fila y columna a una tabla dinámica en Aspose.Cells para .NET

Java: Filtrar Tablas Dinámicas por Etiqueta o Valor

Introducción

Filtro de Etiqueta

Filtro de Fecha

Filtro de Valor

Filtro Top 10

Filtrar Ocultando o Mostrando Elementos de la Tabla Dinámica

Resumen

Java: Orden personalizado en la tabla dinámica

Orden personalizado en la tabla dinámica

Java: Especificar la posición absoluta del ítem de tabla dinámica

Código de Muestra

Java: Agrupar campos de pivote en la tabla dinámica

Escenarios de uso posibles

Agrupar campos de la tabla dinámica

Código de muestra

Java: Ocultar y ordenar datos de la tabla dinámica

Ocultar y ordenar datos de la tabla dinámica

Java: Borrar filtro en tabla dinámica

Escenarios de uso posibles

Limpiar filtro en Tabla Dinámica en Excel

Limpiar filtro en Tabla Dinámica

Código de muestra

Java: Filtro dinámico

Escenarios de uso posibles

Agregar filtro en tabla dinámica en Excel

Agregar filtro en tabla dinámica

Código de muestra

Borrar filtro en tabla dinámica en Excel

Borrar filtro en tabla dinámica

Código de muestra

Java: Obtener el objeto Celda por el Nombre de Visualización del Campo de Tabla Dinámica de la Tabla Dinámica

Obtener el objeto Celda por el Nombre de Visualización del Campo de Tabla Dinámica de la Tabla Dinámica

Tabla Dinámica - Antes

Tabla Dinámica - Después