Hitachi

JP1 Version 12 JP1/Service Support Configuration and Administration Guide


3.2.1 Managing Items by using process work boards

In JP1/Service Support, you can use process work boards to centrally manage Items on a target system basis or on a process basis.

Before you can categorize Items by using process work boards, you must define the following settings:

Target system:

This is a setting that allows you to categorize Items by system managed by JP1/Service Support. You can define any target systems.

Process:

This is a setting that allows you to categorize Items by process managed by JP1/Service Support. The processes provided by JP1/Service Support are as follows:

  • Incident management

  • Problem management

  • Change management

  • Release management

You can define any display name for each of the processes shown above. A display name you define is called a process display name.

After you have defined target system and process settings, create process work boards for each process. By registering Items in process work boards, you can manage Items on a target system basis or on a process basis.

The following figure shows an overview of categorizing and managing Items by using process work boards.

Figure 3‒2: Managing Items by using process work boards

[Figure]

Process work boards that are created are displayed in the list of process work boards in the main window (Item list). The list of process work boards is a tree view that displays process work boards categorized by target system and process (process display name) hierarchically.

The following describes the settings of the target system, process work boards, and process display names.

Organization of this subsection

(1) Target system settings

A target system can be defined by using the Target system management window. The following figure shows this window.

Figure 3‒3: "Target system management" window

[Figure]

The following describes the settings that can be specified for a target system, and the functions that can be used to define a target system.

(a) Target system settings

The following table lists and describes the settings that can be specified for a target system.

Table 3‒2: Target system settings

Setting

Description

System ID

The ID that identifies a target system. Each system ID must be unique within the JP1/Service Support platform.

System name

The name that identifies a target system. Each system name must be unique within the JP1/Service Support platform.

Comment

A brief description of a target system.

(b) Target system definition functions

This subsection describes the functions that are provided by JP1/Service Support to define a target system. Note that the functions described here can be used by only users who belong to the process work board management role. For details about the process work board management role, see 3.17.2 Role management.

Creating a target system:

You can create a target system by using the Create the target system window.

Editing a target system:

You can edit the settings of a target system by using the Edit the target system window. Note that you cannot edit a target system that is waiting to be deleted. To edit such a target system, you must cancel deletion.

Deleting a target system:

You can delete unnecessary target systems. Before you can do so, make sure that the state of all process work boards in those target systems is not Operating.

If you delete a target system in the Target system management window, the target system is placed in the Waiting to be deleted state. While the target system is in this state, (Waiting to be deleted) is displayed to the left of the target system name in the list of process work boards in the Target system management window and in the main window (Item list). Note that you cannot edit a target system in this state. After the target system has been deleted, no users other than those who belong to the process work board management role can view the process work boards and Items of the deleted target system.

Note, however, that target systems deleted by using the Target system management window can be restored, because their information remains in the Item management database. For details about restoring a target system, see Canceling deletion of a target system below.

To delete a target system completely from the Item management database, use the jssdelrec command. For details about this command, see jssdelrec (deletes data from the Item management database) in Chapter 12. Commands.

When an Item storage database is used, deleting a target system with the jssdelrec command disables you from viewing the Items in the Item storage database as well as the managed Items registered in the Item management database.

Canceling deletion of a target system:

If there are target systems that are indicated as Waiting to be deleted in the Target system management window, you can restore them to the state that existed before the state changed to Waiting to be deleted. If a target system is restored, the process work boards of that target system are also restored to the state that existed before the state changed to Waiting to be deleted.

(2) Process settings

You can customize the process display names for the processes provided by JP1/Service Support. Customized process display names are applied to all systems. Therefore, process display names replace all the process names that are output to the following windows and files:

The following table lists the windows and functions to which process display names are applied.

Table 3‒3: Windows and functions to which process display names are applied

No.

Category

Description

1

Window

Main window (Item list)

  • List of process work boards

  • List of items

  • Item preview

2

Main window (Item status)

  • Check status

  • List of target items

3

View the process work board window

4

New process work board window

5

Edit the process work board window

6

View Item window

7

New item window

8

Edit item window

9

Status of related item window

10

Specify search conditions - Item-common element window

