ExcelScript.PivotValueFilter interface

Paket:

ExcelScript

Konfigurierbare Vorlage für einen Wertfilter, der auf ein PivotField angewendet werden soll. Definiert condition , welche Kriterien festgelegt werden müssen, damit der Filter funktioniert.

Hinweise

Beispiele

/**
 * 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
  });
}

Eigenschaften

comparator	Der Vergleichsparameter ist der statische Wert, mit dem andere Werte verglichen werden. Der Vergleichstyp wird durch die Bedingung definiert. Wenn der Vergleichsoperator beispielsweise "50" und die Bedingung "greaterThan" ist, werden alle Elementwerte, die nicht größer als 50 sind, vom Filter entfernt.
condition	Gibt die Bedingung für den Filter an, der die erforderlichen Filterkriterien definiert.
exclusive	Wenn true, schließt filter Elemente aus , die Kriterien erfüllen. Der Standardwert ist false (Filter, um Elemente einzuschließen, die Kriterien erfüllen).
lowerBound	Die untere Grenze des Bereichs für die between Filterbedingung.
selectionType	Gibt an, ob der Filter für die obersten/unteren N-Elemente, die obere/untere N-Prozent oder die obere/untere N-Summe gilt.
threshold	Der Schwellenwert "N" von Elementen, Prozent oder Summe, die nach einer Filterbedingung oben/unten gefiltert werden sollen.
upperBound	Die obere Grenze des Bereichs für die between Filterbedingung.
value	Name des ausgewählten "Werts" im Feld, nach dem gefiltert werden soll.

Details zur Eigenschaft

comparator

Der Vergleichsparameter ist der statische Wert, mit dem andere Werte verglichen werden. Der Vergleichstyp wird durch die Bedingung definiert. Wenn der Vergleichsoperator beispielsweise "50" und die Bedingung "greaterThan" ist, werden alle Elementwerte, die nicht größer als 50 sind, vom Filter entfernt.

comparator?: number;

Eigenschaftswert

number

condition

Gibt die Bedingung für den Filter an, der die erforderlichen Filterkriterien definiert.

condition: ValueFilterCondition;

Eigenschaftswert

ExcelScript.ValueFilterCondition

exclusive

Wenn true, schließt filter Elemente aus , die Kriterien erfüllen. Der Standardwert ist false (Filter, um Elemente einzuschließen, die Kriterien erfüllen).

exclusive?: boolean;

Eigenschaftswert

boolean

lowerBound

Die untere Grenze des Bereichs für die between Filterbedingung.

lowerBound?: number;

Eigenschaftswert

number

selectionType

Gibt an, ob der Filter für die obersten/unteren N-Elemente, die obere/untere N-Prozent oder die obere/untere N-Summe gilt.

selectionType?: TopBottomSelectionType;

Eigenschaftswert

ExcelScript.TopBottomSelectionType

threshold

Der Schwellenwert "N" von Elementen, Prozent oder Summe, die nach einer Filterbedingung oben/unten gefiltert werden sollen.

threshold?: number;

Eigenschaftswert

number

upperBound

Die obere Grenze des Bereichs für die between Filterbedingung.

upperBound?: number;

Eigenschaftswert

number

value

Name des ausgewählten "Werts" im Feld, nach dem gefiltert werden soll.

value: string;

Eigenschaftswert

string