Filtrar tablas dinámicas por etiqueta o valor

Introducción

Las tablas dinámicas son potentes herramientas analíticas, pero los resúmenes sin procesar suelen contener 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 Python via .NET replica las capacidades de filtrado disponibles en Microsoft Excel, exponiéndolas mediante programación para que la generación de informes pueda automatizarse por completo.

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

  1. Filtro de etiqueta — filtra los elementos de un campo de fila o columna basándose en sus etiquetas de texto.
  2. Filtro de fecha — filtra campos de fila o columna que contienen únicamente valores de tipo fecha-hora (o espacios en blanco).
  3. Filtro de valor — filtra elementos basándose en los valores agregados de un campo de datos.
  4. Filtro de los 10 mejores — muestra únicamente los N elementos superiores o inferiores clasificados por un campo de valor.
  5. 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 refresh_data() y calculate_data() 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 permite filtrar los elementos de un campo de fila o columna comparando sus textos de etiqueta con un patrón. Esto resulta útil cuando desea mostrar únicamente los productos cuyos nombres comiencen con una letra específica, contengan una palabra particular, o cumplan con cualquier otro criterio basado en la etiqueta.

Aspose.Cells expone el filtrado por etiquetas mediante el método PivotField.filter_by_label(PivotFilterType, label_string). La enumeración PivotFilterType incluye valores tales como CaptionBeginsWith, CaptionContains, CaptionEndsWith, CaptionDoesNotContain, CaptionIsNotBlank, CaptionIsBlank, entre otros. El segundo argumento proporciona la cadena de etiqueta utilizada para la comparación.

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

import aspose.cells as ac

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

# Cargar el libro existente que contiene una tabla dinámica
workbook = ac.Workbook(fileName)

# Acceder a la hoja de cálculo por índice (primera hoja)
worksheet = workbook.worksheets[0]

# Acceder a la tabla dinámica por índice
pivot_table = worksheet.pivot_tables[0]

# Obtener el primer PivotField de fila
row_field = pivot_table.row_fields[0]

# Aplicar el filtro de etiqueta: mostrar solo los elementos de fila cuyas etiquetas comiencen con el prefijo proporcionado
row_field.filter_by_label(ac.PivotFilterType.CAPTION_BEGINS_WITH, prefix, "")

# Actualizar y recalcular los datos de la tabla dinámica para que el filtro surta efecto
pivot_table.pivot_cache.refresh()

# Guardar el libro de nuevo en disco
workbook.save(fileName)

Filtro de fecha

Los filtros de fecha permiten reducir una tabla dinámica según 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 únicamente contra campos que almacenan información de tipo fecha-hora.

Aspose.Cells expone el filtrado por fechas mediante el método PivotField.filter_by_date(PivotFilterType, *date_times). 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. Dependiendo del tipo de filtro elegido, se pasan uno o dos valores DateTime (para Between, se pasan las fechas de inicio y fin).

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

from datetime import datetime

input_path = "sample.xlsx"
output_path = "output_filtered.xlsx"

if not os.path.exists(input_path):
    raise FileNotFoundError("Source workbook not found.", input_path)

# Cargar el libro existente que contiene la tabla dinámica
workbook = ac.Workbook(input_path)

# Acceder a la hoja de cálculo que contiene la tabla dinámica (por índice)
worksheet = workbook.worksheets[0]

# Acceder a la tabla dinámica por índice
pivot_table = worksheet.pivot_tables[0]

# Obtener 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)
date_field = pivot_table.row_fields[0]

# Definir el criterio de fecha para el filtro Entre
start_date = datetime(2020, 1, 1)
end_date = datetime(2020, 12, 31)

# Aplicar el filtro de fecha en el campo dinámico
date_field.filter_by_date(ac.PivotFilterType.DATE_BETWEEN, start_date, end_date)

# Refrescar y recalcular la tabla dinámica para que el filtro surta efecto
pivot_table.pivot_cache.refresh()

# Guardar el libro
workbook.save(output_path)

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 únicamente los productos cuya suma de ventas supere un monto objetivo o solo las regiones cuyo recuento de transacciones se encuentre dentro de un rango.

Aspose.Cells expone el filtrado por valores mediante el método PivotField.filter_by_value(value_field, PivotFilterType, *thresholds). El parámetro PivotFilterType utiliza valores como ValueGreaterThan, ValueLessThan, ValueBetween, ValueEqual, ValueNotEqual, ValueGreaterThanOrEqual, y ValueLessThanOrEqual. El parámetro value_field especifica qué campo de datos debe evaluarse, y el último argumento (o argumentos) proporciona los valores umbral.

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

import aspose.cells as ac

workbook = ac.Workbook("sample.xlsx")
worksheet = workbook.worksheets[0]
pivot_table = worksheet.pivot_tables[0]

row_field = pivot_table.row_fields[0]
data_field = pivot_table.data_fields[0]

# Buscar el índice del campo de datos manualmente ya que PivotFieldCollection no tiene IndexOf
data_field_index = -1
for i in range(pivot_table.data_fields.count):
    if pivot_table.data_fields[i] == data_field:
        data_field_index = i
        break

