About the Work Management Adapter

If an SAP Maintenance Plan has a Task List that has Operations and Object Lists that meet the criteria defined in the context file, when you run the Work Management Adapter in the APM Connect Administration Center, one or more Task records will be created in GE Digital APM. The corresponding Task record will be created based on the configuration defined in the context file.

If you modify a Maintenance Plan and then run the Work Management Adapter again, the corresponding Task record will be updated automatically in GE Digital APM. Likewise, if you add an Order to the Maintenance Plan, the corresponding Task record will also be updated automatically in GE Digital APM.

When you run the Work Management Adapter, it creates Tasks in GE Digital APM using the following items in SAP:

• Operations

• Object Lists

For example, suppose you have a Maintenance Plan with two Operations and two Object Lists. When you run the Work Management Adapter, six Tasks will be created and associated with the particular asset in GE Digital APM as show in the following image:

When transferring Work Management data from SAP to GE Digital APM, the Desired Interval field is populated with a null value. The Next Date field will populate with the next execution date of the Task (GE Digital APM) or Operation (SAP) when it is transferred to GE Digital APM.

Note: Last Date and Next Date values are calculated in SAP, not in GE Digital APM.

The following chart includes the possibilities for the Last Date and Next Date fields upon transferring data from SAP to GE Digital APM Task records:

The Work Management Adapter creates GE Digital APM Inspection or Calibration Tasks from SAP Operations on the Task List from the following plan types:

• Single Cycle: Time-Based
• Single Cycle: Performance-Based
• Strategy Plan: Time-Based
• Strategy Plan: Performance-Based
• Multiple Counter Plan

If a Task record was created from SAP data and you modify the SAP data in a way that causes that Task record to become obsolete, you can run the Work Management Job to resolve the differences.

When you run the adapter, the Tasks in APM are validated against the Operations in SAP. The adapter will search for Task records in GE Digital APM and Operations in SAP to determine associations based on the following values: Equipment or Functional Location, Maintenance Plan, Maintenance Plan Item, Task List, and Operation. If a Task record in GE Digital APM is found in SAP, it is determined to be valid. If the Task record in GE Digital APM is not found in SAP, it will be discontinued. The adapter updates the Task record in GE Digital APM as follows:

• The Task ID for the record will be set to **DISCONTINUED**.

• The value in the Reason field will be prepended with the following:

  <Date> - <User ID> - <Previous Task ID> was discontinued due to changes in SAP. The previous Task ID was <Previous Task ID>.

  Where <Date> is the UTC date and time on which the Task ID was set to **DISCONTINUED** and <User ID> is the user name of the user updating the record.

  For example, suppose a Calibration Task record was created from an Operation with the control key ZMI2. If you later change the control key and run the report, the Calibration Task record will be discontinued.

Note: When a Task ID in a Task record has been set to **DISCONTINUED**, if you run Work Management Adapter again and the data is still not valid, the Task record will be skipped. In other words, its Reason field will not contain more than one instance of the text **DISCONTINUED**.

Note: If you modify the SAP data so that it corresponds to the existing discontinued Task record, running the adapter will reactivate the discontinued Task record.

When the scheduled item that GE Digital APM delivers for the purpose of creating SAP Orders is executed, the GE Digital APM system performs a calculation on the Next Date and Call Horizon values in all Task records. The calculated result is passed into the query Get Tasks for Work Order Generation. If the result meets the criteria defined for the query column ([Task].[Next Date] - [Task].[Call Horizon]), the Task record meets the remaining criteria defined in the query, and the Task does not already contain a value in the Work Order Number field, an Order will be created from the Task record.

Using the baseline query, an SAP Order will be created if the Task record meets all query criteria (i.e., the Maintenance Plan field does not contain a value) and the calculated result meets the following criteria:

Task Next Date - Task Call Horizon = A date between the Last Executed Date and the Next Execution Date of the scheduled item.

Example

Suppose the scheduled item contains the following values:

Last Executed Date	Next Execution Date
July 1, 2008 1:00:00 A.M.	July 2, 2008 1:00:00 A.M.

Based on these values, an SAP Maintenance Order will be created automatically if the Next Date of the Task record minus its Call Horizon is between July 1, 12:00:00 A.M. and July 2, 12:00:00 A.M.

Suppose a Task record contains the following values:

Next Date	Call Horizon
July 11, 2008 3:00:00 A.M.	10

Using these Task record values, if you subtract the Call Horizon, 10 days, from the Next Date, July 11, 2008 3:00:00 A.M., the result is July 1, 2008 3:00:00 A.M.

Because July 1, 2008 3:00:00 A.M. falls between the Last Executed Date of July 1, 2008 1:00:00 A.M. and July 2, 2008 1:00:00 A.M., the Task record will be used to generate an Order (assuming that the Task record meets the remaining query criteria).

In other words:

July 11, 2008 3:00:00 A.M. (Task Next Date) - 10 (Call Horizon) = July 1, 2008 3:00:00 A.M. (A date between the Last Executed Date and the Next Execution Date of the scheduled item)

Note: If the scheduled item is being executed for the first time, GE Digital APM assumes a Last Executed Date of 1/1/1900. Also, if the Call Horizon field does not contain a value, the value is treated as zero (0).