Formatter Properties for Rich Text:

• Mandatory

  If this box is checked, then the field is mandatory in this view. If this check box is grayed and disabled, then the setting is predefined either in the physical database or in the Object Customizer. These settings take precedence.

  Note that the following interplay between field mandatoriness and visibility comes into play:

  • If a field is set as mandatory in the view customizer or by a rule AND at the same time is set as not visible in the view, than this mandatoriness is ignored.
  • If a field is set as mandatory on the database or object type level, than it remains mandatory even if it is set as not visible in the view.

  When checked, the mandatory field label turns bold in the View Designer.

• Descriptive attribute for one cell ref.view

  Select an attribute to be used as a descriptive value of related object in the search field (i.e. define which attributes should be "visible" in the search field when the required object is found). The option is valid only if a view is used as a Reference View with one cell view type. See also the Searching in a Reference View topic.

• Enabled

  If selected, the attribute will become editable. The control may be used for data display and entry or the data display only. 'Editable' means that the field itself is active, it can be selected and edited in the normal way. 'Disabled' means that the field is grayed and the editing is blocked. However, the data can be still selected and copied, which distinguishes this formatter from the 'Label' formatter. This attribute may also be used to dynamically enable or disable the data entry.

  Note the specific appearance of this option in the View Designer: If selected, the view element will be grayed.

• Height

  Vertical dimension of the Rich Text box. Default height of a rich text control is 400 pixels.

• HTML Forms Allowed

  If selected, form-like controls are enabled in the rich text editor.

• Resize Policy

  The property defines rich text field behaviour in respect to its size. Three options are provided:

  • Fixed height

    Rich text field with this resize policy option selected will always be displayed with fixed height defined by the 'Height' property.

  • Manual resize

    Rich text field with 'Manual resize' policy will be displayed with a resize handle in its bottom right-hand corner. The user can resize the field as needed by dragging the handle. The initial size of the field is defined by the 'Height' property. The resized height is not stored, re-opening the view restores the initial defined size.

  • Autogrow

    The height of a rich text editor with 'Manual resize' policy changes automatically to accommodate the content of the editor. When a height limit defined by the 'height' property is reached, the editor no longer expands and a vertical scroll bar gets displayed.

• Source Code Allowed

  If selected, it enables you to display the source code on the other tab of the editor.

• Collapse toolbar

  If checked, the Rich Text control by default opens with its toolbar collapsed. It can be manually expanded by the 'Expand Toolbar' arrow in the top right-hand corner of the rich text control.

• Visible

  Enable / disable a display of the control on the View. The control may exist on the View layout but may be prevented from being displayed on the actual View. It can also be used creatively to leave a "virtual" blank space in the left column of the view.

  Note the specific appearance of this option in the View Designer: If selected, the view element will be hatched.

• Workflow Link Definitions Allowed

  If selected, a new icon will appear on the toolbar in the Rich Text editor. The icon enables you to define a link to a workflow. This feature is typically used for the Entry Page definition.

• Default Focus on this Field

  Here it is possible to decide if the field would have a default focus when the View is opened.

• Select Action...

  Click to open the Action browser and select the requested action. The action will be assigned and visible at the right edge of the attribute control. The action visibility is determined by the existing editor action assignments (state, mode, rules...).

  Once assigned, you can edit the action using the Edit button or remove it using the Remove button.

Note: Rich text attributes should be used with rich text formatter, this is also the default formatter used when a rich text attribute is added. Furthermore, metamodel check reports all views and rich text attributes which do not use the rich text formatter. Please note that rich text control can be used for data only on the web client. On the rich client, the control formatted with Rich Text formatter is grayed out and cannot be edited.

Pre-selection of the rich text field content

Additionally, it is possible to configure whether the content of rich text fields is selected or not when the field is focused. It can be defined globally by a mainparameter and also for an individual client by client settings.

Global setting:

Set mainparameter (Path: 'VMWeb' / Parameter: 'selectOnFocusInTextarea')

• value set to 'true': on focus the content of the rich text area is selected
• value set to 'false': on focus only the cursor is put inside the text area but the content is not selected

The default value is 'true'.

User-dependent setting:

User-dependent setting is done in the 'Client Settings' dialog of Valuemation web client.

1. In Valuemation web client, click the 'Settings' menubar icon.
2. Select the 'Client Settings' tab.
3. Use the 'Select value on focus in text area' check box to set the behaviour as described above.