PivotTable clase

PivotTable clase

Descripción resumida para PivotTable.

El tipo PivotTable expone los siguientes miembros:

Propiedades

PropiedadDescripción
is_excel_2003_compatibleEspecifica si la tabla dinámica es compatible con Excel2003 al actualizar la tabla dinámica.
Si es verdadero, una cadena debe ser menor o igual a 255 caracteres, por lo que si la cadena es mayor a 255 caracteres,
se truncará. Si es falso, una cadena no tendrá la restricción antes mencionada.
El valor predeterminado es verdadero.
refreshed_by_whoObtiene el nombre del último usuario que actualizó esta tabla dinámica
refresh_dateObtiene la última fecha y hora en que se actualizó la tabla dinámica.
pivot_table_style_nameObtiene y establece el nombre del estilo de tabla dinámica.
pivot_table_style_typeObtiene y establece el estilo de tabla dinámica incorporado.
column_fieldsDevuelve un objeto PivotFields que actualmente se muestra como campos de columna.
row_fieldsDevuelve un objeto PivotFields que actualmente se muestra como campos de fila.
page_fieldsDevuelve un objeto PivotFields que actualmente se muestra como campos de página.
data_fieldsObtiene un objeto PivotField que representa todos los campos de datos en una tabla dinámica.
Solo lectura. Se inicializará solo cuando haya dos o más campos de datos en DataPiovtFiels.
Solo se utiliza para agregar un DataPivotField al área de filas/columnas de la tabla dinámica. El valor predeterminado es en el área de filas.
data_fieldObtiene un objeto PivotField que representa todos los campos de datos en una tabla dinámica.
Sólo lectura.
Solo se creará cuando haya dos o más campos de datos en la región de datos.
Por defecto, se encuentra en la región de filas. Puede arrastrarlo a la región de filas/columnas con el método PivotTable.AddFieldToArea().
base_fieldsDevuelve todos los campos dinámicos base en la tabla dinámica.
pivot_filtersDevuelve todos los filtros de los campos dinámicos en la tabla dinámica.
column_rangeDevuelve un objeto CellArea que representa el rango
Que contiene el área de columna en el informe de tabla dinámica. Solo lectura.
row_rangeDevuelve un objeto CellArea que representa el rango
Que contiene el área de fila en el informe de tabla dinámica. Solo lectura.
data_body_rangeDevuelve un objeto CellArea que representa el rango que contiene el área de datos
En la lista entre la fila de encabezado y la fila de inserción. Solo lectura.
table_range1Devuelve un objeto CellArea que representa el rango que contiene todo el informe de tabla dinámica.
pero no incluye campos de página. Solo lectura.
table_range2Devuelve un objeto CellArea que representa el rango que contiene todo el informe de tabla dinámica.
Incluye campos de página. Solo lectura.
is_grid_drop_zonesIndica si el informe de tabla dinámica muestra el diseño de tabla dinámica clásico.
(permite arrastrar campos en la cuadrícula)
show_column_grand_totalsIndica si se deben mostrar los totales generales de las columnas de esta tabla dinámica.
show_row_grand_totalsIndica si se deben mostrar los totales generales de las filas de la tabla dinámica.
column_grandIndica si el informe de tabla dinámica muestra totales generales de las columnas.
row_grandIndica si se deben mostrar los totales generales de las filas de esta tabla dinámica.
display_null_stringIndica si el informe de tabla dinámica muestra una cadena personalizada si el valor es nulo.
null_stringObtiene la cadena que se muestra en las celdas que contienen valores nulos
cuando la propiedad DisplayNullString es verdadera. El valor predeterminado es una cadena vacía.
display_error_stringIndica si el informe de tabla dinámica muestra una cadena personalizada en las celdas que contienen errores.
data_field_header_nameObtiene y establece el nombre del encabezado del campo del área de valor en la tabla dinámica.
error_stringObtiene la cadena que se muestra en las celdas que contienen errores.
cuando la propiedad DisplayErrorString es verdadera. El valor predeterminado es una cadena vacía.
is_auto_formatIndica si el informe de tabla dinámica se formatea automáticamente.
Casilla de verificación “Autoformato de tabla” que se encuentra en la opción de tabla dinámica de Excel 2003
autofit_column_width_on_updateIndica si se ajusta automáticamente el ancho de la columna al actualizar
auto_format_typeObtiene y establece el tipo de formato automático de la tabla dinámica.
has_blank_rowsIndica si se deben agregar filas en blanco.
Esta propiedad solo se aplica a los tipos de formato automático de tabla dinámica que necesitan agregar filas en blanco.
merge_labelsVerdadero si las etiquetas de elemento de fila exterior, elemento de columna, subtotal y total general del informe de tabla dinámica especificado utilizan celdas combinadas.
preserve_formattingIndica si se conserva el formato cuando se actualiza o se recalcula la tabla dinámica.
show_drillObtiene y establece si se muestran los botones expandir/contraer.
enable_drilldownObtiene si la exploración en profundidad está habilitada.
enable_field_dialogIndica si el cuadro de diálogo Campo de tabla dinámica está disponible
cuando el usuario hace doble clic en el campo de tabla dinámica.
enable_field_listIndica si la lista de campos de la tabla dinámica está disponible en la vista de Excel.
enable_wizardIndica si el Asistente para tablas dinámicas está disponible.
subtotal_hidden_page_itemsIndica si hay elementos de campos de página ocultos en el informe de tabla dinámica
se incluyen en los subtotales de filas y columnas, los totales de bloque y los totales generales.
El valor predeterminado es Falso.
grand_total_nameDevuelve la etiqueta que se muestra en el encabezado de fila o columna de total general.
El valor predeterminado es la cadena “Total general”.
manual_updateIndica si el informe de tabla dinámica se recalcula solo a solicitud del usuario.
is_multiple_field_filtersEspecifica un valor booleano que indica si los campos de una tabla dinámica pueden tener múltiples filtros establecidos en ellos.
allow_multiple_filters_per_fieldEspecifica un valor booleano que indica si los campos de una tabla dinámica pueden tener múltiples filtros establecidos en ellos.
missing_items_limitEspecifica un valor booleano que indica si los campos de una tabla dinámica pueden tener múltiples filtros establecidos en ellos.
enable_data_value_editingEspecifica un valor booleano que indica si el usuario puede editar las celdas en el área de datos de la tabla dinámica.
Habilitar la edición de celdas en el área de valores
show_data_tipsEspecifica un valor booleano que indica si se deben mostrar informaciones sobre herramientas para las celdas de datos de la tabla dinámica.
show_member_property_tipsEspecifica un valor booleano que indica si la información de las propiedades de los miembros debe omitirse en la información sobre herramientas de la tabla dinámica.
show_values_rowIndica si se muestran valores en fila.
show_empty_colIndica si se deben incluir columnas vacías en la tabla
show_empty_rowIndica si se deben incluir filas vacías en la tabla.
field_list_sort_ascendingIndica si los campos de la tabla dinámica están ordenados en un orden no predeterminado en la lista de campos.
print_drillEspecifica un valor booleano que indica si se deben imprimir los indicadores de perforación.
Imprimir botones para expandir/contraer cuando se muestran en la tabla dinámica.
alt_text_titleObtiene y establece el título del texto alternativo.
alt_text_descriptionObtiene la descripción del texto alternativo.
nameObtiene el nombre de la tabla dinámica
column_header_captionObtiene el título del encabezado de columna de la tabla dinámica.
indentEspecifica el incremento de sangría para el eje compacto y se puede utilizar para establecer el diseño del informe en formato compacto.
row_header_captionObtiene el título del encabezado de fila de la tabla dinámica.
show_row_header_captionIndica si el título del encabezado de fila se muestra en el informe de tabla dinámica
Indica si se muestran los títulos de los campos y los filtros desplegables
custom_list_sortIndica si se tiene en cuenta la lista personalizada incorporada al ordenar datos
pivot_format_conditionsObtiene las condiciones de formato de la tabla dinámica.
conditional_formatsObtiene los formatos condicionales de la tabla dinámica.
page_field_orderObtiene y establece el orden en que se agregan los campos de página al diseño del informe de tabla dinámica.
page_field_wrap_countObtiene el número de campos de página en cada columna o fila del informe de tabla dinámica.
tagObtiene una cadena guardada con el informe de tabla dinámica.
save_dataIndica si los datos del informe de tabla dinámica se guardan con el libro de trabajo.
refresh_data_on_opening_fileIndica si se deben actualizar los datos al abrir el archivo.
refresh_data_flagIndica si se actualizan los datos o no.
source_typeObtiene el tipo de fuente de datos de la tabla dinámica.
external_connection_data_sourceObtiene la fuente de datos de conexión externa.
data_sourceObtiene y establece la fuente de datos de la tabla dinámica.
pivot_formatsObtiene la colección de formatos aplicados a la tabla dinámica.
item_print_titlesIndica si los nombres de PivotItem deben repetirse en la parte superior de cada página impresa.
repeat_items_on_each_printed_pageIndica si los títulos de los elementos pivote en el área de fila se repiten en cada página impresa para los campos pivote en formato tabular.
print_titlesIndica si los títulos de impresión para la hoja de trabajo se establecen en función
En el informe de tabla dinámica. El valor predeterminado es falso.
display_immediate_itemsIndica si los elementos en las áreas de filas y columnas son visibles
Cuando el área de datos de la tabla dinámica está vacía. El valor predeterminado es “true”.
is_selectedIndica si esta tabla dinámica está seleccionada.
show_pivot_style_row_headerIndica si se debe aplicar el estilo al encabezado de fila de la tabla dinámica.
show_pivot_style_column_headerIndica si se debe aplicar el estilo al encabezado de columna de la tabla dinámica.
show_pivot_style_row_stripesIndica si se aplica el formato de franja de fila.
show_pivot_style_column_stripesIndica si se aplica el formato de banda para la columna.
show_pivot_style_last_columnIndica si se aplica el formato de columna.

