Item form definition file (Optional)

Organization of this page

Description
Format
File name
Storage folder
When the definition is applied
What is described
Definition status in the Item form definition file
Notes
Definition examples

Description

This file defines the Item elements of each process. After the definition is applied to JP1/Service Support, the Item elements to be registered are changed to the elements that are defined in this file.

The table below lists the Item form definition files provided by default. See the contents of these files to create a definition file, and then customize it. Save the customized definition file because it can be read by using the jssformcustomizer command.

Table 13‒20: Item form definition files provided by default
File name	Description
`JP1/SS-path\itemform\jssincident.xml`	Item form definition file for incident management
`JP1/SS-path\itemform\jssincident.xml.model`	Model file of the Item form definition file for incident management
`JP1/SS-path\itemform\jssproblem.xml`	Item form definition file for problem management
`JP1/SS-path\itemform\jssproblem.xml.model`	Model file of the Item form definition file for problem management
`JP1/SS-path\itemform\jsschange.xml`	Item form definition file for change management
`JP1/SS-path\itemform\jsschange.xml.model`	Model file of the Item form definition file for change management
`JP1/SS-path\itemform\jssrelease.xml`	Item form definition file for release management
`JP1/SS-path\itemform\jssrelease.xml.model`	Model file of the Item form definition file for release management
`JP1/SS-path\itemform\jssdefault.xml`^#	Definition file for the Item search item form
`JP1/SS-path\itemform\jssdefault.xml.model`^#	Model file of the Definition file for the Item search item form

#: If you customized Item forms for each process, you must customize the Item search item form. If customized specifications do not match, elements might not be displayed in the Specify item search conditions window, or selection codes in the CSV file output from the List of item search results window might not be converted to display names. For details about the Item search item form, see Definition file for the Item search item form (Optional) in Chapter 13. Definition Files. For details about the Specify item search conditions window, see the chapter describing the procedure for searching Items in the JP1/Service Support Operator's Guide.

To Page Top

Format

<!-- XML declaration -->
<?xml version="1.0" encoding="UTF-8" ?>
 
<!-- Item form definition -->
<form-def xmlns="http://www.hitachi.co.jp/jp1/im-ss/jimss_form-1.0">
 <fid>Item-form-ID</fid>
 <fname value="Item-form-name" />
 <description>comment</description>
<!-- Display position -->
 <display-def>
  <position>
   <row><col fiid="element-ID" /></row>
   <row><col fiid="element-ID" /><col fiid="element-ID" /></row>
   <row><col fiid="element-ID" /></row>
    :
  </position>
 </display-def>
 
<!-- Element information -->
 <item-def>
  <item-text fiid="element-ID" search="whether-to-display-information-in-Specify-Item-search-condisions-window" >
   <label labelname="display-name" />
   <validate required="input-required" />
  </item-text>
    :
  <item-code fiid="element-ID" search="whether-to-display-information-in-Specify-Item-search-condisions-window" >
   <label labelname="display-name" />
   <options>
    <option value="0"></option>
    <option value="1">selection-code-display-name</option>
    <option value="2">selection-code-display-name</option>
    <option value="3">selection-code-display-name</option>
   </options>
   <validate required="input-required" />
  </item-code>
    :
 </item-def>
</form-def>

Text between  is treated as a comment.

To Page Top

File name

Use any file name.

To Page Top

Storage folder

Any folder on the host where the jssformdef command is executed

To Page Top

When the definition is applied

The definition takes effect after the contents of the Item form definition file are applied by using the jssformdef command

To Page Top

What is described

Do not change parameters that are not described here.

XML declaration

The following declaration statement must be the first line of the file:

<?xml version="1.0" encoding="UTF-8" ?>

Item form definition

After you define the following lines (only the <description> tag pair can be omitted), define the display position and the element information respectively. In addition, place </form-def> as the last line of the file.

<form-def xmlns="http://www.hitachi.co.jp/jp1/im-ss/jimss_form-1.0">
  <fid>Item-form-ID</fid>
  <fname value="Item-form-name" />
  <description>comment</description>

The following describes the values that are specified for each tag:

item-form-ID

The ID you can specify varies according to the process. Specify the following value:

For Item forms for incident management: JIMSD_FORM_INCIDENT

For Item forms for problem management: JIMSD_FORM_PROBLEM

For Item forms for change management: JIMSD_FORM_CHANGE

For Item forms for release management: JIMSD_FORM_RELEASE

item-form-name

Specify the Item form name within 255 bytes. By default, the following value is specified:

For Item forms for incident management: Incident management form

For Item forms for problem management: Problem management form

