The MappingObject allows defining field data types, captions, and multilevel hierarchies; grouping fields under separate dimensions, and setting other view configurations of hierarchies.
The MappingObject is available for all data sources. It presents a powerful way to neatly separate a data source from its presentation. Find more details about the MappingObject in this tutorial with examples.
The MappingObject has the following properties:
(uniqueName) – Object | Array of objects. Allows setting the mapping for a specific field from the dataset. (uniqueName) is the field’s unique name."json" and "csv" data source types, it is possible to create several fields from a certain field. It can be done by specifying the mapping as an array of objects, where each object is a new field. Learn more in our guide.caption (optional) – String. The hierarchy’s caption.type (optional) – String. The field’s data type. Only for "json", "csv", and "api" data source types. type can be:"string" – The field stores string data."number" – The field stores numerical data. It can be aggregated with all available aggregations."month" – The field stores months. Note that if the field stores month names only (in either short or full form), the field will be recognized by Flexmonster as a field of the "month" type automatically. If the field contains custom month names, specify its type as "month" explicitly."weekday" – The field stores days of the week."date" – The field stores a date. Fields of this type are split into 3 different fields: Year, Month, Day. Only for "json" and "csv" data source types."year/month/day" – The field stores a date. It’s displayed as a multilevel hierarchy with the following levels: Year > Month > Day. Only for "json" and "csv" data source types."year/quarter/month/day" – The field is a date. It’s displayed as a multilevel hierarchy with the following levels: Year > Quarter > Month > Day. Only for "json" and "csv" data source types."date string" – The field stores a date. Fields of this type are represented as strings and can be used in rows, columns, or report filters. The component sorts members of such a field as dates."date string" fields are rounded down with the "1d" interval (i.e., "04/25/2021T21:30:05" is rounded down to "04/25/2021T00:00:00"). If needed, you can set a custom interval for a field. Learn more about intervals."date string" type can be formatted using the datePattern option (the default pattern is "dd/MM/yyyy").
"datetime" – The field stores a date. You can select fields of this type for values."datetime" type can be formatted using the dateTimePattern option (the default pattern is "dd/MM/yyyy HH:mm:ss").
"time" – The field stores time. The "time" type is used for fields that store a time interval (e.g., duration or elapsed time), which is not related to a specific date."HH:mm:ss").
"id" – The field is an id. This field is not shown in the Field List. Fields of this type can be used for editing data."property" – The field for setting member properties. This field is not shown in the Field List. For example, it can be used to associate a productID with a product. See an example here.hierarchy (optional) – String. The hierarchy’s name. When configuring hierarchies, specify this property to mark the field as a level of a hierarchy or as a member property of a hierarchy (in this case, the type parameter should be set to "property"). Only for "json", "csv", and "api" data source types.parent (optional) – String. The unique name of the parent level. This property is necessary if the field is a level of a hierarchy and has a parent level. Only for "json", "csv", and "api" data source types.folder (optional) – String. The field’s folder. Folders are used to group several fields in the Field List. folder supports nesting via / (e.g., "Folder/Subfolder/"). Only for "json", "csv", and "api" data source types.aggregations (optional) — Array of strings. This property represents the list of aggregation functions that can be applied to the current measure.filters (optional) – Boolean. This property allows enabling and disabling the UI filters for a specific hierarchy. When set to false, the UI filters are disabled. Default value: true.visible (optional) – Boolean. When set to false, hides the field from the Field List. Only for "elasticsearch", "json", "csv", and "api" data source types. interval (optional) – String. Allows rounding down dates by the given interval. For example, if the interval is "1d", 2021-05-25T21:30:00 will be rounded to 2021-05-25T00:00:00. See an example on JSFiddle.interval property can be used in the following ways: "elasticsearch" data source type."date string" and "datetime" field types. Supported date intervals are the following:"y" for one year (e.g., "y")."q" for one quarter (e.g., "q")."M" for one month (e.g., "M")."w" for one week (e.g., "w")."d" for days (e.g., "1d"). Note that rounding by days starts from 1 January 1970. "h" for hours (e.g., "7h")."m" for minutes (e.g., "20m")."s" for seconds (e.g., "30s")."y", "q", "M", and "w" intervals should be used without numbers. Only for "csv" and "json" data source types. isMeasure (optional) – Boolean. When set to true, the field can be selected only as a measure. The isMeasure property should be used only with the strictDataTypes option (see an example on JSFiddle). Only for the "json" data source type. Default value: false.time_zone (optional) – String. Used for the date histogram. You can specify time zones as either an ISO 8601 UTC offset (e.g., +01:00 or -08:00) or as a time zone ID as specified in the IANA time zone database, such as America/Los_Angeles. Only for the "elasticsearch" data source type. Check out an example here.format (optional) – String. Used to format different types of date fields. format can be used in the following ways:
format will override its value for the field."elasticsearch" data source type.
"date string" type, it allows overriding the datePattern set in the OptionsObject. The pattern string for the format is the same as in the datePattern option (i.e., "dd/MM/yyyy"). Only for "json", "csv", and "api" data source types. Learn more about date and time formatting.
"datetime" type, it allows overriding the dateTimePattern set in the OptionsObject. The pattern string for the format is the same as in the dateTimePattern option (i.e., "dd/MM/yyyy HH:mm:ss"). Only for "json", "csv", and "api" data source types. Learn more about date and time formatting.
"time" type, it allows overriding the timePattern set in the OptionsObject. The pattern string for the format is the same as in the timePattern option (i.e., "HH:mm:ss"). Only for "json", "csv", and "api" data source types. Learn more about date and time formatting.
min_doc_count (optional) – Number. Only for the "elasticsearch" data source type. Used for the date histogram. Can be used to show intervals with empty values (min_doc_count: 0). Default value: 1 (empty intervals are hidden).aggregations (optional) – Object. Available aggregation functions for all fields of a certain type. See an example on JSFiddle. Only for "json" and "csv" data source types.aggregations object can have the following properties:date (optional) – Array of strings. Available aggregation functions for the "date string" field type.number (optional) – Array of strings. Available aggregation functions for the "number" field type.string (optional) – Array of strings. Available aggregation functions for the "string" field type.time (optional) – Array of strings. Available aggregation functions for the "time" field type.