Configuring Rich Text Capabilities

You can control users' ability to use the Rich Text Editor and the rendering of formatted text in individual elements as described in the following table:

Element	Control Setting	Default Behavior
Text fields (Memo and Journal only)	Enable Rich Text setting for each field. Set in SBM Composer.	Enabled for newly added fields.
Notes	Render HTML in Notes option. Set in SBM System Administrator.	Enabled for all notes. On-premise customers can disable this setting for their entire system.
E-mail messages	Always enabled. Use HTML templates to ensure content is rendered correctly.	See Selecting E-mail and Notification Templates.

The following sections provide guidance on enabling or disabling the Rich Text Editor and HTML rendering of text.

CAUTION:

If you disable Rich Text capabilities after formatted data has been added to fields, notes, and e-mail messages, the data may be garbled or unreadable. In this case, you must manually modify data to remove formatting tags.

CAUTION:

Sanitizing certain HTML tags can cause text to be hidden in the Rich Text Editor. For details on the correct sanitizer configuration for Rich Text, refer to Configuring System Settings.

Enabling the Rich Text Editor for Text Fields

The Rich Text Editor allows users to apply basic formatting to Text fields (Memo and Journal). This setting can only be applied in SBM Composer.

To enable the Rich Text Editor for individual fields:

In SBM Composer, open the process app that contains the fields for which you want to enable Rich Text editing.
In the App Explorer, select the Data Design filter, and then select the table that contains the fields.
Select a Text field, and then select the Enable Rich Text check box located on the Options tab.
Repeat step 3 for each Text field as needed.
Deploy the process app.

Formatting Default Values for Text Fields

You can use the Rich Text Editor to apply formatting to default values for Text fields (Memo and Journal).

Default values can contain hyperlinks and links to images, but cannot contain images or file attachments.

To use the Rich Text Editor to format default values in SBM Composer, first select the Enable HTML5 Features check box located on the Forms page of the Application tab. The editor will be available for Text fields for which the Enable Rich Text check box is selected.

In SBM Application Administrator, you can apply formatting when you override default values for Text fields for projects and transitions if the Enable Rich Textcheck box is selected for the field.

Selecting E-mail and Notification Templates

To ensure that Rich Text formatting is correctly rendered in e-mail messages generated by the Notification Server, you must select HTML templates for notifications and for e-mails sent from items.

For notifications, e-mail templates are selected on the General page for each notification.

For e-mail messages sent by users as they work with items, templates are selected on the Notification Server tab of the Mail Services page in SBM Configurator. (An HTML template is selected for on-demand customers.)

Disabling Rich Text Capabilities for Notes

On-premise customers can disable the Rich Text Editor and HTML rendering of information in notes added to items.

To disable Rich Text and HTML capabilities for notes:

Open SBM System Administrator.
Select the Settings from the Options menu.
Select the HTML tab.
Clear the Render HTML in Notes check box.
Restart IIS.