For Item forms for change management: Change management form

For Item forms for release management: Release management form

comment

Specify comments for the Item form within 1,024 bytes.

Note that you can check the values you specify for item-form-ID, item-form-name, and comment in the Item form management window and the Item form details window.

Display position

Define the display position of an Item element in a window.

Define elements between the <position> tag and the </position> tag in the following format:

<row><col fiid="element-ID" /></row>
<row><col fiid="element-ID" /><col fiid="element-ID" /></row>
<row><col fiid="element-ID" /></row>
 :

A line begins with the <row> tag and ends with the </row> tag. You can specify one or two <col> tags between the <row> and </row> tags. Specify the element ID of an Item element to be displayed for the <col> tag. This definition determines the position of the elements to be displayed in a window. The display order in a window is the same as the description order defined in this definition file.

For details about the element ID, see Table 13-21.

Notes

Do not remove the following information from the definition of the display position. The text enclosed by a parentheses indicates an Item ID.

Title (JIMSD_FORM_TITLE), Process (JIMSD_FORM_PROCESS), System (JIMSD_FORM_SYSTEM), Item ID (JIMSD_FORM_ITEMID), Inter-process ID (JIMSD_FORM_PROCESSITEMID), Priority (JIMSD_FORM_PRIORITYCODE), Status (JIMSD_FORM_ITEMSTATUSID), Registrant (JIMSD_FORM_REGISTRANT), Registration date and time (JIMSD_FORM_REGISTDATE), Person in charge (JIMSD_FORM_ASSIGNED), Deadline (JIMSD_FORM_DEADLINE), Update date and time (JIMSD_FORM_LASTUPDATE)
The elements that are not defined here will not be displayed in a window even if they are defined in Element information, which is described below.
If a string specified for the Item form name, comment, display name, and selection code display name contains full-width characters, the full-width characters are converted to three or four bytes.
For the elements that are specified in the Item form definition file, do not use control characters (0x00 to 0x1F, 0x7F).

Element information

Element attributes are defined. Multiple attributes can be defined between the <item-def> and </item-def> tags in the format below. Note that only the text enclosed by double quotation marks in the following description can be changed:

Format of text input elements

<item-text fiid="element-ID" type="type" search="whether-to-display-in-Specify-Item-search-conditions-window" >
 <label labelname="display-name" />
 <validate required="input-required" />
</item-text>

element-ID

The ID is fixed for each Item element. See Table 13-21.

type

You can only specify elements with IDs from JIMSD_FORM_USERTEXT01 to JIMSD_FORM_USERTEXT20. The values for such elements can be changed. (It is not necessary to specify type="type" for elements with IDs that do not fall in the above range.) Specify text or textarea. If you omit this specification, text is assumed.

text: Only one line is available for text input.

textarea: Two or more lines are available for text input.

whether-to-display-in-Specify-Item-search-conditions-window

Specify whether to display elements in the Specify item search conditions window. You can specify either true or false. If you omit this specification, true is assumed.

true: Elements are displayed in the Specify item search conditions window.

false: Elements are not displayed in the Specify item search conditions window.

When you want to display elements in the Specify item search conditions window, the display name is shown in the drop-down list for specifying a key word.

display-name

Specify the element name to be displayed in the window within 255 bytes.

input-required

Specify whether an element must be entered, can be entered, or must be entered when the status is changed to Close. Add this element when you want to request input. If this specification is omitted, none is assumed.

all: The element must be entered.

none: The element can be entered.

close: The element must be entered if the status is changed to Close for registration.

Format of numeric input elements

<item-number fiid="element-ID" search="whether-to-display-in-Specify-Item-search-conditions-window" >
 <label labelname="display-name" />
 <validate required="input-required" />
</item-number>

element-ID

The ID is fixed for each Item element. See Table 13-21.

whether-to-display-in-Specify-Item-search-conditions-window

Specify whether to display the element in the Specify item search conditions window. You can specify true or false. If you omit this specification, true is assumed.

true: Elements are displayed in the Specify item search conditions window.

false: Elements are not displayed in the Specify item search conditions window.

When you want to display an element in the Specify item search conditions window, the element is added to Search with this attribute.

display-name

Specify the element name to be displayed in the window within 255 bytes.

input-required

Specify whether an element must be entered, can be entered, or must be entered when the status is changed to Close. Add this text when you want to request input. If this specification is omitted, none is assumed.

all: The element must be entered.

none: The element can be entered.

close: The element must be entered when the status is changed to Close for registration.

Format of USER or ROLE specification elements

