Hitachi

JP1 Version 12 JP1/Service Support Configuration and Administration Guide


3.7.2 Results of batch operations on Items

You can perform batch operations on Items from the main window (Item list) and the List of item search results window. When you enable batch operations on Items, check boxes appear to the left of Items in the list of Items in the main window (Item list). The person in charge can select the check boxes for the relevant Items and change their status in a batch. The figures below show the main window (Item list) and the List of item search results window in a system with batch operations on Items enabled.

Figure 3‒31: Main window (Item list) with batch operations on Items enabled

[Figure]

Figure 3‒32: List of item search results window with batch operations on Items enabled

[Figure]

When performing batch operations from the main window (Item list), you cannot specify a number of Items equal to or greater than the maximum number than can be displayed in the list of Items#.

#

The maximum number of Items that can be displayed in the list of Items is governed by a setting in the system property file. For details, see System property file (hptl_jp1_imss_main_setting.properties) in Chapter 13. Definition Files.

For details on the procedure for performing batch operations on Items, see the JP1/Service Support Operator's Guide.

When you perform a batch operation on Items in the main window (Item list) or the List of item search results window, the results of the operation appear in the List of batch operation results window.

The following describes the information displayed in the List of batch operation results window, the JP1 events issued when batch operations on Items are performed, and the sending of notification emails.

Organization of this subsection

(1) Results of batch operations

The results of batch operations in the List of batch operation results window appear in the Editing results and JP1 event columns.

The following table describes the execution results displayed in the Editing results column:

Table 3‒40: Execution results in Editing results column

No.

Result#

Description

1

Success

The Item was successfully edited.

2

The Item was deleted.

Displayed in the following circumstances:

  • The Item is in Waiting to be deleted status

  • The jssdelrec command was executed and the Item was deleted from the Item Management database

3

Stored item

The Item is a stored Item. The batch operation ends in an error for this particular Item because you cannot edit stored Items.

4

The max. times an Item can be edited was exceeded.

The Item has been edited the maximum number of times.

5

Invalid permission

The user does not have permission to edit the Item.

6

Invalid state

The status of the process work board is one that prevents its Items from being edited.

7

The Item is being edited.

The Item is being edited by another user.

8

Invalid transition

Displayed in either of the following circumstances:

  • You attempted to change the status of the Item to a restricted status

  • You are not using the Acknowledged status

9

Invalid operator

Displayed in either of the following circumstances:

  • The person in charge of the Item was deleted before the batch operation was performed

  • The person in charge of the Item before the batch operation does not have permission to be assigned to the Item in the new status

10

A required item is not set.

A mandatory element was omitted.

11

Other

An error such as a database access error occurred.

#

If there are several causes of errors for a given Item, causes are shown in order starting from No. 2 in the table.

The following table describes the execution results displayed in the JP1 event column:

Table 3‒41: Execution results in JP1 event column

No.

Result

Description

1

Success

The JP1 event was issued successfully.

2

Failure

The JP1 event failed to be issued.

3

--

The Item does not issue JP1 events.

If you specify the setting to send an email when an Item is closed, you can check the results of sending the email in the Sending email column in the List of batch operation results window. To check the results of sending the email, perform a batch operation on Items to change their statuses to Close. If you do not specify the setting to send an email when an Item is closed, the Sending email column is not displayed. For details about sending an email, see 3.12 Email notification.

The following table describes the execution results that are displayed in the Sending email column.

Table 3‒42: Execution results displayed in the Sending email column

No.

Result

Description

1

Success

The email was sent successfully.

2

Failure

The email failed to be sent.

3

--

Item for which the email is not sent. The email is not sent in the following cases:

  • Items were acknowledged in a batch operation.

  • Editing of the Item failed.

  • A batch operation was performed to close the Items whose status is Close.

(2) JP1 events issued when performing batch operations

You can configure JP1/Service Support to issue the JP1 events in the following table when a user performs a batch operation on Items.

Table 3‒43: JP1 events issuable when performing batch operations on Items

No.

JP1 event

Description

1

JP1 event for completed-action linkage

(Event ID: 00005F00)

Issued when a batch operation changes the status of an Item to Close.

2

Status-change JP1 event

(Event ID: 00005F01)

Issued when a batch operation changes the status of an Item to Close or Acknowledged.

3

Consolidated JP1 event for completed-action linkage

(Event ID: 00005F02)

Issued when a batch operation changes the status of multiple Items to Close in a system where the consolidation of JP1 events is enabled#.

This event represents JP1 events for completed-action linkage consolidated for a given host name (element ID: JIMSD_FORM_IMHOSTNAME). If the system issues a consolidated JP1 event for completed-action linkage, it does not issue JP1 events for completed-action linkage.

#

When consolidation of JP1 events is enabled, a JP1 event for completed-action linkage is issued even if the batch operation only closes a single Item. For details on JP1 events, see 5.11.1 Considering linkage with JP1/IM - Manager.

To issue JP1 events, you need to enter settings in the following definition files:

(3) Reporting batch operations by email

You can notify the user by email when Items are closed in a batch operation. Because details of the closure of each Item processed in the batch operation must be reported to the person in charge, these notifications are not consolidated even if the system is configured to consolidate JP1 events.

For details on notification by email, see 3.12 Email notification.