Package io.jmix.pivottableflowui.kit.component.model

Class PivotTableOptions

java.lang.Object
io.jmix.pivottableflowui.kit.component.model.PivotTableOptionsObservable
io.jmix.pivottableflowui.kit.component.model.PivotTableOptions
All Implemented Interfaces:
Serializable
public class PivotTableOptions extends PivotTableOptionsObservable
Class contains properties to set up the PivotTable component.
See Also:

  • Field Details

  • Constructor Details

    • PivotTableOptions

      public PivotTableOptions()

  • Method Details

    • setPivotTableObjectChangeListener

      public void setPivotTableObjectChangeListener(Consumer<PivotTableOptionsObservable.ObjectChangeEvent> listener)
      Overrides:
      setPivotTableObjectChangeListener in class PivotTableOptionsObservable

    • getProperties

      public Map<String,String> getProperties()
      Returns:
      data provider properties to serialize

    • setProperties

      public void setProperties(Map<String,String> properties)
      Sets data provider properties to serialize.
      Parameters:
      properties - data provider properties to serialize

    • addProperties

      public void addProperties(Map<String,String> properties)
      Adds data provider properties to serialize.
      Parameters:
      properties - data provider properties to serialize

    • addProperty

      public void addProperty(String property, String value)
      Sets data provider property to serialize.
      Parameters:
      property - data provider property to serialize
      value - a property value

    • getRows

      public List<String> getRows()
      Returns:
      a collection of attribute names to use as rows

    • setRows

      public void setRows(List<String> rows)
      Sets a collection of attribute names to use as rows.
      Parameters:
      rows - a collection of attribute names to use as rows

    • addRows

      public void addRows(String... rows)
      Adds an array of attribute names to use as rows.
      Parameters:
      rows - an array of attribute names to add

    • getColumns

      public List<String> getColumns()
      Returns:
      a collection of attribute names to use as columns

    • setColumns

      public void setColumns(List<String> columns)
      Sets a collection of attribute names to use as columns.
      Parameters:
      columns - a collection of attribute names to use as columns

    • addColumns

      public void addColumns(String... columns)
      Adds an array of attribute names to use as columns.
      Parameters:
      columns - an array of attribute names to add

    • getAggregation

      public Aggregation getAggregation()
      Returns:
      an object which will aggregate results per cell

    • setAggregation

      public void setAggregation(Aggregation aggregation)
      Original property name: aggregator.

      Sets a descriptor of an object which will aggregate results per cell (see documentation).

      Applies only when showUI=false.

      Parameters:
      aggregation - an object which will aggregate results per cell

    • getRenderer

      public Renderer getRenderer()
      Returns:
      an object which will generate output from pivot data structure

    • setRenderer

      public void setRenderer(Renderer renderer)
      Sets a descriptor of an object which will generate output from pivot data structure (see documentation).

      Applies only when showUI=false.

      Parameters:
      renderer - an object which will generate output from pivot data structure

    • getAggregationProperties

      public List<String> getAggregationProperties()
      Returns:
      attribute names to prepopulate in vals area

    • setAggregationProperties

      public void setAggregationProperties(List<String> aggregationProperties)
      Original property name: vals.

      Sets attribute names to prepopulate in vals area (gets passed to aggregator generating function).

      Applies only when showUI=true.

      Parameters:
      aggregationProperties - attribute names to prepopulate in vals area

    • addAggregationProperties

      public void addAggregationProperties(String... aggregationProperties)
      Original property name: vals.

      Adds attribute names to prepopulate in vals area (gets passed to aggregator generating function).

      Applies only when showUI=true.

      Parameters:
      aggregationProperties - attribute names to prepopulate in vals area

    • getAggregations

      public Aggregations getAggregations()
      Returns:
      an object that represents a list of generators for aggregation functions in dropdown

    • setAggregations

      public void setAggregations(Aggregations aggregations)
      Original property name: aggregators.

      Sets an object that represents a list of generators for aggregation functions in dropdown (see documentation).

      Applies only when showUI=true.

      Parameters:
      aggregations - an object that represents a list of generators for aggregation functions in dropdown

    • getRenderers

      public Renderers getRenderers()
      Returns:
      n object that represents a list of rendering functions

    • setRenderers

      public void setRenderers(Renderers renderers)
      Sets an object that represents a list of rendering functions (see documentation).

      Applies only when showUI=true.

      Parameters:
      renderers - n object that represents a list of rendering functions

    • getHiddenProperties

      public List<String> getHiddenProperties()
      Returns:
      attribute names to omit from the UI

    • setHiddenProperties

      public void setHiddenProperties(List<String> hiddenProperties)
      Sets attribute names to omit from the UI.

      Applies only when showUI=true.

      Parameters:
      hiddenProperties - attribute names to omit from the UI

    • addHiddenProperties

      public void addHiddenProperties(String... hiddenProperties)
      Adds attribute names to omit from the UI.

      Applies only when showUI=true.

      Parameters:
      hiddenProperties - attribute names to omit from the UI

    • getHiddenFromAggregations

      public List<String> getHiddenFromAggregations()
      Returns:
      attribute names to omit from the aggregation arguments dropdowns

    • setHiddenFromAggregations

      public void setHiddenFromAggregations(List<String> hiddenFromAggregations)
      Sets attribute names to omit from the aggregation arguments dropdowns.

      Applies only when showUI=true.

      Parameters:
      hiddenFromAggregations - attribute names to omit from the aggregation arguments dropdowns

    • addHiddenFromAggregations

      public void addHiddenFromAggregations(String... hiddenFromAggregations)
      Adds attribute names to omit from the aggregation arguments dropdowns.

      Applies only when showUI=true.

      Parameters:
      hiddenFromAggregations - attribute names to omit from the aggregation arguments dropdowns

    • getHiddenFromDragDrop

      public List<String> getHiddenFromDragDrop()
      Returns:
      attribute names to omit from the drag'n'drop portion of the UI

    • setHiddenFromDragDrop

      public void setHiddenFromDragDrop(List<String> hiddenFromDragDrop)
      Sets attribute names to omit from the drag'n'drop portion of the UI.

      Applies only when showUI=true.

      Parameters:
      hiddenFromDragDrop - attribute names to omit from the drag'n'drop portion of the UI

    • addHiddenFromDragDrop

      public void addHiddenFromDragDrop(String... hiddenFromDragDrop)
      Adds attribute names to omit from the drag'n'drop portion of the UI.

      Applies only when showUI=true.

      Parameters:
      hiddenFromDragDrop - attribute names to omit from the drag'n'drop portion of the UI

    • getColumnOrder

      public Order getColumnOrder()
      Returns:
      the order in which column data is provided to the renderer

    • setColumnOrder

      public void setColumnOrder(Order columnOrder)
      Sets the order in which column data is provided to the renderer.

      Ordering by value orders by column total.

      Parameters:
      columnOrder - the order in which column data is provided to the renderer

    • getRowOrder

      public Order getRowOrder()
      Returns:
      the order in which row data is provided to the renderer

    • setRowOrder

      public void setRowOrder(Order rowOrder)
      Sets the order in which row data is provided to the renderer.

      Ordering by value orders by row total.

      Parameters:
      rowOrder - the order in which row data is provided to the renderer

    • getMenuLimit

      public Integer getMenuLimit()
      Returns:
      the maximum number of values to list in the double click menu

    • setMenuLimit

      public void setMenuLimit(Integer menuLimit)
      Sets the maximum number of values to list in the double click menu.

      Applies only when showUI=true.

      Parameters:
      menuLimit - the maximum number of values to list in the double click menu

    • getAutoSortUnusedProperties

      public Boolean getAutoSortUnusedProperties()
      Returns:
      whether unused attributes are kept sorted in the UI

    • setAutoSortUnusedProperties

      public void setAutoSortUnusedProperties(Boolean autoSortUnusedProperties)
      Original property name: autoSortUnusedAttrs.

      Sets whether unused attributes are kept sorted in the UI.

      Applies only when showUI=true.

      Parameters:
      autoSortUnusedProperties - whether unused attributes are kept sorted in the UI

    • getUnusedPropertiesVertical

      public UnusedPropertiesVertical getUnusedPropertiesVertical()
      Returns:
      whether unused attributes are shown vertically

    • setUnusedPropertiesVertical

      public void setUnusedPropertiesVertical(UnusedPropertiesVertical unusedPropertiesVertical)
      Original property name: unusedAttrsVertical.

      Sets whether unused attributes are shown vertically instead of the default which is horizontally. true means always vertical, false means always horizontal. If set to a number (as is the default) then if the attributes' names' combined length in characters exceeds the number then the attributes will be shown vertically.

      Applies only when showUI=true.

      Parameters:
      unusedPropertiesVertical - whether unused attributes are shown vertically

    • getFilterFunction

      public JsFunction getFilterFunction()
      Returns:
      a filter function that is called on each record

    • setFilterFunction

      public void setFilterFunction(JsFunction filter)
      Original property name: filter.

      Sets a filter function that is called on each record, returns false if the record is to be excluded from the input before rendering or true otherwise.

      Parameters:
      filter - a filter function that is called on each record

    • getSortersFunction

      public JsFunction getSortersFunction()
      Returns:
      a sorter function

    • setSortersFunction

      public void setSortersFunction(JsFunction sorters)
      Original property name: sorters.

      Sets a sorter function that is called with an attribute name and can return a function which can be used as an argument to Array.sort for output purposes. If no function is returned, the default sorting mechanism is a built-in "natural sort" implementation. Useful for sorting attributes like month names.

      Parameters:
      sorters - a sorter function

    • getRendererOptions

      public RendererOptions getRendererOptions()
      Returns:
      an object that is passed through to renderer as options

    • setRendererOptions

      public void setRendererOptions(RendererOptions rendererOptions)
      Sets an object that is passed through to renderer as options.
      Parameters:
      rendererOptions - an object that is passed through to renderer as options

    • getInclusions

      public Map<String,List<String>> getInclusions()
      Returns:
      a map whose keys are attribute names and values are arrays of attribute values
      See Also:

    • setInclusions

      public void setInclusions(Map<String,List<String>> inclusions)
      Sets a map whose keys are attribute names and values are arrays of attribute values which denote records to include in rendering; used to prepopulate the filter menus that appear on double-click (overrides exclusions).

      Applies only when showUI=true.

      Parameters:
      inclusions - a map whose keys are attribute names and values are arrays of attribute values
      See Also:

    • setInclusions

      public void setInclusions(String property, List<String> inclusions)
      Sets a list whose values are arrays of attribute values which denote records to include in rendering; used to prepopulate the filter menus that appear on double-click (overrides exclusions).

      Applies only when showUI=true.

      Parameters:
      property - a property for which set inclusions
      inclusions - a list of property values
      See Also:

    • addInclusions

      public void addInclusions(String property, String... inclusions)
      Adds property values to a given property which denote records to include in rendering; used to prepopulate the filter menus that appear on double-click (overrides exclusions).

      Applies only when showUI=true.

      Parameters:
      property - a property for which set inclusions
      inclusions - an array of property values
      See Also:

    • getExclusions

      public Map<String,List<String>> getExclusions()
      Returns:
      a map whose keys are attribute names and values are arrays of attribute values

    • setExclusions

      public void setExclusions(Map<String,List<String>> exclusions)
      Sets a map whose keys are attribute names and values are arrays of attribute values which denote records to exclude from rendering; used to prepopulate the filter menus that appear on double-click.

      Applies only when showUI=true.

      Parameters:
      exclusions - a map whose keys are attribute names and values are arrays of attribute values
      See Also:

    • setExclusions

      public void setExclusions(String property, List<String> exclusions)
      Sets a list whose values are arrays of attribute values which denote records to exclude from rendering; used to prepopulate the filter menus that appear on double-click.

      Applies only when showUI=true.

      Parameters:
      property - a property for which set exclusions
      exclusions - a map whose keys are attribute names and values are arrays of attribute values
      See Also:

    • addExclusions

      public void addExclusions(String property, String... exclusions)
      Adds property values to a given property which denote records to exclude from rendering; used to prepopulate the filter menus that appear on double-click.

      Applies only when showUI=true.

      Parameters:
      property - a property for which set exclusions
      exclusions - a map whose keys are attribute names and values are arrays of attribute values
      See Also:

    • getDerivedProperties

      public DerivedProperties getDerivedProperties()
      Returns:
      an object that represents derived properties

    • setDerivedProperties

      public void setDerivedProperties(DerivedProperties derivedProperties)
      Original property name: derivedAttributes.

      Sets an object that represents derived properties (see documentation).

      Parameters:
      derivedProperties - an object that represents derived properties

    • getEmptyDataMessage

      public String getEmptyDataMessage()
      Returns:
      string with an empty data message

    • setEmptyDataMessage

      public void setEmptyDataMessage(String emptyDataMessage)
      If component doesn't have data to aggregate, the message will be displayed
      Parameters:
      emptyDataMessage - string with an empty data message

    • isShowUI

      public Boolean isShowUI()
      Returns:
      whether to show UI

    • setShowUI

      public void setShowUI(Boolean showUI)
      Shows or hides UI
      Parameters:
      showUI - show UI option

    • isShowRowTotals

      public Boolean isShowRowTotals()
      Returns:
      whether to show row totals

    • setShowRowTotals

      public void setShowRowTotals(Boolean showRowTotals)
      Shows or hides row totals. true by default.
      Parameters:
      showRowTotals - row totals option

    • isShowColumnTotals

      public Boolean isShowColumnTotals()
      Returns:
      whether to show col totals is shown

    • setShowColumnTotals

      public void setShowColumnTotals(Boolean showColumnTotals)
      Shows or hides col totals. true by default.
      Parameters:
      showColumnTotals - column total options

    • getLocaleCode

      public String getLocaleCode()
      Returns:
      a locale code

    • setLocaleCode

      public void setLocaleCode(String localeCode)
      Sets a locale code
      Parameters:
      localeCode - a locale code

    • getLocalizedStrings

      public Map<String,Object> getLocalizedStrings()

    • setLocalizedStrings

      public void setLocalizedStrings(Map<String,Object> localizedStrings)