Métodos

MétodoDescripción
remove_field(self, field_type, field_name)Elimina un campo de un área de campo específica
remove_field(self, field_type, base_field_index)Elimina un campo de un área de campo específica
remove_field(self, field_type, pivot_field)Eliminar campo de un área de campo específica
add_field_to_area(self, field_type, field_name)Agrega el campo al área específica.
add_field_to_area(self, field_type, base_field_index)Agrega el campo al área específica.
add_field_to_area(self, field_type, pivot_field)Agrega el campo al área específica.
add_calculated_field(self, name, formula, drag_to_data_area)Agrega un campo calculado al campo pivote.
add_calculated_field(self, name, formula)Agrega un campo calculado al campo pivote y lo arrastra al área de datos.
move(self, row, column)Mueve la tabla dinámica a una ubicación diferente en la hoja de cálculo.
move(self, dest_cell_name)Mueve la tabla dinámica a una ubicación diferente en la hoja de cálculo.
move_to(self, row, column)Mueve la tabla dinámica a una ubicación diferente en la hoja de cálculo.
move_to(self, dest_cell_name)Mueve la tabla dinámica a una ubicación diferente en la hoja de cálculo.
get_source(self)Obtener los datos de origen de la tabla dinámica.
get_source(self, is_original)Obtener los datos de origen de la tabla dinámica.
refresh_data(self)Actualiza los datos y la configuración de la tabla dinámica desde su fuente de datos.
refresh_data(self, option)Actualiza los datos y la configuración de la tabla dinámica desde su fuente de datos con opciones.
calculate_data(self)Calcula los datos de la tabla dinámica en celdas.
calculate_data(self, option)Cálculo de tablas dinámicas con opciones
format(self, pivot_area, style)Formatea el área seleccionada de la tabla dinámica.
format(self, ca, style)Formatea el área seleccionada de la tabla dinámica.
format(self, row, column, style)Formatear la celda en el área de la tabla dinámica
set_auto_group_field(self, base_field_index)Establece el grupo de campos automáticos mediante la tabla dinámica.
set_auto_group_field(self, pivot_field)Establece el grupo de campos automáticos mediante la tabla dinámica.
set_manual_group_field(self, base_field_index, start_val, end_val, group_by_list, interval_num)Establece el grupo de campos manualmente mediante la tabla dinámica.
set_manual_group_field(self, pivot_field, start_val, end_val, group_by_list, interval_num)Establece el grupo de campos manualmente mediante la tabla dinámica.
set_manual_group_field(self, base_field_index, start_val, end_val, group_by_list, interval_num)Establece el grupo de campos manualmente mediante la tabla dinámica.
set_manual_group_field(self, pivot_field, start_val, end_val, group_by_list, interval_num)Establece el grupo de campos manualmente mediante la tabla dinámica.
set_ungroup(self, base_field_index)Los conjuntos se desagrupan por la tabla dinámica
set_ungroup(self, pivot_field)Los conjuntos se desagrupan por la tabla dinámica
copy_style(self, pivot_table)Copia el estilo nombrado de otra tabla dinámica.
show_report_filter_page(self, page_field)Mostrar todas las páginas de filtro del informe según PivotField, el PivotField debe estar ubicado en PageFields.
show_report_filter_page_by_name(self, field_name)Mostrar todas las páginas de filtro del informe según el nombre del campo dinámico, el campo dinámico debe estar ubicado en PageFields.
show_report_filter_page_by_index(self, pos_index)Mostrar todas las páginas de filtro de informes según el índice de posición en PageFields
get_fields(self, field_type)Obtiene la lista de campos pivote específicos por región.
fields(self, field_type)Obtiene los campos específicos por tipo de campo.
get_source_data_connections(self)Obtiene las fuentes de datos de conexión externa.
get_names_of_source_data_connections(self)Obtiene el nombre de las conexiones de datos de fuentes externas.
change_data_source(self, source)Establecer los datos de origen de la tabla dinámica.
clear_data(self)Borrar los datos y el formato de la tabla dinámica
calculate_range(self)Calcula el rango de la tabla dinámica.
format_all(self, style)Formatear todas las celdas en el área de la tabla dinámica
format_row(self, row, style)Formatear los datos de fila en el área de la tabla dinámica
select_area(self, ca)Seleccione un área de la vista de tabla dinámica.
show_detail(self, row_offset, column_offset, new_sheet, dest_row, dest_column)Mostrar el detalle de un elemento en la región de datos en una nueva tabla.
get_horizontal_page_breaks(self)Obtiene saltos de página horizontales de esta tabla dinámica.
get_horizontal_breaks(self)Obtiene la lista de índices de filas de la tabla dinámica de saltos de página horizontales
show_in_compact_form(self)Diseña la tabla dinámica en forma compacta.
show_in_outline_form(self)Diseña la tabla dinámica en forma de esquema.
show_in_tabular_form(self)Diseña la tabla dinámica en formato tabular.
get_cell_by_display_name(self, display_name)Obtiene el objeto Cell por el nombre para mostrar de PivotField.
get_children(self)Obtiene las tablas dinámicas secundarias que utilizan estos datos de tabla dinámica como fuente de datos.