<item-user fiid="element-ID" type="type" search="whether-to-display-in-Specify-Item-search-conditions-window" >
 <label labelname="display-name" />
 <validate required="input-required" />
</item-user>

element-ID

The ID is fixed for each Item element. See Table 13-21.

type

You can only specify elements with IDs from JIMSD_FORM_USEREXTTYPE01 to JIMSD_FORM_USEREXTTYPE05. The values for such elements can be changed. (It is not necessary to specify type="type" for elements with IDs that do not fall in the above range.) Specify either user or userrole. If you omit this specification, user is assumed.

user: By clicking the View button next to the value input area, you can call the Select user window.

userrole: By clicking the View button next to the value input area, you can call the Select user and role window.

whether-to-display-in-Specify-Item-search-conditions-window

Specify whether to display elements in the Specify item search conditions window. You can specify true or false. If you omit this specification, true is assumed.

true: The element is displayed in the Specify item search conditions window.

false: The element is not displayed in the Specify item search conditions window.

When you want to display elements in the Specify item search conditions window, the display name is shown in the drop-down list for specifying key word conditions. In addition, an element is added to Search with this attribute.

display-name

Specify the element name to be displayed in the window within 255 bytes.

input-required

Specify whether an element must be entered, can be entered, or must be entered when the status is changed to Close. Add this text when you want to request input. If specification is omitted, none is assumed.

all: The element must be entered.

none: The element can be entered.

close: The element must be entered when the status is changed to Close for registration.

Format for selectable elements

<item-code fiid="element-ID" search="whether-to-display-in-Specify-Item-search-conditions-window" >
 <label labelname="display-name" />
 <options>
  <option value="selection-code">selection-code-display-name</option>
  <option value="selection-code">selection-code-display-name</option>
  <option value="selection-code">selection-code-display-name</option>
     :
 </options>
 <validate required="input-required" />
</item-code>

element-ID

The ID is fixed for each Item element. See Table 13-21.

whether-to-display-in-Specify-Item-search-conditions-window

Specify whether to display elements in the Specify item search conditions window. You can specify true or false. If you omit this specification, true is assumed.

true: The element is displayed in the Specify item search conditions window.

false: The element is not displayed in the Specify item search conditions window.

When you want to display an element in the Specify item search conditions window, the element is added to Search with this attribute.

display-name

Specify the element name to be displayed in a window within 255 bytes.

selection-code

Specify numbers sequentially starting from 0.

In a window, selection codes are displayed in the drop-down list in the order they were specified.

Remarks: A maximum of 30 <option> tags can be specified. <option value="0"></option> can also be specified as <option value="0" />.

selection-code-display-name

Specify selection codes that are displayed in a window within 255 bytes. If you do not specify them (leave them blank), they are displayed as blank spaces in the window.

In the window, the selection code with 0 specified is displayed by default.

input-required

all: The element must be entered.

none: The element can be entered.

close: The element must be entered when the status is changed to Close for registration.

Format of date and time specification elements

<item-datetime fiid="element-ID" search="whether-to-display-in-Specify-Item-search-conditions-window" >
 <label labelname="display-name" />
 <validate required="input-required" />
</item-datetime>

element-ID

The ID is fixed for each Item element. See Table 13-21.

whether-to-display-in-Specify-Item-search-conditions-window

Specify whether to display elements in the Specify item search conditions window. You can specify true or false. If you omit this specification, true is assumed.

true: The element is displayed in the Specify item search conditions window.

false: The element is not displayed in the Specify item search conditions window.

When you want to display an element in the Specify item search conditions window, the element is added to Search with this attribute.

display-name

Specify the element name to be displayed in the window within 255 bytes.

input-required

all: The element must be entered.

none: The element can be entered.

close: The element must be entered if the status is changed to Close for registration.

Format of link specification elements

<item-link fiid="element-ID" type="type" search="whether-to-display-in-Specify-Item-search-conditions-window" >
 <label labelname="display-name" />
 <validate required="input-required" />
</item-link>

element-ID

The ID is fixed for each Item element. See Table 13-21.

type

You can only specify elements with IDs from JIMSD_FORM_REFINFO01 to JIMSD_FORM_REFINFO05. The values for such elements can be changed. (It is not necessary to specify type="type" for elements of IDs that do not fall in the above range.) Specify aim, item, or url. If you omit this specification, url is assumed.

aim: Specify this value to provide a link to the management information of JP1/AIM, JP1/UCMDB, or JP1/ITDM2 - Asset Console.

item: Specify this value to provide a link to another Item.

url: Specify this value to provide a link to a URL.

whether-to-display-in-Specify-Item-search-conditions-window

