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.
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:
No. |
Result# |
Description |
---|---|---|
1 |
Success |
The Item was successfully edited. |
2 |
The Item was deleted. |
Displayed in the following circumstances:
|
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:
|
9 |
Invalid operator |
Displayed in either of the following circumstances:
|
10 |
A required item is not set. |
A mandatory element was omitted. |
11 |
Other |
An error such as a database access error occurred. |
The following table describes the execution results displayed in the 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.
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:
|
(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.
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. |
To issue JP1 events, you need to enter settings in the following definition files:
-
Configuration file for issuing JP1 events
The settings in this file govern whether the system issues and consolidates JP1 events. For details on the configuration file for issuing JP1 events, see Configuration file for issuing JP1 events (hptl_jp1_imss_jp1event_setting.properties) in Chapter 13. Definition Files.
-
Definition file for status-change JP1 events
In this file, you can define the extended attributes to record in status-change JP1 events. For details on the definition file for status-change JP1 events, Definition file for status-change JP1 events (hptl_jp1_imss_jp1event_status.properties) in Chapter 13. Definition Files.
-
Definition file for the extended event attributes
In this file, you can set the name of extended attributes added to status-change JP1 events so that the event names can be displayed in JP1/IM - View. Although this definition file belongs to JP1/IM - Manager, a model file is provided with JP1/Service Support. For details, see 9.16.1 Setting an environment for linking with JP1/IM - Manager.
(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.