5.7.4 Enabling or disabling an input item
You can set an enable condition when you want the user to enter a string or select an option or check box only when the specified precondition is satisfied. This setting allows you to prevent an input error or other operational mistakes.
- Example: Outputting the entered value to standard output when User input allowed is selected
-
Open the Action dialog box from the Item Design View, specify the information described in the following table in an item, and then register the item.
Table 5‒14: Information specified for the input item "Enable condition" No.
Specifics of where each piece of information is defined
Information to be specified
Main window
Where to transition to
Location where the information is specified
1
Item Design View
+--Action dialog box
Basic settings
Command
cpaecho
2
Parameter
${JDS:msg}
3
Execution type
Do not show the window
4
Input item settings
+--Define input items dialog box
Variable name
select
5
Label
Whether user input is allowed
6
Input type
List box
7
List label: User input not allowed
Value: 0
8
List label: User input allowed
Value: 1
9
Input item settings
+--Define input items dialog box
Variable name
msg
10
Label
Message to be output
11
Input type
Text box
12
Option Settings
+--Enable condition
Enable when item ID: 1#
13
Value: 1
The following figure shows what the dialog box looks like when the created item is to be used in a job.
When User input not allowed is selected, the Message to be output text box is disabled and cannot accept user input.
When User input allowed is selected, the Message to be output text box is enabled and is ready to accept user input. The message entered while the text box is enabled is sent to standard output.
- Important
-
When the disabled input item is enabled, users can enter a string in the text box, select an option from the list box, or select the check box.
If the enabled input item is edited, disabled, and then registered, the input item is registered in its default state. By default, the text box is empty, the first option is selected in the list box, and the check box is cleared.