Specify whether to display elements in the Specify item search conditions window. You can specify true or false. If you omit this specification, true is assumed.

true: The element is displayed in the Specify item search conditions window.

false: The element is not displayed in the Specify item search conditions window.

To display an element in the Specify item search conditions window, display names are displayed in the drop-down list for specifying keyword conditions. In addition, an element is added to Search with this attribute.

display-name

Specify the element name to be displayed in the window within 255 bytes.

input-required

all: The element must be entered.

none: The element can be entered.

close: The element must be entered if the status is changed to Close for registration.

Format of attached file elements

<item-attached fiid="JIMSD_FORM_ATTACHED" search="whether-to-display-in-Specify-Item-search-conditions-window" >
 <label labelname="Attached file(s)" />
</item-attached>

whether-to-display-in-Specify-Item-search-conditions-window

Specify whether to display elements in the Specify item search conditions window. You can specify true or false. If you omit this specification, true is assumed.

true: The element is displayed in the Specify item search conditions window.

false: The element is not displayed in the Specify item search conditions window.

When you want to display elements in the Specify item search conditions window, the display name is shown in the drop-down list for specifying a key word.

Format of status elements

<item-status fiid="JIMSD_FORM_ITEMSTATUSID" search="whether-to-display-in-Specify-Item-search-conditions-window" >
 <label labelname="Status" />
</item-status>

whether-to-display-in-Specify-Item-search-conditions-window

Specify whether to display elements in the Specify item search conditions window. You can specify true or false. If you omit this specification, true is assumed.

true: The element is displayed in the Specify item search conditions window.

false: The element is not displayed in the Specify item search conditions window.

When you want to display an element in the Specify item search conditions window, the element is added to Search with this attribute.

To Page Top

Definition status in the Item form definition file

The Item form definition file which is provided by default defines elements that are commonly necessary for each process so that it is not necessary for users to create a definition file from scratch. The table below lists the definition status in each Item form definition file. Refer to the table when you customize the Item form definition file.

