9.10.1 Procedure for customizing an Item form definition file

To customize an Item form definition file:

Execute the jssformcustomizer command.

Executing the jssformcustomizer command displays the following Item form definition editing utility (select an Item form definition) window.

Figure 9‒24: Item form definition editing utility (select an Item form definition) window

In the Item form definition editing utility (selecting an Item form definition) window, select the Item form definition file you want to edit.

Specify the full path to the Item form definition file you want to edit. Click the View button to display the dialog box for selecting a file. Click the OK button to display the following Item form definition editing utility (customize an Item form) window.

Figure 9‒25: Item form definition editing utility (customize an Item form) window

Item form elements pane

Elements that can be displayed in an Item form are listed.
Item form layout pane

The layout of information set in the Item form definition file is displayed. In this pane, you can edit the Item form definition file.
Overview pane

This pane is composed of the following tabs:

Basic attributes tab

The following attributes of the element selected in the Item form elements pane or in the Item form layout pane are displayed:

- Element ID

- Display name

- Selection code

- Input required

Clicking an icon displays information on the Set value tab.

Extended attributes tab

The Display on search screen attributes of the element selected in the Item form elements pane or in the Item form layout pane are displayed. Clicking an icon displays information on the Set value tab.

Set value tab

The attribute names of the element selected in the Item form elements pane or in the Item form layout pane and their set values are displayed. You can also edit the set values.

If you selected a wrong Item form definition file, you can change it while in the Item form definition editing utility (customize an Item form) window by selecting the Files menu and then Select item form definition file.

In the Item form definition editing utility (customize an Item form) window, edit the Item form definition file.

You can edit the Item form definition file as follows:

When adding an element:

Drag and drop the target display element from the Item form elements pane to the Item form layout pane.

When changing the display position of an element:

Drag and drop the target display element in the Item form layout pane to any position you like.

When deleting an element:

In the Item form elements pane or in the Item form layout pane, select an element you want to delete, and in the Item form definition editing utility (customize an Item form) window, select the Edit menu and then Delete from layout.

When setting the value for an element:

In the Item form elements pane or in the Item form layout pane, select an element for which you want to set a value, and on the Set value tab of the Overview pane, set the value.

In the Item form definition editing utility (customize an Item form) window, select the Files menu and then Item form definition. Then set the Item form name and comments.

The following Item form definition (Item form definition) window appears. Set the Item form name and comments as necessary.

Figure 9‒26: Item form definition (Item form definition) window

Item form name: Specify the Item form name with a character string of no more than 255 bytes. Note that you cannot use control characters.
Comment: Specify the comments with a character string of no more than 1,024 bytes. Note that you cannot use control characters.

In the Item form definition editing utility (customize an Item form) window, select the Files menu and then Save to save the Item form definition file.

The Save item form definition file window (a dialog box for saving an Item form definition file) is displayed. To apply the saved Item form definition file to JP1/Service Support, execute the jssformdef command. For details about the jssformdef command, see jssformdef (registers an Item form definition file) in Chapter 12. Commands.

Note:

Any full-width characters entered in the Item form definition editing utility window are counted as 3 bytes or 4 bytes.

In the Item form definition file, the XML formats of the element information specified between the <item-def> and </item-def> tags differ depending on the element type. For details about the relationship between the element ID and element type, see Table 13-21 Definition status of each Item form definition file. The relationship between the element type and XML format is described below. Check the element type of the element ID that you want to add, and then write XML in the format appropriate for that type.

Element format	Tag name	Element type
Format for elements related to string-type data entry	`<item-text>`	`text, textarea`
Format for elements related to numeric-type data entry	`<item-number>`	`number`
Elements related to user and role specification	`<item-user>`	`user, userrole`
Format for elements related to option selection	`<item-code>`	`code`
Format for elements related to date and time specification	`<item-datetime>`	`datetime`
Format for elements related to link specification	`<item-link>`	`aim, item, url`

To Page Top