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

Pythonnet: 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 etiquetas a campos de fila o columna basados en texto, usar filtros de fecha cuando el campo contenga únicamente celdas de tipo fecha-hora o vacías, aplicar filtros de valores contra números agregados, usar filtros de los 10 mejores para clasificar por un campo de valor, u ocultar y mostrar manualmente elementos individuales de la tabla dinámica mediante la propiedad is_hidden. Cada estrategia se expone a través de APIs dedicadas en las clases PivotField y PivotItem.

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:

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 tipo fecha-hora (o espacios en blanco).
Filtro de valor — filtra elementos basándose en los valores agregados de un campo de datos.
Filtro de los 10 mejores — muestra únicamente 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 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.

El filtro de fecha solo funciona cuando el área de fila o columna contiene únicamente celdas de tipo 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 tenga formato de fecha y de que todos los valores sean instancias válidas de DateTime o celdas vacías antes de aplicar este filtro.

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”.

El filtro de los 10 mejores 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 existe ninguna medida agregada contra la cual clasificar los elementos y el filtro no puede aplicarse.

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.

Pythonnet: 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 para Python via .NET proporciona el método PivotTable.get_cell_by_display_name(display_name) que puedes utilizar para acceder al objeto de celda por el nombre de visualización del campo de la tabla dinámica. Este método es útil cuando deseas resaltar o dar formato al encabezado del campo de tabla dinámica. Este artículo explica cómo recuperar el objeto de celda por el nombre de visualización del campo de datos y luego aplicar formato a la misma.

Cómo obtener el objeto de celda por DisplayName de PivotField de PivotTable

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. Las capturas de pantalla siguientes muestran cómo se ve la tabla dinámica antes y después de la ejecución del código.

Tabla Dinámica - Antes

Tabla Dinámica - Después

Pythonnet: 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 tabla dinámica de la tabla dinámica. Cuando hay una gran cantidad de datos relacionados con un campo de tabla dinámica, a menudo es útil agruparlos en secciones. Aspose.Cells para Python via .NET también proporciona esta función mediante el método PivotTable.set_manual_group_field().

Cómo agrupar campos de tabla dinámica en la tabla dinámica

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

Código de muestra

Pythonnet: 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 usando la biblioteca de Python Aspose.Cells para Excel

Aspose.Cells para Python via .NET admite ocultar y ordenar datos en la tabla dinámica. El siguiente fragmento de código demuestra esta funcionalidad al ordenar la columna de Puntuación en orden descendente y luego ocultar las filas con una puntuación menor 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

Pythonnet: Agregar filtro en tabla dinámica

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

Escenarios de uso posibles

Cuando crea una tabla dinámica con datos conocidos y desea filtrar la tabla dinámica, es necesario aprender y utilizar el filtro. Puede ayudarlo a filtrar los datos que desea de manera efectiva. Al usar la API de Aspose.Cells para Python via .NET, puede agregar un filtro en los valores del campo en las tablas dinámicas.

Agregar filtro en tabla dinámica usando la biblioteca Aspose.Cells para Excel Python

Por favor, consulta el siguiente código de ejemplo. 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 añade una tabla dinámica con filtro top10 a la hoja de cálculo.

Código de muestra

Pythonnet: 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 utilizar el filtro. Puede ayudarte a filtrar los datos que quieres de manera efectiva. Al usar la API de Aspose.Cells para Python via .NET, puedes operar el filtro en los valores del campo en las Tablas Dinámicas.

Cómo borrar el filtro en una 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.

Cómo borrar el filtro en tabla dinámica utilizando la biblioteca Aspose.Cells para Python Excel

Borrar filtro en tabla dinámica utilizando Aspose.Cells para Python via .NET. Por favor, consulta el siguiente código de muestra.

Establece los datos y crea una tabla dinámica basada en ellos.
Agrega un filtro en el campo de fila de la tabla dinámica.
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.
Elimina el filtro en un campo de la tabla dinámica específico. Después de ejecutar el código para eliminar el filtro, se eliminará el filtro en el campo de la tabla dinámica específico. Por favor, revisa el XLSX de salida.

Código de muestra

Pythonnet: Orden personalizado en la tabla dinámica

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

Cómo establecer una clasificación personalizada en la tabla dinámica utilizando Aspose.Cells para la biblioteca de Excel de Python

Al usar la API de Aspose.Cells para Python via .NET, 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 clasificación personalizada, la segunda tabla dinámica está ordenada en los valores del campo de fila “SeaFood” y la tercera tabla dinámica está ordenada en los valores del campo de 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