Behavior Tab of the Control Property Editor

Use this tab to specify the content and appearance of a Web page or popup window that opens when users click a button, hyperlink, or image control.

Behavior Options

Element Description
Open URL (all form types)
URL

The URL of the Web page that opens when the user clicks the control. Type { if you want to insert references to table fields or other form controls.

The contents of substitution parameters in the URL are escaped if the substitution parameter is preceded by an equal sign (=). For example, for this URL:

http://www.google.com/#2q={fieldname}

The contents of the substitution parameter {fieldname} will be escaped at runtime. For example, if the value is "abcdef" (including the quotes) after processing the query will look like this:

http://www.google.com/#2q=%22abcdef%22

For this URL:

http://www.google.com/#{fieldname}

The value of the {fieldname} substitution parameter will not be escaped.

Target

Whether the Web page should open in the same window or in a separate window.

You can also type the name of a window or an iframe (inline frame) in this field. For example, suppose you have a Help button for two fields on the form. You type Help in the Target box for each button instead of selecting New Window or Same Window, and enter a unique URL for each button. When a user clicks the Help button for the first field, information about the first field is displayed in a new window. When the user clicks the Help button for the second field, information about the second field replaces the information in the window.

Open custom popup (all form types)
Body HTML The content of the popup window that opens with the user clicks the control. You can type HTML code if you want the text formatted, or type text if you do not want the text formatted. There is no limit to the number of characters you can type.

Type { if you want to insert references to table fields or other form controls. By default, referenced fields will render as plain text or rich text according to how the Enable Rich Text option is set in the field Property Editor. You can override this behavior in SBM 11.4 and later (see "Options" below).

Important: When HTML5 is enabled, the popup is a dialog box instead of a separate browser window. This enables you to leverage the form’s custom JavaScript and CSS in the dialog, as well as initiate transitions from the dialog box, such as submitting an item.
Options Default values for features that specify the appearance of the popup window. You can modify the options as needed.

When HTML5 is enabled, you can specify a wider set of options for the dialog box. For the list of options, refer to solution S142150.

Reset Restores the default options.
Perform a transition (state forms)
Mapping

Shows which transition will be executed for a specific state when users click the custom transition control. You can use custom transition controls in addition to or instead of the standard transition buttons at the top of a custom form. These custom controls can have arbitrary labels and can be placed anywhere on the form.

You can associate multiple controls with a single transition. This is useful when you want to repeat controls in different parts of a long form, so users do not have to scroll to the standard button bar at the top of the form.

Note: See Custom Transition Control Tutorials for a specific use case and instructions.

You can see the application workflow where the transition was created in the Defining application workflow column.

Note: Mapping also applies to all sub-workflows of the defining application workflow.
Show transition name If you select this option, you can configure the control to use the transition name as its label. This is useful when using a single control to trigger different transitions depending on the current state. This option is also useful for a single transition, because if the transition name changes in the application workflow, the label changes automatically.
Tip: It is recommended that you type auto in the Height and Width boxes in the Size section on the Design tab of the Ribbon. If you specify fixed values instead, the label for a long transition name could be truncated.

If you do not select this check box, the display text entered on the General tab of the control Property Editor is shown.

Show transition name as tooltip Select this option to display the transition name when users hover over the control.
Allow extended transition button mapping for this form Select this check box to map any state in the selected workflow to an outgoing transition, regardless of the states that apply to the form. This enables you to assign the form to a state or a project in SBM Application Administrator. If you map the form to an invalid state and transition combination, it appears in italics text. If you clear the Allow extended transition button mapping for this form check box, the mapping appears in red text.

The Allow extended transition button mapping for this form option applies to all custom transition actions on a form.

Open Opens the application workflow for the selected row in the Transitions list. The transition in the selected row is selected in the workflow editor.
Add Opens the Add Transition Dialog Box, which lets you define state and transition mapping for the control.

You can add transition mapping only if the custom control is on a form that is associated with a state or that is the default state form for the workflow or if the Allow extended transition button mapping for this form check box is selected. If none of these conditions apply, you can only add mapping for the system Update and Delete transitions.

Tip: If you selected Show transition name and want to have a single control for multiple transitions, add each transition (one at a time) to this tab.
Edit Opens the Edit Transition so you can modify existing transition mappings.
Remove Removes the selected row from the Transitions list.
Perform a Tool Bar action (all form types)
Tool Bar Action Select the action you want to map to this control. All actions are available, even if on the Tool Bar Tab of the Form Property Editor, you removed the action bar from the form or removed the actions from the action bar.
Note: Some actions (for example, Add Item Notification, Link Principal, Unlink Principal, Click to Send Email) are not available for Submit transition forms. If these actions are mapped to custom controls, they will appear on the form, but clicking them will do nothing.
Submit form (transition forms and edit forms)
Performs the same function as the standard OK button. The control can be placed anywhere on the form, and can have a unique label.
Note: On the General tab of the form Property Editor, specify whether the standard OK button should remain in the button bar on the top of the form.
Cancel form (transition forms and edit forms)
Performs the same function as the standard Cancel button. The control can be placed anywhere on the form, and can have a unique label.
Note: On the General tab of the form Property Editor, specify whether the standard Cancel button should remain in the button bar on the form.
Update item (view forms) Performs the same function as the standard Update button. The control can be placed anywhere on the form, and can have a unique label.
Note: On the General tab of the form Property Editor, specify whether the standard Update button should remain in the button bar at the top of the form.
Delete item (view forms) Performs the same function as the standard Delete button. The control can be placed anywhere on the form, and can have a unique label.
Note: On the General tab of the form Property Editor, specify whether the standard Delete button should remain in the button bar at the top of the form.

Related Topics

General Tab of the Form and Control Property Editor

Rows Tab of the Form and Control Property Editor

Columns Tab of the Form and Control Property Editor

Refresh Tab of the Control Property Editor

Appearance Tab of the Form and Control Property Editor

Actions Tab of the Form Property Editor

Using the Property Editors