ExcelScript.PivotValueFilter interface

Paquete:

ExcelScript

Plantilla configurable para que un filtro de valor se aplique a un campo dinámico. condition define qué criterios deben establecerse para que el filtro funcione.

Comentarios

Ejemplos

/**
 * This script applies a PivotValueFilter to the first row hierarchy in the PivotTable.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the PivotTable on the current worksheet.
  let sheet = workbook.getActiveWorksheet();
  let pivotTable = sheet.getPivotTables()[0];

  // Get the first row hierarchy to use as the field which gets filtered.
  let rowHierarchy = pivotTable.getRowHierarchies()[0];

  // Get the first data hierarchy to use as the values for filtering the rows.
  let dataHierarchy = pivotTable.getDataHierarchies()[0];

  // Create a filter that excludes values greater than 500.
  let filter: ExcelScript.PivotValueFilter = {
    condition: ExcelScript.ValueFilterCondition.greaterThan,
    comparator: 500,
    value: dataHierarchy.getName()
  };

  // Apply the filter.
  rowHierarchy.getPivotField(rowHierarchy.getName()).applyFilter({
    valueFilter: filter
  });
}

Propiedades

comparator	El comparador es el valor estático con el que se comparan otros valores. La condición define el tipo de comparación. Por ejemplo, si el comparador es "50" y la condición es "greaterThan", el filtro quitará todos los valores de elemento que no sean mayores que 50.
condition	Especifica la condición del filtro, que define los criterios de filtrado necesarios.
exclusive	Si truees , filter excluye los elementos que cumplen los criterios. El valor predeterminado es false (filtrar para incluir elementos que cumplan los criterios).
lowerBound	Límite inferior del intervalo para la condición de between filtro.
selectionType	Especifica si el filtro es para los N elementos superiores o inferiores, el N por ciento superior/inferior o la suma N superior/inferior.
threshold	Número de umbral "N" de elementos, porcentaje o suma que se va a filtrar para una condición de filtro superior o inferior.
upperBound	Límite superior del intervalo para la condición de between filtro.
value	Nombre del "valor" elegido en el campo por el que se va a filtrar.

Detalles de las propiedades

comparator

El comparador es el valor estático con el que se comparan otros valores. La condición define el tipo de comparación. Por ejemplo, si el comparador es "50" y la condición es "greaterThan", el filtro quitará todos los valores de elemento que no sean mayores que 50.

comparator?: number;

Valor de propiedad

number

condition

Especifica la condición del filtro, que define los criterios de filtrado necesarios.

condition: ValueFilterCondition;

Valor de propiedad

ExcelScript.ValueFilterCondition

exclusive

Si truees , filter excluye los elementos que cumplen los criterios. El valor predeterminado es false (filtrar para incluir elementos que cumplan los criterios).

exclusive?: boolean;

Valor de propiedad

boolean

lowerBound

Límite inferior del intervalo para la condición de between filtro.

lowerBound?: number;

Valor de propiedad

number

selectionType

Especifica si el filtro es para los N elementos superiores o inferiores, el N por ciento superior/inferior o la suma N superior/inferior.

selectionType?: TopBottomSelectionType;

Valor de propiedad

ExcelScript.TopBottomSelectionType

threshold

Número de umbral "N" de elementos, porcentaje o suma que se va a filtrar para una condición de filtro superior o inferior.

threshold?: number;

Valor de propiedad

number

upperBound

Límite superior del intervalo para la condición de between filtro.

upperBound?: number;

Valor de propiedad

number

value

Nombre del "valor" elegido en el campo por el que se va a filtrar.

value: string;

Valor de propiedad

string