11

Specify item search conditions window

12

List of item search results window

13

History display window

14

Show progress window

15

Accumulation data output to file window

16

Status management window

17

Specify an escalation destination window

18

Select the process work board as the registration target window

19

Edit permissions window

20

Print window

21

Email notification

Title and text of sent email

22

Input/output file

Detailed information about Items (CSV file) output from the List of item search results window

23

Item and code data (CSV file) output from the Accumulation data output to a file window

24

File (file for extended Item information entries) input for execution of the jssitemimportEx command

25

CSV file of Item information output as a result of execution of the jssitemexportEx command

26

Item details file (CSV file) output as a result of execution of the jssitemlist command

27

Item his history file (CSV file) output as a result of execution of the jssitemhistory command

28

Item accumulation

Data part of Item accumulation data (Item data CSV file or code data CSV file)

29

Report created by a report creation macro file

The following describes the settings you can specify for processes and the function to define the processes.

(a) Process setting

Use the Edit the process display name window to define process display names. To open the Edit the process display name window, from the Option menu in the main window (Item list), choose Edit the process display name. The following figure shows the Edit the process display name window.

Figure 3‒4: Edit the process display name window

[Figure]

You can specify the following setting for processes.

Table 3‒4: Process setting

Setting

Description

Process

Specify process display names for the following processes:

  • Incident management

  • Problem management

  • Change management

  • Release management

(b) Process definition function

JP1/Service Support provides the function described below to define processes. This function can be used only by users who belong to the process work board management role. For details about the process work board management role, see 3.17.2 Role management.

Changing process display names

You can change process display names in the Edit the process display name window.

(3) Process work board settings

A process work board can be defined by using the main window (Item list). To create a process work board, use the New menu. To view, edit, or delete, use the Action menu. This menu can also be used to cancel deletion of a process work board.

The following figure shows the locations of the functions that can be used to define a process work board in the main window (Item list).

Figure 3‒5: Process work board definition functions in the main window (Item list)

[Figure]

The following describes the settings that can be specified for a process work board and the functions that can be used to define a process work board. The following also describes the process work board states and the operations that can be performed in each state.

(a) Process work board settings

The settings of a process work board can be specified by using the New process work board window or the Edit the process work board window. Each of these windows consists of three tabs. The following figure shows an example of these tabs displayed in the New process work board window.

Figure 3‒6: New process work board window

[Figure]

  • Basic settings tab

    This tab is used to specify the basic settings for a process work board.

  • Settings - Automatic item input tab

    This tab is used to specify settings whose values can be automatically input during Item registration, such as Occurrence date and time of item and Start date and time of item. These settings can also be specified by using the property file for automatic Item-defaults input. If you want to specify these settings for a specific process work board only, use the New process work board window or the Edit the process work board window. Note that specifying settings from a window makes the values of the settings displayed in the tab different from values of the corresponding settings in the property file. For details about the property file for automatic Item-defaults input, see Property file for automatic Item-defaults input (hptl_jp1_imss_pwb_default_setting.properties) in Chapter 13. Definition Files.

  • Threshold setting tab

    This tab can be used to set the threshold values that are used for display of Item states in the main window (Item status).

The following tables describe the settings that can be specified in the above tabs.

Table 3‒5: Process work board settings that can be specified in the "Basic settings" tab

Setting

Description

Process work board ID

Specifies the ID that identifies the process work board. Specify a process work board ID that is unique within the JP1/Service Support platform.

System

Specifies the target system in which the process work board is to be registered. Select one of the target systems that have already been created.

Process

Specifies the process for which the process work board is to be registered. Select a process from a pull-down menu.

The pull-down menu shows process display names. For details about process display names, see (2) Process settings.

Item form

Specifies the Item form to be used for the process work board. To use the process standard Item form, select the check box The process standard item form is used. To use an Item form that is different from the process standard Item form, select the desired Item form from the pull-down menu. For details about Item forms, see 3.14 Item form management.

State

