aws-cdk-lib.aws_quicksight.CfnTemplate.FilterProperty

interface FilterProperty

LanguageType name
.NETAmazon.CDK.AWS.QuickSight.CfnTemplate.FilterProperty
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsquicksight#CfnTemplate_FilterProperty
Javasoftware.amazon.awscdk.services.quicksight.CfnTemplate.FilterProperty
Pythonaws_cdk.aws_quicksight.CfnTemplate.FilterProperty
TypeScript aws-cdk-lib » aws_quicksight » CfnTemplate » FilterProperty

With a Filter , you can remove portions of data from a particular visual or view.

This is a union type structure. For this structure to be valid, only one of the attributes can be defined.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_quicksight as quicksight } from 'aws-cdk-lib';
const filterProperty: quicksight.CfnTemplate.FilterProperty = {
  categoryFilter: {
    column: {
      columnName: 'columnName',
      dataSetIdentifier: 'dataSetIdentifier',
    },
    configuration: {
      customFilterConfiguration: {
        matchOperator: 'matchOperator',
        nullOption: 'nullOption',

        // the properties below are optional
        categoryValue: 'categoryValue',
        parameterName: 'parameterName',
        selectAllOptions: 'selectAllOptions',
      },
      customFilterListConfiguration: {
        matchOperator: 'matchOperator',
        nullOption: 'nullOption',

        // the properties below are optional
        categoryValues: ['categoryValues'],
        selectAllOptions: 'selectAllOptions',
      },
      filterListConfiguration: {
        matchOperator: 'matchOperator',

        // the properties below are optional
        categoryValues: ['categoryValues'],
        selectAllOptions: 'selectAllOptions',
      },
    },
    filterId: 'filterId',
  },
  numericEqualityFilter: {
    column: {
      columnName: 'columnName',
      dataSetIdentifier: 'dataSetIdentifier',
    },
    filterId: 'filterId',
    matchOperator: 'matchOperator',
    nullOption: 'nullOption',

    // the properties below are optional
    aggregationFunction: {
      categoricalAggregationFunction: 'categoricalAggregationFunction',
      dateAggregationFunction: 'dateAggregationFunction',
      numericalAggregationFunction: {
        percentileAggregation: {
          percentileValue: 123,
        },
        simpleNumericalAggregation: 'simpleNumericalAggregation',
      },
    },
    parameterName: 'parameterName',
    selectAllOptions: 'selectAllOptions',
    value: 123,
  },
  numericRangeFilter: {
    column: {
      columnName: 'columnName',
      dataSetIdentifier: 'dataSetIdentifier',
    },
    filterId: 'filterId',
    nullOption: 'nullOption',

    // the properties below are optional
    aggregationFunction: {
      categoricalAggregationFunction: 'categoricalAggregationFunction',
      dateAggregationFunction: 'dateAggregationFunction',
      numericalAggregationFunction: {
        percentileAggregation: {
          percentileValue: 123,
        },
        simpleNumericalAggregation: 'simpleNumericalAggregation',
      },
    },
    includeMaximum: false,
    includeMinimum: false,
    rangeMaximum: {
      parameter: 'parameter',
      staticValue: 123,
    },
    rangeMinimum: {
      parameter: 'parameter',
      staticValue: 123,
    },
    selectAllOptions: 'selectAllOptions',
  },
  relativeDatesFilter: {
    anchorDateConfiguration: {
      anchorOption: 'anchorOption',
      parameterName: 'parameterName',
    },
    column: {
      columnName: 'columnName',
      dataSetIdentifier: 'dataSetIdentifier',
    },
    filterId: 'filterId',
    nullOption: 'nullOption',
    relativeDateType: 'relativeDateType',
    timeGranularity: 'timeGranularity',

    // the properties below are optional
    excludePeriodConfiguration: {
      amount: 123,
      granularity: 'granularity',

      // the properties below are optional
      status: 'status',
    },
    minimumGranularity: 'minimumGranularity',
    parameterName: 'parameterName',
    relativeDateValue: 123,
  },
  timeEqualityFilter: {
    column: {
      columnName: 'columnName',
      dataSetIdentifier: 'dataSetIdentifier',
    },
    filterId: 'filterId',

    // the properties below are optional
    parameterName: 'parameterName',
    timeGranularity: 'timeGranularity',
    value: 'value',
  },
  timeRangeFilter: {
    column: {
      columnName: 'columnName',
      dataSetIdentifier: 'dataSetIdentifier',
    },
    filterId: 'filterId',
    nullOption: 'nullOption',

    // the properties below are optional
    excludePeriodConfiguration: {
      amount: 123,
      granularity: 'granularity',

      // the properties below are optional
      status: 'status',
    },
    includeMaximum: false,
    includeMinimum: false,
    rangeMaximumValue: {
      parameter: 'parameter',
      rollingDate: {
        expression: 'expression',

        // the properties below are optional
        dataSetIdentifier: 'dataSetIdentifier',
      },
      staticValue: 'staticValue',
    },
    rangeMinimumValue: {
      parameter: 'parameter',
      rollingDate: {
        expression: 'expression',

        // the properties below are optional
        dataSetIdentifier: 'dataSetIdentifier',
      },
      staticValue: 'staticValue',
    },
    timeGranularity: 'timeGranularity',
  },
  topBottomFilter: {
    aggregationSortConfigurations: [{
      column: {
        columnName: 'columnName',
        dataSetIdentifier: 'dataSetIdentifier',
      },
      sortDirection: 'sortDirection',

      // the properties below are optional
      aggregationFunction: {
        categoricalAggregationFunction: 'categoricalAggregationFunction',
        dateAggregationFunction: 'dateAggregationFunction',
        numericalAggregationFunction: {
          percentileAggregation: {
            percentileValue: 123,
          },
          simpleNumericalAggregation: 'simpleNumericalAggregation',
        },
      },
    }],
    column: {
      columnName: 'columnName',
      dataSetIdentifier: 'dataSetIdentifier',
    },
    filterId: 'filterId',

    // the properties below are optional
    limit: 123,
    parameterName: 'parameterName',
    timeGranularity: 'timeGranularity',
  },
};