Ejemplo

from aspose.cells import FormatConditionType, OperatorType, Workbook
from aspose.cells.pivot import PivotFieldType, PivotFilterType, PivotTableStyleType
from aspose.pydrawing import Color

book = Workbook()
sheet = book.worksheets[0]
cells = sheet.cells
cells.get(0, 0).value = "fruit"
cells.get(1, 0).value = "grape"
cells.get(2, 0).value = "blueberry"
cells.get(3, 0).value = "kiwi"
cells.get(4, 0).value = "cherry"
cells.get(5, 0).value = "grape"
cells.get(6, 0).value = "blueberry"
cells.get(7, 0).value = "kiwi"
cells.get(8, 0).value = "cherry"
cells.get(0, 1).value = "year"
cells.get(1, 1).value = 2020
cells.get(2, 1).value = 2020
cells.get(3, 1).value = 2020
cells.get(4, 1).value = 2020
cells.get(5, 1).value = 2021
cells.get(6, 1).value = 2021
cells.get(7, 1).value = 2021
cells.get(8, 1).value = 2021
cells.get(0, 2).value = "amount"
cells.get(1, 2).value = 50
cells.get(2, 2).value = 60
cells.get(3, 2).value = 70
cells.get(4, 2).value = 80
cells.get(5, 2).value = 90
cells.get(6, 2).value = 100
cells.get(7, 2).value = 110
cells.get(8, 2).value = 120
pivots = sheet.pivot_tables
pivotIndex = pivots.add("=Sheet1!A1:C9", "A12", "TestPivotTable")
pivot = pivots[pivotIndex]
pivot.add_field_to_area(PivotFieldType.ROW, "fruit")
pivot.add_field_to_area(PivotFieldType.COLUMN, "year")
pivot.add_field_to_area(PivotFieldType.DATA, "amount")
pivot.pivot_table_style_type = PivotTableStyleType.PIVOT_TABLE_STYLE_MEDIUM10
# Change PivotField's attributes
rowField = pivot.row_fields[0]
rowField.display_name = "custom display name"
# Add PivotFilter
index = pivot.pivot_filters.add(0, PivotFilterType.COUNT)
filter = pivot.pivot_filters[index]
filter.auto_filter.filter_top10(0, False, False, 2)
# Add PivotFormatCondition
formatIndex = pivot.pivot_format_conditions.add()
pfc = pivot.pivot_format_conditions[formatIndex]
fcc = pfc.format_conditions
fcc.add_area(pivot.data_body_range)
idx = fcc.add_condition(FormatConditionType.CELL_VALUE)
fc = fcc[idx]
fc.formula1 = "100"
fc.operator = OperatorType.GREATER_OR_EQUAL
fc.style.background_color = Color.red
pivot.refresh_data()
pivot.calculate_data()
# do your business
book.save("out.xlsx")

Ver también