Table 13‒21: Definition status of each Item form definition file
Display name (element-ID)	Input format in a window (maximum value)	Type	Definition status				What you can customize^#1	What is affected
Display name (element-ID)	Input format in a window (maximum value)	Type	I	P	C	R	What you can customize^#1	What is affected
Title (`JIMSD_FORM_TITLE`)	Text (512 bytes)	text	Y	Y	Y	Y	Change the display position. Whether to display in the Specify item search conditions window	None
System (`JIMSD_FORM_SYSTEM`)	Generated automatically	text	Y	Y	Y	Y	Change the display position.	None
Process (`JIMSD_FORM_PROCESS`)	Generated automatically	text	Y	Y	Y	Y	Change the display position.	None
Item ID (`JIMSD_FORM_ITEMID`)	Generated automatically	text	Y	Y	Y	Y	Change the display position. Whether to display in the Specify item search conditions window	None
Inter-process ID (`JIMSD_FORM_PROCESSITEMID`)	Generated automatically	text	Y	Y	Y	Y	Change the display position. Whether to display in the Specify item search conditions window	None
Severity (`JIMSD_FORM_SEVERITYCODE`)	Select from the following: Emergency, Alert, Critical, Error, Warning, Notice, Information, and Debug	code	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Display order of selection codes Changing selection codes	For details about automatic Item element input, see 5.4.3 Using automatic input of Item settings. For details about registering Items from JP1/IM - View, see 4.2.1 Registering Items from JP1/IM - View.
Reason for severity (`JIMSD_FORM_SEVERITYREASON`)	Text (512 bytes)	text	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Impact level (`JIMSD_FORM_IMPACTCODE`)	Select from the following: Small, Middle, Large	code	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Display order of selection codes Change selection codes	For details about automatic Item element input, see 5.4.3 Using automatic input of Item settings.
Reason for impact level (`JIMSD_FORM_IMPACTREASON`)	Text (512 bytes)	text	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Priority (`JIMSD_FORM_PRIORITYCODE`)	Select from the following: Standard, Urgent, Very urgent	code	Y	Y	Y	Y	Change the display position. Whether to display in the Specify item search conditions window Required or optional setting	None
Reason for priority (`JIMSD_FORM_PRIORITYREASON`)	Text (512 bytes)	text	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Item type (`JIMSD_FORM_ITEMCATEGORYCODE`)	Select from the following: Inquiry, Failure, Customer request	code	Y	Y	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Display order of selection codes Change selection codes	None
Problem domain (`JIMSD_FORM_ISSUECATEGORYCODE`)	Select from the following: Application, Middleware, OS, Hardware, Network, and Process	code	Y	Y	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Display order of selection codes Change selection codes	The following items when the Item accumulation data is output to a file: Item data CSV file Reports that was created by using sample macro For details, see 3.16.3(1) Information output to a CSV file, and 3.16.3(2) Downloading a macro file.
Scale of change (`JIMSD_FORM_CHANGESCALECODE`)	Select from the following: Small scale, Middle scale, and Large scale	code	--	--	Y	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Display order of selection codes Change selection codes	None
Release type (`JIMSD_FORM_RELEASETYPECODE`)	Select from the following: Package release, Full release, and Delta release	code	--	--	--	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Display order of selection codes Change selection codes	None
Status (`JIMSD_FORM_ITEMSTATUSID`)	Select from the following: For incident management Received, Investigating, Support Requested, Discussing, Acknowledged, and Close For problem management Received, Investigating, Discussing, Acknowledged, Support Requested, and Close For change management Received, Planning, Discussing, Acknowledged, Support Requested, Reviewing, and Close For release management Received, Planning, Discussing, Acknowledged, Support Requested, and Close	status	Y	Y	Y	Y	Change the display position.^#3 Whether to display in the Specify item search conditions window	None
Result (`JIMSD_FORM_RESULTCODE`)	Select from the following: For incident management Completed, Canceled, and Not confirmed For problem management Change completed, Known problem, and Unknown cause For change management, and release management Succeeded, Failed (planning error), Failed (human error), and Failed (others)	code	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Display order of selection codes Change selection codes	The following items when the Item accumulation data is output to a file: Item data CSV file Reports that was created by using sample macro For details, see 3.16.3(1) Information output to a CSV file, and 3.16.3(2) Downloading a macro file.
Occurrence date and time (`JIMSD_FORM_ACCRUALDATE`)	Date, and time	datetime	Y	--	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Automatic Item element input For details, see 5.4.3 Using automatic input of Item settings.
Occurred type^#2 (`JIMSD_FORM_PHENOMENONCODE`)	No option is defined. Basically, customized by users	code	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Display order of selection codes Changing selection codes	None
Solution category (`JIMSD_FORM_SOLUTIONCODE`)	Select from the following: Knowledge, Document, User solution, Secondary support, Problem management, and Third-party investigation	code	Y	Y	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Display order of selection codes Change selection codes	The following items when the Item accumulation data is output to a file: Item data CSV file Reports that was created by using sample macro For details, see 3.16.3(1) Information output to a CSV file, and 3.16.3(2) Downloading a macro file.
Registrant (`JIMSD_FORM_REGISTRANT`)	Generated automatically	user	Y	Y	Y	Y	Change the display position. Whether to display in the Specify item search conditions window	None
Registration date and time (`JIMSD_FORM_REGISTDATE`)	Generated automatically	datetime	Y	Y	Y	Y	Change the display position. Whether to display in the Specify item search conditions window	None
Person in charge (`JIMSD_FORM_ASSIGNED`)	Specification of a user or a role by selection	userrole	Y	Y	Y	Y	Change the display position. Whether to display in the Specify item search conditions window	None
Deadline (`JIMSD_FORM_DEADLINE`)	Date, and time	datetime	Y	Y	Y	Y	Change the display position. Whether to display in the Specify item search conditions window Required or optional setting	None
Respondent^#2 (`JIMSD_FORM_RESPONDENT`)	Specification of a user or a role by selection	userrole	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Start date and time (`JIMSD_FORM_STARTDATE`)	Date, and time	datetime	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Automatic Item element input For details, see 5.4.3 Using automatic input of Item settings.
End date and time (`JIMSD_FORM_COMPDATE`)	Date, and time	datetime	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Customer name (`JIMSD_FORM_CUSTOMERNAME`)	Text (1,024 bytes)	text	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Inquirer (`JIMSD_FORM_INQUIRYNAME`)	Text (255 bytes)	text	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Cost (planned) (`JIMSD_FORM_ESTIMATEDCOST`)	An integer from 0 to 2147483647	number	--	--	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Cost (actual) (`JIMSD_FORM_ACTUALCOST`)	An integer from 0 to 2147483647	number	--	--	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	The following items when the Item accumulation data is output to a file: Item data CSV file Reports that was created by using sample macro For details, see 3.16.3(1) Information output to a CSV file, 3.16.3(2) Downloading a macro file.
Impact service^#2 (`JIMSD_FORM_EFFECTSERVICE`)	Text (255 bytes)	textarea	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Hardware information (`JIMSD_FORM_LINKAIM`)	Setting for referencing JP1/AIM, JP1/UCMDB, or JP1/ITDM2 - Asset Console	aim	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Linkage with JP1/AIM. For details, see 4.3 Linkage with JP1/AIM. For details about linkage with JP1/UCMDB, see 4.4 Linkage with JP1/UCMDB. For details about linkage with JP1/ITDM2 - Asset Console, see 4.8 Linkage with JP1/ITDM2 - Asset Console.
Problem component and version (`JIMSD_FORM_FAILURELOCATION`)	Text (1,024 bytes)	textarea	--	--	Y	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Related item(s) (`JIMSD_FORM_LINKITEM`)	Setting for referencing related item(s)	item	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Related information (`JIMSD_FORM_LINKURL`)	Setting for referencing an URL	url	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Linkage with WWW applications For details, see 4.11.3 Linkage with web applications.
Overview (`JIMSD_FORM_SUMMARY`)	Text (2,048 bytes)	textarea	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Registering Items from JP1/IM - View For details, see 4.2.1 Registering Items from JP1/IM - View.
Workaround type (`JIMSD_FORM_AVOIDANCECODE`)	Select from the following: None, Not operated, Operated in degraded mode, Restarted, File recovered, Change rolled back, and Others	code	Y	Y	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Display order of selection codes Change selection codes	None
Workaround (`JIMSD_FORM_AVOIDANCE`)	Text (4,096 bytes)	textarea	Y	Y	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Work status (`JIMSD_FORM_SITUATION`)	Text (4,096 bytes)	textarea	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Item's work status display For details, see 3.3.4 Displaying the work status of an Item.
How to avoid the problem in the future^#2 (`JIMSD_FORM_MEASURES`)	Text (4,096 bytes)	textarea	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Cause (`JIMSD_FORM_CAUSECODE`)	Select from the following: For incident management, and problem management New software error, Known software error, New hardware error, Known hardware error, Documentation error, Document missing, User error, Specifications, Third-party error, and Process error For change management, and release management Customer request, Function extension, Business requirement, Incident and problem fix, and Process improvement	code	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Display order of selection codes Changing selection codes	The following items when the Item accumulation data is output to a file: Item data CSV file Reports that was created by using sample macro For details, see 3.16.3(1) Information output to a CSV file, and 3.16.3(2) Downloading a macro file.
Fundamental cause (`JIMSD_FORM_ROOTCAUSE`)	Text (4,096 bytes)	textarea	Y	Y	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Solution (`JIMSD_FORM_SOLUTION`)	Text (4,096 bytes)	textarea	Y	Y	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Schedule and main steps (`JIMSD_FORM_SCHEDULE`)	Text (4,096 bytes)	textarea	--	--	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Impact assessment for change (`JIMSD_FORM_IMPACTEVAL`)	Text (4,096 bytes)	textarea	--	--	Y	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Discussions result (`JIMSD_FORM_DELIBERATIONRST`)	Text (2,048 bytes)	textarea	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Free memo column (`JIMSD_FORM_FREEDESCRIPTION`)	Text (4,096 bytes)	textarea	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Product name (`JIMSD_FORM_JP1PRODUCTNAME`)	Text (1,024 bytes)	text	Y	Y	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Linking with JP1 products. For details, see 4.1.2 Event-driven linkage with JP1 products using automated actions. For details about registering Items from JP1/IM - View, see 4.2.1 Registering Items from JP1/IM - View.
Jobnet name (`JIMSD_FORM_JP1JOBNETNAME`)	Text (1,024 bytes)	text	Y	Y	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Event linkage with JP1 products For details, see 4.1.2 Event-driven linkage with JP1 products using automated actions.
Job name (`JIMSD_FORM_JP1JOBNAME`)	Text (1,024 bytes)	text	Y	Y	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Linking with JP1 products. For details, see 4.1.2 Event-driven linkage with JP1 products using automated actions.
SNMP source (`JIMSD_FORM_JP1SNMPSRC`)	Text (1,024 bytes)	text	Y	Y	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Linking with JP1 products. For details, see 4.1.2 Event-driven linkage with JP1 products using automated actions.
Monitored node name (`JIMSD_FORM_JP1NODENAME`)	Text (255 bytes)	text	Y	Y	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Linking with JP1 products. For details, see 4.1.2 Event-driven linkage with JP1 products using automated actions.
Alarm name (`JIMSD_FORM_JP1ALARMNAME`)	Text (255 bytes)	text	Y	Y	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Linking with JP1 products. For details, see 4.1.2 Event-driven linkage with JP1 products using automated actions.
Attached file(s) (`JIMSD_FORM_ATTACHED`)	File (A maximum of five files, a maximum of five megabytes for a file)	attached	Y	Y	Y	Y	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name.	None
Update date and time (`JIMSD_FORM_LASTUPDATE`)	Generated automatically	datetime	Y	Y	Y	Y	Change the display position. Whether to display in the Specify item search conditions window	None
Serial number^#2 (`JIMSD_FORM_IMEVENTNO`)	Text (64 bytes)	text	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Linking with JP1 products. For details, see 4.1.2 Event-driven linkage with JP1 products using automated actions. For details about registering Items from JP1/IM - View, see 4.2.1 Registering Items from JP1/IM - View.
JP1/IM-M host name^#2 (`JIMSD_FORM_IMHOSTNAME`)	Text (1,024 bytes)	text	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	Linking with JP1 products. For details, see 4.1.2 Event-driven linkage with JP1 products using automated actions. For details about registering Items from JP1/IM - View, see 4.2.1 Registering Items from JP1/IM - View.
Added item: text^#2 (`JIMSD_FORM_USERTEXT01` to `JIMSD_FORM_USERTEXT05`)	Text (4,096 bytes)	text	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Changing the type	None
	Text (4,096 bytes)	textarea	--	--	--	--		None