Specifies the operating status of the process work board. Select one of the following statuses:

  • In process

    The process work board is preparing for starting operation. If the process work board is in this state, the state can be changed only to Operating or Waiting to be deleted.

  • Operating

    The process work board can be used. If the process work board is in this state, the state can be changed only to Under suspension.

  • Under suspension

    The process work board is being maintained or has stopped. If the process work board is in this state, the state can be changed only to Operating or Waiting to be deleted.

  • Waiting to be deleted

    The process work board was deleted from the main window (Item list). If the process work board is in this state, the state can be changed only to Under suspension.

Process work board administrator

Specifies the user or role that manages the process work board. The process work board manager has the following permissions:

  • Permission to edit the process work board

  • Full access permission for the process work board

Settings for pre-deadline email notification

Specifies whether to notify by email the person in charge or the process work board manager that the deadline of an Item is near. For details about this notification, see 3.12 Email notification.

JP1 event configuration

Use this check box to determine whether to issue a JP1 event from JP1/Service Support when an Item is closed or the status of an Item has changed. For details about issuing JP1 events, see 4.1 Linkage with JP1/IM - Manager.

Person in charge of the registered item from email

Specifies the user (or role) that will become in charge of Items registered via email. For details about email-driven Item registration, see 3.5.3 Creating an Item by sending an email.

View permissions for individual Items

Use this check box to specify whether to set view permissions for individual Items. For details on setting view permissions for individual Items, see 3.11 Item access control.

Settings for the recall item function

Use this check box to specify whether to use the recall Item function. For details about the recall Item function, see 3.6.3 Recalling an Item.

Comment

Specifies a comment on the process work board.

Table 3‒6: Process work board settings that can be specified in the "Settings - Automatic item input" tab

Setting

Description

The Property file for automatic Item-defaults input setting is being used

Use this check box to determine whether to use the values set in the property file for automatic Item-defaults input. If you select this check box, the values set in the file are automatically input.

Occurrence date and time of item

Select either of the radio buttons to determine whether to automatically input the date and time that the Item was generated. If you select Set, the date and time that the New item window was opened is automatically input. If an Item is created by the Item registration command directly or by the email-driven Item registration command, the date and time that the command was executed is automatically input.

Start date and time of item

Select either of the radio buttons to determine whether to automatically input the date and time that the Item was started. If you select Set, the date and time that the New item window was opened is automatically input. If an Item is created by the Item registration command directly or by the email-driven Item registration command, the date and time that the command was executed is automatically input.

Priority of item

Select either of the radio buttons to determine whether to automatically input the Item priority, and use the pull-down menu to set the combination of the impact and severity levels on which automatic priority input is based.

If you select Set, the priority level is automatically input based on the impact and severity levels that were specified when the Item was created. Automatic input is also performed if the Item was created by the Item registration command directly or by the email-driven Item registration command.

The combination of the impact and severity levels can be changed according to the user's operating requirements by using the pull-down menu.

Deadline of item

Select either of the radio buttons to determine whether to automatically input the deadline for the Item.

If you select Set, the deadline for the Item is automatically input. The value that is input automatically is the time that the New item window is opened plus the time period (in hours) entered in the relevant text box.

Note that if the Item priority level is changed by using the Edit item window, the deadline is automatically input. You can select either of the following ways to calculate the deadline:

  • The time that the Edit item window was opened + number of hours specified in the relevant text box

  • The date and time that the Item was registered + number of hours specified in the relevant text box

For details about the settings for calculating the deadline, see Property file for automatic Item-defaults input (hptl_jp1_imss_pwb_default_setting.properties) in Chapter 13. Definition Files.

Note that the deadline is also automatically input if the Item was created by the Item registration command directly or by the email-driven Item registration command. Also note that if the Item priority level is changed by using the Item editing command, the deadline is automatically updated.

In any of the above cases, the automatically input deadline is the date and time that the Item was registered plus the number of hours specified in the relevant text box.

If the relevant text box is blank, the deadline will not be input automatically.

Table 3‒7: Process work board settings that can be specified in the "Threshold setting" tab

Setting

Description

The item accumulation property file is being used

Use this check box to determine whether to use the values set in the Item accumulation property file. If you select the check box, the values set in the file are used to set the threshold values.

Unsolved time treated as extended

Use this text box to specify the threshold value (in hours) for assuming an Item to be an extended Item (an Item that has not been resolved for a long time).

