Behavior Tab of the Control Property Editor

The Behavior tab is available on the Button, HyperLink, and Image control Property Editors. Use this tab to specify the content and appearance of a Web page or popup window that opens when users click the control on a custom form.

Options are:
  • Open URL

    Opens a Web page when users click the control.

  • Open Custom Popup

    Opens a popup window when users click the control.

  • Perform a Transition

    State forms only. Executes an outgoing transition from a state that uses this custom form when users click the 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.

    On a default custom state form, you can use a placeholder for the control label. The placeholder is replaced by the name of the outgoing transition from the current state. If you associate multiple states with this form, you can add a single control that can be used to transition an item out of each state, because the label changes automatically, as described above.

    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.
  • Submit form/Cancel form

    (Transition forms only.) Use to control the placement of the buttons used to submit or cancel a form.

  • Perform a Toolbar Action

    Lets user perform the specified action, such as adding a note or an item link.

Behavior Options

Element Description Applies to
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.

Note: When the control is on a transition form, Same Window is not an option.
Open custom popup All form types
Body HTML The content of the popup window. 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 for primary tables; view forms for auxiliary tables
Mapping

Shows which transition will be executed for a specific state when users click the custom transition control.

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
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 E-mail) 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 the form
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.
Edit forms (auxiliary tables)
Cancel the form
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.
Edit forms (auxiliary tables)
Update the item 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.
View forms (auxiliary tables)
Delete the item Performs the same function as the standard Delete button. The control can be placed anywhere on the form, and can have a unique label. 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. View forms (auxiliary tables)

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