Added item: text^#2 (`JIMSD_FORM_USERTEXT06` to `JIMSD_FORM_USERTEXT15`)	Text (2,048 bytes)	text	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Change the type	None
	Text (2,048 bytes)	textarea	--	--	--	--		None
Added item: text^#2 (`JIMSD_FORM_USERTEXT16` to `JIMSD_FORM_USERTEXT20`)	Text (512 bytes)	text	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Change the type	None
	Text (512 bytes)	textarea	--	--	--	--		None
Added item: numerical^#2 (`JIMSD_FORM_USERINT01` to `JIMSD_FORM_USERINT05`)	An integer from 0 to 2147483647	number	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Added item: user^#2 (`JIMSD_FORM_USEREXTTYPE01` to `JIMSD_FORM_USEREXTTYPE05`)	Specification of a user or a role by selection	user	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Changing the type	None
	Specification of a user or a role by selection	userrole	--	--	--	--		None
Added item: code^#2 (`JIMSD_FORM_USERCODE01` to `JIMSD_FORM_USERCODE05`)	Options are not defined. User customization is a prerequisite.	code	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Display order of selection codes Changing selection codes	None
Added item: date and time^#2 (`JIMSD_FORM_USERTIME01` to `JIMSD_FORM_USERTIME05`)	Date, and time	datetime	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting	None
Additional element: Link^#2 (`JIMSD_FORM_REFINFO01` to `JIMSD_FORM_REFINFO05`)	Setting for referencing a URL	aim	--	--	--	--	Change the display position. Set to display or hide the applicable element. Whether to display in the Specify item search conditions window Change the display name. Required or optional setting Change the type	None
		item
		url

