Properties of data model elements

Additional non-internationalized information associated with the element.

Minimum number of values for an element.

As primary keys cannot be multi-valued, they must have this property set to '1' or 'undefined'. The minimum number of values is automatically set to '0' when defining the field as a selection node.

Maximum number of values for an element. When set to a value greater than '1', the element becomes multi-valued.

As primary keys cannot be multi-valued, they must have this property set to '1' or 'undefined'.

For tables, the maximum number of values is automatically set to 'unbounded' upon creation. The maximum number of values is automatically set to '0' when defining the field as a selection node.

This property is available for tables and fields in tables except Password fields, reusable types, fields in complex reusable types, and selection nodes. Used to define powerful and complex validation rules with the help of the provided XPath 1.0 criteria editor.

See Criteria editor for more information.

This can be useful if the validation of the value depends on complex criteria or on the value of other fields.

It is also possible to indicate that a rule defines a verification for a value that is mandatory under certain circumstances. In this case a value is mandatory if the rule is not satisfied. See Constraint on 'null' values for more information.

Using the associated wizard, you can define localized labels for the validation rule, as well as define a localized message with severity to be displayed if the criteria is not met.

When defining the severity of the validation message it is possible to indicate whether an input that would violate a validation rule will be rejected or not when submitting a form. The error management policy is only available on validation rules defined on a field and when the severity is set to 'error'. If the validation rule must remain valid, then any input that would violate the rule will be rejected and the values will remain unchanged. If errors are allowed, then any input that would violate the rule will be accepted and the values will change. If not specified, the validation rule always blocks errors upon the form submission by default.

If a validation rule is defined on a table, it will be considered as a 'constraint on table' and each record of the table will be evaluated against it at runtime. See Constraints on table for more information.

Default value assigned to this field. In new data creation forms, the default value appears automatically in the user input field. The default value must comply with the defined type of the field.

See Default value for more information.

Internationalized messages to display to users when they enter a value that is invalid for the data type of this field.

This property is available for fields in tables, except in reusable types. Defines a rule for computing the value of the field using the provided XPath 1.0 editor.

See criteria editor

This can be useful if the value depends on other values in the same record, but does not require a programmatic computation.

The following limitations exist for computation rules:

• Computation rules can only be defined on simple fields inside a table.

• Computation rules cannot be defined on fields of type OResource or Password.

• Computation rules cannot be defined on selection nodes and primary key fields.

• Computation rules cannot be defined when accessing an element from the validation report.

Specifies whether or not this element is shown in the default view of a dataset, in the text search of a dataset or in the data service "select" operation.

• Model-driven view

  Specifies whether or not the current element is shown in the default tabular view of a table, the default record form of a table, and in the default view of a dataset if the current element is a table.
  Default dataset view, tabular view and default record form generated from the structure of the data model.
  If the current element is inside a table, then setting the property to 'Hidden' will hide the element from the default tabular view and default record form of the table without having to define specific access permissions. Current element will still be displayed in the view configuration wizard to be able to create a custom view that displays this element.
  If the current element is a table, then setting the property to 'Hidden' will hide the table from the default view of a dataset without having to define specific access permissions.
  This property is ignored if it is set on an element that is neither a table nor in a table.

• All views

  Specifies whether or not the current element is shown in all views of a table in a dataset.
  Setting the property to 'Hidden in all views' will hide the element in all views of the table, whether tabular (default tabular view included) or hierarchical, without having to define specific access permissions. The current element will also be hidden in the view configuration wizard. That is, it won't be possible to create a custom view that will display this element.
  This property is ignored if it is set on an element that is not in a table.
  This property is not applied on forms. That is, setting the property to 'Hidden in all views' will not hide the element in a record form but only in views.

• Structured search tool

  Specifies whether or not the current element is shown in a dataset structured search tool.
  Setting the property to 'Hidden in structured search' will hide the element in the structured search tool of a dataset. The element will remain searchable in the quick search tool. This property is ignored if it is set on an element that is not in a table.

• Data services

  Specifies whether or not the current element is shown in the data service select operation.
  Setting the property to 'Excluded from Data Services' will hide the element in the data service "select" operation.
  This property is ignored if it is set on an element that is not in a table.

See Default view in the Developer Guide.

Defines the widget to be used. A widget is an input component that is displayed in forms in associated datasets.
If undefined, a default widget is displayed in associated datasets according to the type and properties of the current element.
It is possible to use a built-in widget or a custom widget. A custom widget is defined using a Java API to allow the development of rich user interface components for fields or groups.
Built-in and custom widgets cannot be defined on a table or an association.
It is forbidden to define both a custom widget and a UI bean.
It is forbidden to define on a foreign key field both a custom widget and a combo-box selector.

See UIWidgetFactory for more information.

Specifies the name of the published view that will be used in the combo-box selection of the foreign key.
A selection button will be displayed at the bottom right corner of the drop-down list. When defining a foreign key, this feature allows accessing an advanced selection view through the 'Selector' button that opens the advanced selection view, from where sorting and searching options can be used.
If no published view is defined, the advanced selection view will be disabled.
If the path of the referenced table is absolute then only the published views corresponding to this table will be displayed. If the path of the referenced table is relative then all the published views associated with the data model containing the target table will be displayed. This property can only be set if no custom widget is defined.

See Defining a view for the combo box selector of a foreign key in the Developer Guide.

