Form Attributes
General
Attribute Properties
How do I customize use of attributes?
How do I add a column to a table?
How do I setup Dynamic list attribute?
Attributes are data that are displayed and edited in a form. To add, edit or delete form attributes and to define their properties, use the command bar buttons of the Attributes list or the context menu commands.
Every form attribute is described by the following properties:
-
Name – the attribute's name in the form's object model.
-
Synonym – defines a standard visual representation of the attribute in a form.
-
Main Attribute indicates that this attribute is the main attribute. The type of the attribute designated as the main one defines the default functionality of the form. For example, if the main attribute belongs to the CatalogObject type, the commands to edit a catalog item will be available. Only one form attribute can be designated as the main one.
-
Type — defines the attribute's type. It is important that for application object types (e.g. CatalogObject) the form will use specialized data types instead of the application data types, and the specialized data types will be automatically filled with values from the specified types. The details of this process will be provided below.
- Functional options defines the attribute's relationship to the configuration's functional options.
In the attribute list some nested attributes can be set up for client access. Disabled nested attributes are not transferred to the client in any way, unlike the unavailable attributes. During usage customization, any nested attribute can be disabled. However, some attributes of certain specific types will still be transferred to the client if they are required for subsequent recovery of the application object. As an example of using this property, let's discuss a catalog object form. You can disable the tabular section of the CatalogObject attribute if it is not required to be displayed in the form. Disabling attributes significantly decreases the overhead of data exchange between client and server. However, unused attributes can be placed in a form.
When a control is activated, the field corresponding to this attribute is also activated (its frame is highlighted) in the preview pane.
The attributes that are arranged in a form are marked with a small square icon in the second left column in the attributes editor.
The editor supports simultaneous customization of multiple selected attributes using multiple selection in a list. You can drag the selected group within the editor, copy it to the clipboard (for top-level attributes and custom table columns), delete and edit it.
You can specify ValueTable type for an attribute. You can add columns to the Value Table attribute using the Add attribute column command. For each column all the properties available for an attribute are available as well, except for Main Attribute and Use properties.
A Dynamic List attribute in the Attributes list can be set up using the Open link in the List customization property (you must first specify the main table displayed in the attribute). You can also customize conditional appearance in the settings form. These settings will then be available to the user.
You can edit attributes of Chart, GanttChart, Dendrogram, SpreadsheetDocument, GraphicalSchema, and GeographicalSchema types by clicking the Open link in the Object property group.
Note: For attributes of invalid type (e.g., ValueStorage), the editor will display the "(Not available in form data)" text near the type name of this attribute.
When you remove an attribute, the editor will prompt you to remove the connected controls. If you refuse to do so, such controls will have their links cleared. If a link is not the default one for this control (e.g., footer data, data displayed in the group header, etc.) and no prompt to remove such controls is displayed, their links are cleared. The commands connected to the attribute and added to the command interface portion are removed unconditionally.
Navigation to a Control
To navigate to a control, in the controls editor of the form select an attribute with a small square icon indicating that it will be located in the form, and use Go To in its context menu. If multiple objects to go to exist (the form has multiple fields connected to the attribute), a selection form is opened intended to select an object. After that (or always when a single go-to-object exists), the object connected to this attribute is activated in the controls editor.