If the time set in this text box passes after the Item was registered, the Item is assumed to be an extended Item. The number of extended Items is displayed in the Extended column in the main window (Item status).

Threshold for Pending

Use this text box to specify the number of Items as the threshold value for determining whether to highlight the relevant cell in the Pending column as an alert in the main window (Item status). If the number of pending Items exceeds the value set in this text box, the relevant cell in the Pending column of the process work board is highlighted as an alert in the main window (Item status).

Threshold for Uncompleted

Use this text box to specify the number of Items as the threshold value for determining whether to highlight the relevant cell in the Uncompleted column as an alert in the main window (Item status). If the number of uncompleted Items exceeds the value set in this text box, the relevant cell in the Uncompleted column of the process work board is highlighted as an alert in the main window (Item status).

Threshold for Discussing

Use this text box to specify the number of Items as the threshold value for determining whether to highlight the relevant cell in the Discussing column as an alert in the main window (Item status). If the number of Items under discussion exceeds the value set in this text box, the relevant cell in the Discussing column of the process work board is highlighted as an alert in the main window (Item status).

Threshold for Extended

Use this text box to specify the number of Items as the threshold value for determining whether to highlight the relevant cell in the Extended column as an alert in the main window (Item status). If the number of extended Items exceeds the value set in this text box, the relevant cell in the Extended column of the process work board is highlighted as an alert in the main window (Item status).

Threshold for Top priority

Use this text box to specify the number of Items as the threshold value for determining whether to highlight the relevant cell in the Top priority column as an alert in the main window (Item status). If the number of Items with the top priority exceeds the value set in this text box, the relevant cell in the Top priority column of the process work board is highlighted as an alert in the main window (Item status).

Threshold for Today's deadline

Use this text box to specify the number of Items as the threshold value for determining whether to highlight the relevant cell in the Today's deadline column as an alert in the main window (Item status). If the number of Items whose deadline is today exceeds the value set in this text box, the relevant cell in the Today's deadline column of the process work board is highlighted as an alert in the main window (Item status).

For the criteria for categorizing Items into pending, uncompleted, and other types, see 3.16.2(1) "Check status" area.

(b) Process work board definition functions

This subsection describes the functions that are provided by JP1/Service Support to define a process work board.

Viewing a process work board:

You can check the settings of a process work board by using the View the process work board window.

Creating a process work board:

You can create a process work board by using the New process work board window.

Editing a process work board:

You can edit the settings of a process work board by using the Edit the process work board window. Note that you cannot edit a process work board whose state is Waiting to be deleted. To edit such a process work board, you must cancel deletion of the process work board.

Specifying access control settings for process work boards and Items:

You can specify access control settings so that access to operations on a process work board can be permitted by user or role. For details about specifying access control settings, see 3.11 Item access control.

Deleting a process work board:

You can delete unnecessary process work boards. Before you can do so, make sure that the state of the process work boards is In process or Under suspension.

If you delete a process work board in the main window (Item list), (Waiting to be deleted) is displayed to the left of the target system name in the list of process work boards. While a process work board is in the Waiting to be deleted state, you cannot edit the access control settings and other settings of the process work board. After the process work board has been deleted, no users other than those who belong to the process work board management role can view the Items of the deleted process work board. If an Item storage database is used, users can no longer view the stored Items of the deleted process work board.

Note, however, that process work boards deleted by using the main window (Item list) can be restored, because their information remains in the Item management database. For details about restoring a process work board, see Canceling deletion of a process work board below.

To delete a process work board completely from the Item management database, use the jssdelrec command. For details about this command, see jssdelrec (deletes data from the Item management database) in Chapter 12. Commands.

Canceling deletion of a process work board:

If there are process work boards in the Waiting to be deleted state, you can restore them to the state that existed before the state changed to Waiting to be deleted. If a process work board is restored, the Items of that process work board are also restored to the state that existed before the state changed to Waiting to be deleted. This means that Items that had already been in the Waiting to be deleted state before the process work board was deleted will be restored to the Waiting to be deleted state, and therefore cannot be viewed after restoration. Cancelling deletion of a process work board can be performed by using the main window (Item list).

