Textbox Input Control

When defining the Input Type=textbox control, you can include:

• textbox only
• textbox with chooser
• textbox with date chooser
• textbox with button

For toolbars with multiple input controls, when the user presses the Enter key, the following logic determines what happens:

• If the focus is in a textbox that has a submit button, the href for that textbox is fired.
• If the focus is in a textbox without a submit button, nothing happens. The user must explicitly click the submit button (assuming one is defined that takes the input from multiple input controls).

To include a textbox with a button, use these settings on the toolbar command.

• Input Type = textbox
• Action Label = button name
• href or Javascript

The ButtonName should indicate to the user the function of the input control. For example, if the input is used to search, the button should be labeled "Find" or "Search", depending on your convention. If the input is used as a filter, the button should be labeled "Filter". The submit button displays after the input control if the Action Label setting and href parameter (for the form or table object) are defined. When the input control has focus, the Enter key submits to the href parameter, even if the toolbar includes multiple input controls.

If you do not define an href or an Action label, no button is provided and nothing happens with the text a user enters in that textbox.

To configure a textbox with a chooser button, set format=chooser.

The href for the command should be a JSP that defines the chooser dialog. The page can be a ENOVIA Business Process Services-provided chooser page (such as the vault chooser), or a custom selection page. If the Allow Manual Edit setting on the command that defines the input control is set to true, the user can type data directly into the textbox (instead of clicking the ellipses button and opening the chooser page). When the user tabs out of the box of clicks elsewhere, the JSON code configured on the command is invoked.

For example:

${COMMON_DIR}/emxTypeChooser.jsp?SelectType=
multiselect&InclusionList=eServiceEngineeringCentral.Types

This setting adds the calendar tool after the textbox that allows the user to select a date. The user must use the calendar tool to enter a date.

To use a calendar control in a toolbar, the command must include the Target Location setting with a value of the content frame's name. For example: Target Location = formViewDisplay.

On the page that uses the textbox input control, you can also define a hidden parameter that assigns a name with the _msvalue suffix to the textbox. The system then assigns the value of the textbox to the hidden parameter (the value is calculated in milliseconds from midnight, January 1, 1970). The processing page can use this value for date comparisons or validations.