Hitachi

JP1 Version 12 JP1/Client Process Automation Configuration and Administration Guide


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

#

When you first define an input item whose details are provided in No. 4 to 8 in the table above, and then proceed to set the other input item whose details are provided in No. 9 to 13 in the table above, you have to set the item ID to 2. In the Input item settings tab, check Input item list for items to find the item ID of the input item whose details are provided in No. 4 to 8 and then set an appropriate item ID in No. 12.

The following figure shows what the dialog box looks like when the created item is to be used in a job.

Figure 5‒14: An item in which an input item is disabled

[Figure]

Figure 5‒15: An item in which an input item is enabled

[Figure]

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.