Legend:

I: Item form definition file for incident management

P: Item form definition file for problem management

C: Item form definition file for change management

R: Item form definition file for release management

Y: Element that is set to be displayed by default

--: Element that is set to be hidden (not defined) by default

#1

Define how to change the display position, and whether to display or hide the element in the Display position area described in the What is described section. Define other elements in the Element information area described in the What is described section.

#2

An element which is supposed to be created by users.

#3

For details about other customization, see 3.15 Status management.

To Page Top

Notes

Use the same selection codes across processes. If they are not consistent, they might be converted to unintended selection codes when they are escalated, or they might not be inherited. For example, if you additionally define <option value="4">Information</option> for Item type in an incident management process, and <option value="4">Reference Information</option> in the problem management process, Information is converted to Reference Information when the incident management process is inherited to a problem management process. Also, if they are not defined additionally, Information is not inherited.
When you customize an Item form for a process or an Item search item form, do not change the current selection code names. If you change selection code names after you start operation, search results in the List of item search results window or selection codes in the CSV file output from the List of item search results window might not be displayed correctly.
If you delete selection codes from the Item form for a process, do not delete them from the Item search item form. If you delete selection codes from the Item search item form, you will no longer be able to search for Items that use deleted selection codes.
When you delete an Item element, create an Item form definition file without the display position definition of the element you want to delete, and then apply the definition to JP1/Service Support. Although you do not need to delete the information of the element you want to delete, we recommend you delete such information so that the Item form definition file will be easier to be understood.
You can use selection codes for searching selectable Item elements.
The Item form definition file (jssincident.xml, jssproblem.xml, jsschange.xml, jssrelease.xml, and jssdefault.xml) must be created or edited with a character encoding that is compatible with the system locale of the machine on which JP1/Service Support is installed. You can use one of the following character encodings:
- In a Japanese environment: UTF-8
- In an English environment: UTF-8
- In a Chinese environment: UTF-8

