Item form definition file (Optional)
- Organization of this page
Description
This file defines the Item elements of each process. After the definition is applied to JP1/IM - 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.
File name |
Description |
---|---|
IM-SS-path\itemform\jssincident.xml |
Item form definition file for incident management |
IM-SS-path\itemform\jssincident.xml.model |
Model file of the Item form definition file for incident management |
IM-SS-path\itemform\jssproblem.xml |
Item form definition file for problem management |
IM-SS-path\itemform\jssproblem.xml.model |
Model file of the Item form definition file for problem management |
IM-SS-path\itemform\jsschange.xml |
Item form definition file for change management |
IM-SS-path\itemform\jsschange.xml.model |
Model file of the Item form definition file for change management |
IM-SS-path\itemform\jssrelease.xml |
Item form definition file for release management |
IM-SS-path\itemform\jssrelease.xml.model |
Model file of the Item form definition file for release management |
IM-SS-path\itemform\jssdefault.xml# |
Definition file for the Item search item form |
IM-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 12. Definition Files. For details about the Specify item search conditions window, see the chapter describing the procedure for searching Items in the Job Management Partner 1/Integrated Management - Service Support Operator's Guide.
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 <!-- and --> is treated as a comment.
File name
Use any file name.
Storage folder
Any folder on the host where the jssformdef command is executed
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
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 12-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 12-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 12-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 12-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 12-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
-
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 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 12-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
-
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 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 12-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 if you want to link the element with management information of JP1/AIM.
item: Specify this value if you want to link the element with another Item.
url: Specify this value if you want to link the element with 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 en 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
-
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 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.
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.
Display name (element-ID) |
Input format in a window (maximum value) |
Type |
Definition status |
What you can customize#1 |
What is affected |
|||
---|---|---|---|---|---|---|---|---|
I |
P |
C |
R |
|||||
Title (JIMSD_FORM_TITLE) |
Text (512 bytes) |
text |
Y |
Y |
Y |
Y |
|
None |
System (JIMSD_FORM_SYSTEM) |
Generated automatically |
text |
Y |
Y |
Y |
Y |
|
None |
Process (JIMSD_FORM_PROCESS) |
Generated automatically |
text |
Y |
Y |
Y |
Y |
|
None |
Item ID (JIMSD_FORM_ITEMID) |
Generated automatically |
text |
Y |
Y |
Y |
Y |
|
None |
Inter-process ID (JIMSD_FORM_PROCESSITEMID) |
Generated automatically |
text |
Y |
Y |
Y |
Y |
|
None |
Severity (JIMSD_FORM_SEVERITYCODE) |
Select from the following: Emergency, Alert, Critical, Error, Warning, Notice, Information, and Debug |
code |
Y |
Y |
Y |
Y |
|
|
Reason for severity (JIMSD_FORM_SEVERITYREASON) |
Text (512 bytes) |
text |
Y |
Y |
Y |
Y |
|
None |
Impact level (JIMSD_FORM_IMPACTCODE) |
Select from the following: Small, Middle, Large |
code |
Y |
Y |
Y |
Y |
|
|
Reason for impact level (JIMSD_FORM_IMPACTREASON) |
Text (512 bytes) |
text |
Y |
Y |
Y |
Y |
|
None |
Priority (JIMSD_FORM_PRIORITYCODE) |
Select from the following: Standard, Urgent, Very urgent |
code |
Y |
Y |
Y |
Y |
|
None |
Reason for priority (JIMSD_FORM_PRIORITYREASON) |
Text (512 bytes) |
text |
Y |
Y |
Y |
Y |
|
None |
Item type (JIMSD_FORM_ITEMCATEGORYCODE) |
Select from the following: Inquiry, Failure, Customer request |
code |
Y |
Y |
-- |
-- |
|
None |
Problem domain (JIMSD_FORM_ISSUECATEGORYCODE) |
Select from the following: Application, Middleware, OS, Hardware, Network, and Process |
code |
Y |
Y |
-- |
-- |
|
The following items when the Item accumulation data is output to a file:
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 |
-- |
|
None |
Release type (JIMSD_FORM_RELEASETYPECODE) |
Select from the following: Package release, Full release, and Delta release |
code |
-- |
-- |
-- |
Y |
|
None |
Status (JIMSD_FORM_ITEMSTATUSID) |
Select from the following:
|
status |
Y |
Y |
Y |
Y |
|
None |
Result (JIMSD_FORM_RESULTCODE) |
Select from the following:
|
code |
Y |
Y |
Y |
Y |
|
The following items when the Item accumulation data is output to a file:
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 |
|
|
Occurred type#2 (JIMSD_FORM_PHENOMENONCODE) |
No option is defined. Basically, customized by users |
code |
-- |
-- |
-- |
-- |
|
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 |
-- |
-- |
|
The following items when the Item accumulation data is output to a file:
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 |
|
None |
Registration date and time (JIMSD_FORM_REGISTDATE) |
Generated automatically |
datetime |
Y |
Y |
Y |
Y |
|
None |
Person in charge (JIMSD_FORM_ASSIGNED) |
Specification of a user or a role by selection |
userrole |
Y |
Y |
Y |
Y |
|
None |
Deadline (JIMSD_FORM_DEADLINE) |
Date, and time |
datetime |
Y |
Y |
Y |
Y |
|
None |
Respondent#2 (JIMSD_FORM_RESPONDENT) |
Specification of a user or a role by selection |
userrole |
-- |
-- |
-- |
-- |
|
None |
Start date and time (JIMSD_FORM_STARTDATE) |
Date, and time |
datetime |
Y |
Y |
Y |
Y |
|
|
End date and time (JIMSD_FORM_COMPDATE) |
Date, and time |
datetime |
Y |
Y |
Y |
Y |
|
None |
Customer name (JIMSD_FORM_CUSTOMERNAME) |
Text (1,024 bytes) |
text |
Y |
Y |
Y |
Y |
|
None |
Inquirer (JIMSD_FORM_INQUIRYNAME) |
Text (255 bytes) |
text |
Y |
Y |
Y |
Y |
|
None |
Cost (planned) (JIMSD_FORM_ESTIMATEDCOST) |
An integer from 0 to 2147483647 |
number |
-- |
-- |
Y |
Y |
|
None |
Cost (actual) (JIMSD_FORM_ACTUALCOST) |
An integer from 0 to 2147483647 |
number |
-- |
-- |
Y |
Y |
|
The following items when the Item accumulation data is output to a file:
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 |
-- |
-- |
-- |
-- |
|
None |
Hardware information (JIMSD_FORM_LINKAIM) |
Setting for referencing JP1/AIM |
aim |
Y |
Y |
Y |
Y |
|
|
Problem component and version (JIMSD_FORM_FAILURELOCATION) |
Text (1,024 bytes) |
textarea |
-- |
-- |
Y |
-- |
|
None |
Related item(s) (JIMSD_FORM_LINKITEM) |
Setting for referencing related item(s) |
item |
Y |
Y |
Y |
Y |
|
None |
Related information (JIMSD_FORM_LINKURL) |
Setting for referencing an URL |
url |
Y |
Y |
Y |
Y |
|
|
Overview (JIMSD_FORM_SUMMARY) |
Text (2,048 bytes) |
textarea |
Y |
Y |
Y |
Y |
|
|
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 |
-- |
-- |
|
None |
Workaround (JIMSD_FORM_AVOIDANCE) |
Text (4,096 bytes) |
textarea |
Y |
Y |
-- |
-- |
|
None |
Work status (JIMSD_FORM_SITUATION) |
Text (4,096 bytes) |
textarea |
Y |
Y |
Y |
Y |
|
|
How to avoid the problem in the future#2 (JIMSD_FORM_MEASURES) |
Text (4,096 bytes) |
textarea |
-- |
-- |
-- |
-- |
|
None |
Cause (JIMSD_FORM_CAUSECODE) |
Select from the following:
|
code |
Y |
Y |
Y |
Y |
|
The following items when the Item accumulation data is output to a file:
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 |
-- |
-- |
|
None |
Solution (JIMSD_FORM_SOLUTION) |
Text (4,096 bytes) |
textarea |
Y |
Y |
-- |
-- |
|
None |
Schedule and main steps (JIMSD_FORM_SCHEDULE) |
Text (4,096 bytes) |
textarea |
-- |
-- |
Y |
Y |
|
None |
Impact assessment for change (JIMSD_FORM_IMPACTEVAL) |
Text (4,096 bytes) |
textarea |
-- |
-- |
Y |
-- |
|
None |
Discussions result (JIMSD_FORM_DELIBERATIONRST) |
Text (2,048 bytes) |
textarea |
Y |
Y |
Y |
Y |
|
None |
Free memo column (JIMSD_FORM_FREEDESCRIPTION) |
Text (4,096 bytes) |
textarea |
Y |
Y |
Y |
Y |
|
None |
Product name (JIMSD_FORM_JP1PRODUCTNAME) |
Text (1,024 bytes) |
text |
Y |
Y |
-- |
-- |
|
|
Jobnet name (JIMSD_FORM_JP1JOBNETNAME) |
Text (1,024 bytes) |
text |
Y |
Y |
-- |
-- |
|
|
Job name (JIMSD_FORM_JP1JOBNAME) |
Text (1,024 bytes) |
text |
Y |
Y |
-- |
-- |
|
|
SNMP source (JIMSD_FORM_JP1SNMPSRC) |
Text (1,024 bytes) |
text |
Y |
Y |
-- |
-- |
|
|
Monitored node name (JIMSD_FORM_JP1NODENAME) |
Text (255 bytes) |
text |
Y |
Y |
-- |
-- |
|
|
Alarm name (JIMSD_FORM_JP1ALARMNAME) |
Text (255 bytes) |
text |
Y |
Y |
-- |
-- |
|
|
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 |
|
None |
Update date and time (JIMSD_FORM_LASTUPDATE) |
Generated automatically |
datetime |
Y |
Y |
Y |
Y |
|
None |
Serial number#2 (JIMSD_FORM_IMEVENTNO) |
Text (64 bytes) |
text |
-- |
-- |
-- |
-- |
|
|
JP1/IM-M host name#2 (JIMSD_FORM_IMHOSTNAME) |
Text (1,024 bytes) |
text |
-- |
-- |
-- |
-- |
|
|
Added item: text#2 (JIMSD_FORM_USERTEXT01 to JIMSD_FORM_USERTEXT05) |
Text (4,096 bytes) |
text |
-- |
-- |
-- |
-- |
|
None |
textarea |
||||||||
Added item: text#2 (JIMSD_FORM_USERTEXT06 to JIMSD_FORM_USERTEXT15) |
Text (2,048 bytes) |
text |
-- |
-- |
-- |
-- |
|
None |
textarea |
||||||||
Added item: text#2 (JIMSD_FORM_USERTEXT16 to JIMSD_FORM_USERTEXT20) |
Text (512 bytes) |
text |
-- |
-- |
-- |
-- |
|
None |
textarea |
||||||||
Added item: numerical#2 (JIMSD_FORM_USERINT01 to JIMSD_FORM_USERINT05) |
An integer from 0 to 2147483647 |
number |
-- |
-- |
-- |
-- |
|
None |
Added item: user#2 (JIMSD_FORM_USEREXTTYPE01 to JIMSD_FORM_USEREXTTYPE05) |
Specification of a user or a role by selection |
user |
-- |
-- |
-- |
-- |
|
None |
userrole |
||||||||
Added item: code#2 (JIMSD_FORM_USERCODE01 to JIMSD_FORM_USERCODE05) |
Options are not defined. User customization is a prerequisite. |
code |
-- |
-- |
-- |
-- |
|
None |
Added item: date and time#2 (JIMSD_FORM_USERTIME01 to JIMSD_FORM_USERTIME05) |
Date, and time |
datetime |
-- |
-- |
-- |
-- |
|
None |
Additional element: Link#2 (JIMSD_FORM_REFINFO01 to JIMSD_FORM_REFINFO05) |
Setting for referencing a URL |
aim |
-- |
-- |
-- |
-- |
|
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.
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/IM - 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/IM - 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
-
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>