if data_field_index >= 0:
    row_field.filter_by_value(data_field_index, ac.PivotFilterType.VALUE_GREATER_THAN, 5000, float('inf'))

pivot_table.pivot_cache.refresh()

workbook.save("output.xlsx")

Filtro de los 10 mejores

El filtro de los 10 mejores es una forma especializada de filtro de valor que retiene únicamente los N elementos más altos o más bajos basándose en un campo de valor elegido. Se usa comúnmente para informes de clasificación como “los 10 productos principales por ingresos” o “las 5 regiones inferiores por recuento de ventas”.

Aspose.Cells expone el filtrado de los 10 mejores mediante el método PivotField.filter_top_10(item_count, is_top, value_field, PivotFilterType). El parámetro item_count define cuántos elementos se deben retener, is_top indica si se conservan los elementos superiores (True) o los inferiores (False), value_field hace referencia al campo de datos utilizado para la clasificación, y PivotFilterType controla cómo se calcula el valor (normalmente Sum, pero también Count y Percent).

El siguiente ejemplo carga un libro con una tabla dinámica que contiene un campo de valor, aplica un filtro de los 10 mejores para conservar solo los 10 elementos más altos por la suma de ventas, actualiza la tabla dinámica y guarda el libro.

import aspose.cells as ac
import aspose.cells.pivot as acp

# Cargar el libro existente que contiene la tabla dinámica
inputPath = "input.xlsx"
outputPath = "output.xlsx"
workbook = ac.Workbook(inputPath)

# Acceder a la hoja de cálculo que contiene la tabla dinámica (índice 0)
worksheet = workbook.worksheets[0]

# Acceder a la tabla dinámica por índice
pivotTable = worksheet.pivot_tables[0]

# Confirmar que hay al menos un PivotField de valor en el área de datos
if pivotTable.data_fields.count == 0:
    raise Exception("La tabla dinámica no tiene PivotField de valor (datos).")
valueField = pivotTable.data_fields[0]

# Obtener el PivotField de fila objetivo (el campo al que aplicaremos Top 10)
rowField = pivotTable.row_fields[0]

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

# Aplicar el filtro Top 10 en el campo de fila:
#   - itemCount   = 10
#   - filterType  = PivotFilterType.Sum
#   - isTop       = true (N superiores; false significaría N inferiores)
#   - valueFieldIndex = el índice del campo de datos utilizado para clasificar los elementos
rowField.filter_top10(10, acp.PivotFilterType.Sum, True, valueFieldIndex)

# Actualizar los datos de la tabla dinámica y recalcularla para que el filtro surta efecto
pivotTable.pivot_cache.refresh()

# Guardar el libro
workbook.save(outputPath)

Filtrar ocultando o mostrando elementos de la tabla dinámica

Además de las APIs estructuradas de filtrado, Aspose.Cells permite controlar directamente la visibilidad de cada elemento individual de la tabla dinámica. Mediante la iteración a través de la colección PivotItems de un PivotField y alternando la propiedad is_hidden, puede suprimir selectivamente elementos específicos sin aplicar un filtro basado en fórmulas. Establecer is_hidden = True oculta el elemento de la tabla dinámica; establecer is_hidden = False lo muestra nuevamente y lo hace visible.

Este enfoque resulta ú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 siguiente carga una tabla dinámica, oculta un elemento específico por nombre, muestra cómo volver a mostrarlo, actualiza la tabla dinámica y guarda el libro.

import aspose.cells as ac

# Cargar un libro de trabajo existente que contenga una tabla dinámica
workbook = ac.Workbook("pivot_table_sample.xlsx")

# Acceder a la primera hoja de cálculo que contiene la tabla dinámica
sheet = workbook.worksheets[0]

# Acceder a la tabla dinámica por índice (la primera tabla dinámica en la hoja)
pivot_table = sheet.pivot_tables[0]

# Recuperar el PivotField objetivo (el primer campo de etiqueta de fila donde ocultaremos/mostraremos elementos)
pivot_field = pivot_table.row_fields[0]

# Iterar a través de la colección PivotItems del PivotField seleccionado
item_count = pivot_field.pivot_items.count
for i in range(item_count):
    item = pivot_field.pivot_items[i]

    # Ocultar elementos dinámicos que coincidan con un nombre/criterio específico
    if item.name == "Item1" or item.name == "Item2":
        item.is_hidden = True

    # Demostrar cómo mostrar: volver a mostrar un elemento dinámico previamente oculto
    if item.name == "Item3":
        item.is_hidden = False

# Actualizar y recalcular la tabla dinámica para que los cambios surtan efecto
pivot_table.pivot_cache.refresh()

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

Resumen

Aspose.Cells for Python via .NET ofrece un conjunto completo de capacidades de filtrado para tablas dinámicas que se corresponden con las disponibles en Microsoft Excel. Los filtros de etiqueta, fecha y valor cubren los escenarios analíticos más comunes, mientras que el filtro de los 10 mejores gestiona los informes de clasificación. Cuando la regla de filtrado es irregular, la propiedad PivotItem.is_hidden ofrece un respaldo 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 tabla dinámica altamente precisos completamente desde código.

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