Need a special offer?Find out if your project fits.
+
API reference
  • API Reference for older versions
  • Table of contents

    FieldInfoObject

    This object is used in the response to the /fields request to provide information about a certain field from the dataset.

    Properties

    {
      "uniqueName": string,
      "type": string,
      "caption": string,
      "hierarchy": string,
      "parent": string,
      "folder": string,
      "interval": string,
      "aggregations": string[],
      "filters": boolean | FilterConfigObject
    }
    Property/Type Description
    uniqueName
    String
    The field's unique name. Will later be used in /members and /select requests.
    type
    String
    The field's type. It can be "string", "number", or "date".
    caption
    String
    optional The field's caption to appear on the UI.
    hierarchy
    String
    optional The hierarchy’s name. Used to configure multilevel hierarchies. Specify this property to set the field as a level of a hierarchy.
    See how to configure multilevel hierarchies.
    parent
    String
    optional The parent level's unique name. This property is necessary to specify if the field is a level of a hierarchy and has a parent level.
    See how to configure multilevel hierarchies.
    folder
    String
    optional The field's folder. Folders are used to organize groups of fields in the Field List. folder supports nesting via / (e.g., "Folder/Subfolder").
    interval
    String
    optional A date's aggregation interval to group dates on the server. The component will automatically send it in /members and /select requests.
    Possible values depend on how the server handles date intervals.
    Only for fields of the "date" type.
    aggregations
    String[]
    optional A list of supported aggregation functions for the field. Supported values include: "sum", "count", "distinctcount", "average", "median", "product", "min", "max", "stdevp", "stdevs", "none", or a custom aggregation.
    Note: for the fields of the "number" type, Flexmonster Pivot supports built-in front-end aggregations.
    To define supported aggregations for all fields, use the root aggregations property in the /fields request.
    filters
    Boolean | FilterConfigObject
    optional Supported filters for the field. To define supported filters for all fields, specify the root filters property in the /fields request.
    Filters for the field can be enabled all at once by setting this property to true, or each filter type can be turned on separately in the FilterConfigObject.

    Example

    Here is an example of a response to the /fields request with the FieldInfoObject:

    {  
      "fields":[
        {
          "uniqueName": "Category",
          "type": "string",
          "hierarchy": "Item"
        },
        {
          "uniqueName": "Color",
          "type": "string",
          "hierarchy": "Item",
          "parent": "Category"
        },
        {
          "uniqueName": "Country",
          "type": "string",
          "filters": true
        },
        // ...
      ],
      // ...
    }

    See also

    /fields request