Properties

NameTypeDescription
categoryFilter?IResolvable | CategoryFilterPropertyA CategoryFilter filters text values.
numericEqualityFilter?IResolvable | NumericEqualityFilterPropertyA NumericEqualityFilter filters numeric values that equal or do not equal a given numeric value.
numericRangeFilter?IResolvable | NumericRangeFilterPropertyA NumericRangeFilter filters numeric values that are either inside or outside a given numeric range.
relativeDatesFilter?IResolvable | RelativeDatesFilterPropertyA RelativeDatesFilter filters date values that are relative to a given date.
timeEqualityFilter?IResolvable | TimeEqualityFilterPropertyA TimeEqualityFilter filters date-time values that equal or do not equal a given date/time value.
timeRangeFilter?IResolvable | TimeRangeFilterPropertyA TimeRangeFilter filters date-time values that are either inside or outside a given date/time range.
topBottomFilter?IResolvable | TopBottomFilterPropertyA TopBottomFilter filters data to the top or bottom values for a given column.

categoryFilter?

Type: IResolvable | CategoryFilterProperty (optional)

A CategoryFilter filters text values.

For more information, see Adding text filters in the Amazon QuickSight User Guide .


numericEqualityFilter?

Type: IResolvable | NumericEqualityFilterProperty (optional)

A NumericEqualityFilter filters numeric values that equal or do not equal a given numeric value.


numericRangeFilter?

Type: IResolvable | NumericRangeFilterProperty (optional)

A NumericRangeFilter filters numeric values that are either inside or outside a given numeric range.


relativeDatesFilter?

Type: IResolvable | RelativeDatesFilterProperty (optional)

A RelativeDatesFilter filters date values that are relative to a given date.


timeEqualityFilter?

Type: IResolvable | TimeEqualityFilterProperty (optional)

A TimeEqualityFilter filters date-time values that equal or do not equal a given date/time value.


timeRangeFilter?

Type: IResolvable | TimeRangeFilterProperty (optional)

A TimeRangeFilter filters date-time values that are either inside or outside a given date/time range.


topBottomFilter?

Type: IResolvable | TopBottomFilterProperty (optional)

A TopBottomFilter filters data to the top or bottom values for a given column.