Package com.thingworx.metadata.annotations

Annotation Type ThingworxConfigurationTableDefinition

@Target(ANNOTATION_TYPE)
@Retention(RUNTIME)
@ThingworxExtensionApiAnnotation(since={6,6})
public @interface ThingworxConfigurationTableDefinition

Defines a configuration table to contain settings and other configurable information. Configuration table data may belong to a specific entity, or to all entities that implement the same thing template.

Note that while configuration tables may belong to any root entity, only some are designed to expose it in the Composer.

See Also:

ThingworxConfigurationTableDefinitions, ThingworxSharedConfigurationTableDefinitions, ConfigurationTable

Required Element Summary

Required Elements

Modifier and Type	Required Element	Description
ThingworxDataShapeDefinition	dataShape	Required parameter: defines the fields that compose the configuration table.
java.lang.String	name	Required parameter: the name of the configuration table.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
java.lang.String[]	aspects	Optional parameter: defines the aspects for configuration table, each aspect is string in format of ('key:value').
java.lang.String	category	Optional parameter: a category that conceptually groups together related configuration tables.
java.lang.String	description	Optional parameter: a short description of the configuration table and its purpose.
boolean	isHidden	Optional parameter: controls whether the configuration table should be hidden by Composer (e.g.
boolean	isMultiRow	Optional parameter: controls whether the configuration table should accept tabular entry of data or key/value entry.
int	ordinal	Optional parameter: controls the order in which the configuration tables should be rendered.

Element Detail

name

java.lang.String name

Required parameter: the name of the configuration table. This name should be used when retrieving values from the configuration table during execution. Configuration tables must have unique names that obey standard ThingWorx entity naming conventions. It is strongly recommended that you always specify a non-empty configuration table name.

dataShape

ThingworxDataShapeDefinition dataShape

Required parameter: defines the fields that compose the configuration table. Each field must specify at minimum the name and base type, although it is recommended to also include ordinality and default values when possible. Configuration tables do not support references to data shape entities.

description

java.lang.String description

Optional parameter: a short description of the configuration table and its purpose.

Default:

""

category

java.lang.String category

Optional parameter: a category that conceptually groups together related configuration tables.

Default:

""

isMultiRow

boolean isMultiRow

Optional parameter: controls whether the configuration table should accept tabular entry of data or key/value entry. When set to true, the fields in the data shape provided will be interpreted as column descriptors. When set to false or omitted, the fields are interpreted as row descriptors.

Default:

false

ordinal

int ordinal

Optional parameter: controls the order in which the configuration tables should be rendered. Any non-negative integer is permitted, where lower values take higher precedence over larger values. If several tables share the same ordinal, then the order is non-deterministic.

Default:

0

isHidden

boolean isHidden

Optional parameter: controls whether the configuration table should be hidden by Composer (e.g. if the configuration is for internal purposes only).

Default:

false

aspects

java.lang.String[] aspects

Optional parameter: defines the aspects for configuration table, each aspect is string in format of ('key:value'). If value is JSON then give Stringified JSON

Returns:

aspects array

Default:

{}