This property is available for all elements except tables and associations. Specifies a Java class to customize the user interface associated with this element in a dataset. A UI bean can display the element differently and/or modify its value by extending the UIBeanEditor class in the Java API.

This property is available for fields and for groups that are terminal nodes. Specifies a Java class that defines transformation operations to be performed when exporting an associated dataset as an archive. The input of the transformation is the value of this element.

See NodeDataTransformer for more information.

Defines the access mode for the current element, that is, if its data can be read and/or written.

• 'Read & Write' corresponds to the mode RW in the data model XSD.

• 'Read only' corresponds to the mode R- in the data model XSD.

• 'Not a dataset node' corresponds to the mode CC in the data model XSD.

• 'Non-terminal node' corresponds to the mode -- in the data model XSD.

See Access properties in the Developer Guide.

Defines the comparison mode associated with the element, which controls how its differences are detected in a dataset.

• 'Default' means the element is visible when comparing associated data.

• 'Ignored' implies that no changes will be detected when comparing two versions of modified content (records or datasets).

  During a merge, the data values of ignored elements are not merged even if the content has been modified. However, values of ignored data sets or records being created during the operation are merged.

  During an archive import, values of ignored elements are not imported when the content has been modified. However, values of ignored datasets or records being created during the operation are imported.

See Comparison mode in the Developer Guide.

Defines if this element must be excluded from the service allowing to apply the last modifications that have been performed on a record to the other records of the same table.

• 'Default' means that the last modification on this element can be applied to other records.

• 'Ignored' implies that the last modification on this element cannot be applied to other records. This element will not be visible in the apply last modifications service.

See Apply last modifications policy in the Developer Guide.

Defines a category for this element. Categories allow controlling the visibility of data in a dataset to users. A node with the category 'Hidden' is hidden by default. Restriction: category specifications other than 'Hidden' do not apply to table record nodes.

See Categories in the Developer Guide.

Value with which to begin the auto-increment. If this attribute is not specified, the default value is '1'.

Amount the value is incremented based on the previous value of the auto-increment. If this attribute is not specified, the default is value is '1'.

Specifies whether to disable the check of the auto-incremented field value in associated datasets against the maximum value in the table being updated.

A foreign key or white space-separated sequence of foreign keys that leads from the current element to the record from which to inherit this field's value. If this property is not specified, the current record is used as the source record for the inheritance.

XPath of the element in the source record from which to inherit this field's value. The source element must be terminal, belong to the record described by 'Source record', and its type must match the type of this field. This property is mandatory when using field inheritance.

A list of fields in the table that compose the table's primary key. You can add or remove primary key fields here, as in the 'Data structure' view.

Each primary key field is denoted by its absolute XPath notation that starts under the table's root element.

If there are several elements in the primary key, the list is white-space delimited. For example, "/name /startDate".

Specifies how records are displayed in the user interface of this table in a dataset.

Defines the fields to provide the default and localized labels for records in the table.

Can also specify a Java class to set the label programmatically, or set the label in a hierarchy. This Java class must implement either the UILabelRenderer interface or the UILabelRendererForHierarchy interface.

Attention: Access rights defined on associated datasets are not applied when displaying record labels.
Fields that are usually hidden due to access rights restrictions will be displayed in labels.

Specifies the default display rendering mode of the groups contained in this table. If nothing is defined here, the default policy set in the Administration area will be used to display groups.

See Record form: rendering mode for nodes in the Administration Guide.

Enabled rendering for groups

Specifies a display rendering mode to be enabled for groups in the table in addition to the modes 'expanded' and 'collapsed', which are always available. Tabs must be enabled on the table to have the option to display groups as tabs. Similarly, links must be enabled to have the option to display groups as links.

Default rendering for groups

Specifies the default display rendering mode to use for the groups contained in this table. If a group does not specify a default mode then the default mode defined for this table will be used. Links must be enabled to define the default rendering mode as 'Link'. Select a rendering mode according to network and browser performance. Link mode is lighter as its content is not displayed on the same page, whereas the expanded and collapsed modes are heavier.

Note: When the tabs view is enabled on a table, any groups that would otherwise have used links are automatically converted to collapsed mode. This is done to avoid the inherent display layout complexities that would arise from links and tabs coexisting in the same user interface.

Defines a specific rendering for customizing the record form in a dataset.

See UIForm and UserServiceRecordFormFactory for more information.

Defines the toolbars to use in this table.

Toolbars can be edited in the Configuration > Toolbars section.

Tabular view top: Defines the toolbar to use on top of the default table view.

Tabular view row: Defines the toolbar to use on each row of the default table view.

Record top: Defines the toolbar to use in the record form.

Hierarchy top: Defines the toolbar to use in the default hierarchy view of the table.

See Toolbars for more information.

Specifies when historization is to be performed, and the level of guarantee requested. The available history profiles can be edited in Administration > History and logs.

See History configuration in the repository for more information.

Defines record display filters on the table.

Specifies the actions that are allowed on the table in associated datasets. By default, all actions are allowed unless specific access rights are defined in a dataset.

See Common advanced properties.

Defines the rendering mode of this group. If this property is not set, then the default view for groups specified by the container table will be used. 'Tab' and 'Link' are each only available when the container table enables it.

Tab position

This attribute specifies the position of the tab with respect to all the tabs defined in the model. This position is used for determining tab order. If a position is not specified, the tab will be displayed according to the position of the group in the data model.