(c) Process work board's states and operations that can be performed

The operations that a user can perform on a process work board differ depending on the state of the process work board and the user's authority. Tables 3-8 to 3-10 show the differences.

Table 3‒8: Process work board's states and operations that can be performed (by a user that belongs to the process work board management role)

Operation

State

In process

Operating

Under suspension

Waiting to be deleted

Viewing the process work board

Y

Y

Y

Y

Editing the process work board

Y

Y

Y

N

Specifying access control settings for the process work board and Items

Y

Y

Y

N

Deleting the process work board

Y

N

Y

N

Canceling deletion of the process work board

N

N

N

Y

Viewing the Items

--

Y

Y

Y

Creating Items

N

Y

N

N

Creating Items based on existing registered Items#1

--

Y

Y

Y

Editing Items#2

--

Y

N

N

Escalating Items

--

Y

N

N

Deleting Items

--

Y

N

N

Printing Items

--

Y

Y

Y

Legend:

Y: Can be performed.

N: Cannot be performed.

--: Not applicable (because no Items exist).

#1

Indicates the state of the process work board in which the original Item is registered. For details on the states of the destination process work board, see Item creation.

#2

When recalling or sending back an Item, permissions for operation vary depending on the status-transition state and editing status of the Item. For details about recalling Items, see 3.6.3 Recalling an Item. For details about sending back Items, see 3.6.4 Sending back an Item.

Table 3‒9: Process work board's states and operations that can be performed (by a user or role that is a process work board manager and does not belong to the process work board management role)

Operation

State

In process

Operating

Under suspension

Waiting to be deleted

Viewing the process work board

Y

Y

Y

Cannot be performed because the process work board is not displayed.

Editing the process work board

Y

Y

Y

Specifying access control settings for the process work board and Items

Y

Y

Y

Deleting the process work board

N

N

N

Canceling deletion of the process work board

N

N

N

Viewing the Items

--

Y

Y

Creating Items

N

Y

N

Creating Items based on existing registered Items#1

--

Y

Y

Editing Items#2

--

Y

N

Escalating Items#3

--

Y

N

Deleting Items

--

Y

N

Printing Items

--

Y

Y

Legend:

Y: Can be performed.

N: Cannot be performed.

--: Not applicable (because no Items exist).

#1

Indicates the state of the process work board in which the original Item is registered. For details on the states of the destination process work board, see Item creation.

#2

When recalling or sending back an Item, permissions for operation vary depending on the status-transition state and editing status of the Item. For details about recalling Items, see 3.6.3 Recalling an Item. For details about sending back Items, see 3.6.4 Sending back an Item.

#3

To escalate Items from the process work board to another process work board, you must have escalation permission on the other process work board.

Table 3‒10: Process work board's states and operations that can be performed (by a user or role that is not a process work board manager, does not belong to the process work board management role, and has permissions to view Items)

Operation

State

In process

Operating

Under suspension

Waiting to be deleted

Viewing the process work board

Cannot be performed because the process work board is not displayed.

Y

Y

Cannot be performed because the process work board is not displayed.

Editing the process work board

N

N

Specifying access control settings for the process work board and Items

N

N

Deleting the process work board

N

N

Canceling deletion of the process work board

N

N

Viewing the Items#1

Y

Y

Creating Items

N

N

Creating Items based on existing registered Items#2

Y

Y

Creating Items#3

N

N

Escalating Items#4

Y

N

Deleting Items

N

N

Printing Items

Y

Y

Legend:

Y: Can be performed.

N: Cannot be performed.

#1

If view permissions are set for individual Items, the user or role must be set as the view permission owner for the Item. In this manual, the display name for this parameter is Owner of view permissions for individual Items.

#2

Indicates the state of the process work board in which the original Item is registered. For details on the states of the destination process work board, see Item creation.

#3

When recalling or sending back an Item, permissions for operation vary depending on the status-transition state and editing status of the Item. For details about recalling Items, see 3.6.3 Recalling an Item. For details about sending back Items, see 3.6.4 Sending back an Item.

#4

To escalate Items from the process work board to another process work board, you must have escalation permission on the other process work board.