Removing Unwanted Initial Measurements

Remove Unwanted Initial Measurements Request Types

Requests used to remove initial measurements are based on request types which specify the batch control used to identify and remove the initial measurements. 

To create request types used with this feature:

1. Select Menu, Admin, General, Request Type, Add.

2. Select "Remove IMDs Request Type" from the Request Type Business Object drop-down list, and click OK.

3. Enter the following:

   • Request Type: A code for the request type

   • Description: A description of the request type

   • Batch Control: Search for and select the batch control to be used for requests of this type. The default is Remove Non-Final IMDs (D1-RENFI), but implementations can create custom versions of this batch control. 

4. Click Save.

Remove Unwanted Initial Measurements Requests

To create an initial measurement removal request:

1. Select Menu, Tools, Request, Add. 

2. Select the appropriate request from the Request Type drop-down list and click OK.

3. Enter the Submission Parameters for the request. These include:

   • Mode: The mode in which the process will be run. Options include:

     • Preview: Returns a count of non-final initial measurements and related objects (VEE Exceptions, To Do Entries, and Service Issue Monitors)

     • Close: Transitions non-final initial measurements to the "Discarded" state and completes and/or closes related objects. Details regarding the data impacted by "Close" requests are captured and displayed in the Object Log zone.

     • Delete:  Deletes non-final initial measurements any related objects. Details regarding the data impacted by "Delete" requests are captured and displayed in the Object Log zone.

   • Thread Count: The number of processing threads allocated to the process

   • IMD Business Object: Used to restrict the initial measurements processed to those of a specific business object

   • IMD Status: Used to restrict the initial measurements processed to those in a specific non-final state, including Pending, Held, Additional Mapping, Mapping Error, VEE Ready, Defer, Error, VEE Complete, Exception, or Force Complete

   • IMD Create Date/Time From: Required. The start date and time of the time period in which initial measurements to be removed were created. For example, to remove initial measurements created between January 1, 2023 and January 31, 2023, the IMD Create Date/Time From would be "01-01-2023 12:00 AM".

   • IMD Create Date/Time To: Required. The end date and time of the time period in which initial measurements to be removed were created. For example, to remove initial measurements created between January 1, 2023 and January 31, 2023, the IMD Create Date/Time To would be "01-31-2023 12:00 AM".

   • Device Configuration: Used to restrict the initial measurements processed to those related to a specific device configuration.

4. Click Save. The request will then open in the Request portal.

5. Click Submit Batch to process the request.

Initially requests are created in the "Pending" status. When the request is run (by clicking Submit Batch), a batch process based on the batch control defined on the request type is executed.

• If the batch process errors, the request Status is set to the "Batch Error".

• If the batch process completes, the request Status is set to the "Completed".

Details of the process are captured in the Submission Information section, and the Object Log zone.

The Submission Information section includes:

• Batch Submission:  Link to the batch job submission for the batch process. Click the link to navigate to the Batch Job Submission portal to view details of the batch process.

• IMD SDE Extract Through Date/Time: The date and time through which specialized data extracts have been performed for initial measurements impacted by the process.

• End of Batch Date/Time: The date and time when the batch process was completed.

The Object Log zone contains table with details regarding the initial measurements and related objects processed, including:

• Object: The type of object processed (Initial Measurement Data, Service Task, To Do Entry, or VEE Exception)

• Specialized Data Extract Occurred: An indicator as to whether or not ("Yes" or "No") occurred for initial measurement data

• Count: The number of objects processed.

Example:

Batch Control

The Remove Non-Final IMDs (D1-RENFI) batch control identifies and closes or deletes unwanted initial measurements and their related objects. When run, this batch process creates a fact (using the Remove IMD Object Count (D1-RemoveIMDObjectCount) business object) that captures details regarding the batch process and the objects being removed during the process. These details are viewed in the Object Log zone in the Request portal. 

Note that the Request ID is a required parameter for this batch control, meaning that this batch control cannot be run on its own. It can be only run from an initial measurement removal request. 

Implementations can create specific versions of this batch control for use when removing specific types of data. For instance, an implementation could create a "Preview" version of this batch control, or a version used only with interval initial measurements.

Implementations can alter the processing of this batch control by creating alternate algorithms for each of the System Events used by this batch process. Refer to  Ad-hoc Processes  in the  Plug-in Driven Background Processes section for more information.

Recommendations and Warnings

• We recommend using the Preview mode to identify potential initial measurements for removal before processing a request in either the Close or Delete mode. This allows you to review and verify the data to be removed before closing or deleting it.  

• We recommend that access to this feature be limited to system administrators and other power users. Access to this feature can be restricted via the Remove IMDs Request BOAS (D1-RMIMDREQBOAS) application service.