To Page Top

Definition examples

Definition example 1

The following is a definition example when the SNMP source, monitored node name, and alarm name are deleted from the Item form definition file for incident management, which is provided by default. Note that the following example shows only the part related to changing the display position:

<display-def>
 <position>
  <row><col fiid="JIMSD_FORM_TITLE" /></row>
  <row><col fiid="JIMSD_FORM_ITEMID" /><col fiid="JIMSD_FORM_LASTUPDATE" /></row>
  <row><col fiid="JIMSD_FORM_SYSTEM" /><col fiid="JIMSD_FORM_PROCESS" /></row>
  <row><col fiid="JIMSD_FORM_ACCRUALDATE" /><col fiid="JIMSD_FORM_DEADLINE" /></row>
  <row><col fiid="JIMSD_FORM_ASSIGNED" /><col fiid="JIMSD_FORM_ITEMSTATUSID" /></row>
  <row><col fiid="JIMSD_FORM_CUSTOMERNAME" /><col fiid="JIMSD_FORM_INQUIRYNAME" /></row>
  <row><col fiid="JIMSD_FORM_ITEMCATEGORYCODE" /><col fiid="JIMSD_FORM_PROCESSITEMID" /></row>
  <row><col fiid="JIMSD_FORM_SUMMARY" /></row>
  <row><col fiid="JIMSD_FORM_REGISTDATE" /><col fiid="JIMSD_FORM_REGISTRANT" /></row>
  <row><col fiid="JIMSD_FORM_STARTDATE" /><col fiid="JIMSD_FORM_COMPDATE" /></row>
  <row><col fiid="JIMSD_FORM_SEVERITYCODE" /><col fiid="JIMSD_FORM_SEVERITYREASON" /></row>
  <row><col fiid="JIMSD_FORM_IMPACTCODE" /><col fiid="JIMSD_FORM_IMPACTREASON" /></row>
  <row><col fiid="JIMSD_FORM_PRIORITYCODE" /><col fiid="JIMSD_FORM_PRIORITYREASON" /></row>
  <row><col fiid="JIMSD_FORM_SITUATION" /></row>
  <row><col fiid="JIMSD_FORM_LINKAIM" /></row>
  <row><col fiid="JIMSD_FORM_LINKITEM" /></row>
  <row><col fiid="JIMSD_FORM_LINKURL" /></row>
  <row><col fiid="JIMSD_FORM_JP1PRODUCTNAME" /></row>
  <row><col fiid="JIMSD_FORM_JP1JOBNETNAME" /></row>
  <row><col fiid="JIMSD_FORM_JP1JOBNAME" /></row>
  <row><col fiid="JIMSD_FORM_RESULTCODE" /></row>
  <row><col fiid="JIMSD_FORM_AVOIDANCECODE" /></row>
  <row><col fiid="JIMSD_FORM_AVOIDANCE" /></row>
  <row><col fiid="JIMSD_FORM_CAUSECODE" /></row>
  <row><col fiid="JIMSD_FORM_ROOTCAUSE" /></row>
  <row><col fiid="JIMSD_FORM_SOLUTIONCODE" /></row>
  <row><col fiid="JIMSD_FORM_SOLUTION" /></row>
  <row><col fiid="JIMSD_FORM_DELIBERATIONRST" /></row>
  <row><col fiid="JIMSD_FORM_FREEDESCRIPTION" /></row>
  <row><col fiid="JIMSD_FORM_ATTACHED" /></row>
 </position>
</display-def>

Definition example 2

The following is a definition example when display order 4, the Information selection code is added as the Item type Item element in the Item form definition file. Note that the following example shows only the part related to the Item type Item element:

<item-code fiid="JIMSD_FORM_ITEMCATEGORYCODE" search="true">
 <label labelname="Item type" />
 <options>
  <option value="0"></option>
  <option value="1">Inquiry</option>
  <option value="2">Failure</option>
  <option value="3">Customer request</option>
  <option value="4">Information</option>
 </options>
</item-code>

Definition example 3

The following is a definition example when the Memorandum Item element for text input (4,096 bytes) is added into the Item form definition file. Note that the following example shows only the part related to the Memorandum Item element:

<!-- Display position -->
 <row><col fiid="JIMSD_FORM_USERTEXT01" /></row>
 
<!-- Element information -->
<item-text fiid="JIMSD_FORM_USERTEXT01" search="true" type="textarea" >
 <label labelname="Memorandum" />
</item-text>

To Page Top