Create Maintenance Plan#
Maintenance Plan.Create
Maintenance Plan.CreateTemplate
Maintenance Plan.CreateFromTemplate
Overview#
This operation is used to create a Maintenance Plan.
Setup#
No specific setup is required other than to meet the precondition of the transaction.
Preconditions#
- The Maintenance Plan name must be unique.
Sequence of Steps#
There are several ways to create a new versioned object. Depending on the level, follow these steps to get started:
- Entity - in the landing page of this entity type in the Business Data menu or in the details page of an existing entity of the same type, select New on the top ribbon. For more information, see Creating Entity Objects.
- Revision - if you want to create a new revision, go to the New dropdown button on the top ribbon and select Revision. For more information, see Revisions.
- Version - if you want to create a version associated to an existing revision, go to the New dropdown button on the top ribbon and select Version. For more information, see Versions.
Step 1: Change Set#
- Choose an existing Change Set or select Create to create a new Change Set. If configured to support implicit Change Sets, it is also possible to check the Use Automatic Change Set option.
- Optionally, select an Approval Role.
- Optionally, set the Make Change Set Items Effective on Approval to
trueso that the Change Set items become effective when the Change Set is approved.
Info
For more information, see Create Change Set.
Step 2: General Data#
- Provide a name for the Maintenance Plan.
- If you are creating a new version, the revision that was selected when you started the process will be the revision to which this version will be associated. If you are creating a new entity or revision (with a new version associated to it), provide a name for the revision or it will be automatically generated for you. For more information on revision naming, see Revision Naming.
- Optionally, enter a description.
- Select the Maintenance Plan type. The list of possible values is taken from the lookup table Maintenance PlanType.
- Select Create to complete the operation and the new Maintenance Plan will be created.
At this point the Maintenance Plan is created but there are no Maintenance Activities defined for it. New activities can be added and existing ones can be removed by pressing the or button. Optionally, the user can choose to copy activities from another Maintenance Plans.
Step 3: Adding Maintenance Activities#
In order to create additional activities, start with the button on the top ribbon or in the center of the window. This will show a panel on the left side where the user can add the required Maintenance Activities. The details for each activity are listed on the right side panel, under several different tabs:
General Data tab#
- Enter the Name.
- Enter the description.
- Select the type.
-
Specify the schedule type, which can be:
- Adhoc
- Time Based
- Usage Based
- Usage and Time Based
Info
Time Based, Usage Based, and Usage And Time Based are scheduled automatically by the system and cannot be terminated manually by the user.
-
Specify the expected activity duration in hours.
- Specify the execution role for this activity - this represents the group of people who is authorized/qualified to perform the maintenance task.
- For activities of type Adhoc it is possible to define a Request Role. If defined, only users that belong to this role are able to request this maintenance activity.
- For activities of type Adhoc it is possible to define a lookup table as Root cause source that the user must specify when closing the Adhoc MAO.
- Specify whether the approval mode is automatic or manual.
-
Define the Maintenance Type, which can be:
- Calibration
- Corrective
- Inspection
- Preventive
Info
If the Schedule Type is set as Usage Based, Time Based or Usage and Time Based, the Maintenance Type can only be Preventive, Calibration or Inspection.
-
Choose the Material Type Restriction Mode, which defines if it is still possible to track-in a Material when the Resource is down or on hold for Maintenance (only applicable to Resources of Processing Type equal to Process or Line), which can be:
- Allow None
- Allow All
- Allow Specific - you must specify the allowed Material Type (retrieved from the Material Type lookup table)
- Specify whether the Maintenance Activity Order release mode is automatic or manual.
- Specify whether the acceptance mode is automatic or manual.
- For activities of type Time Based, Usage And Time Based, and Usage Based, it is possible to define the Auto Disable After Late Due property. So the entity with which the Maintenance Plan is associated will be put on hold if the value for Late Due is reached while the MAO is yet to be performed.
-
If the activity type is Adhoc, specify whether multiple concurrent instances of the same Adhoc are allowed for the same maintenance plan instance. If the activity type is Time and/or Usage based, specify whether the Resource (or Container) will automatically be placed on hold if the activity reaches its late due. Putting the entity on hold has the following effects:
- For Resources, it will not be possible to track-in Materials to the Resource.
- For Containers, it will not be possible to associate Materials with the Container.
-
Specify whether the activity must be ignored for Scheduling purposes (more specifically if the Resource must be considered available for Scheduling for the duration of the maintenance).
Info
When determining the Calendar to be used, the system executes a specific DEE action (EvaluateCalendarForEntity) that retrieves the Calendar to use depending on the Entity type used. If a custom entity is to be used for the Maintenance Plan, this rule should be altered to accommodate it.
Schedule tab (for non-Adhoc activities)#
TimeBased / UsageAndTimeBased
-
Time due frequency scale (Monthly, Weekly, Daily or Hourly).
-
The recurrence details - depending on the time due frequency scale it can define days of the month; day of the week; hour of the day or simply hours. In same cases (Monthly and Weekly or Daily) it's possible also to define the time when the maintenance should be performed.
-
The early due and late due deltas - depending on the time due frequency scale, it can specify days or hours depending on the time due frequency.
UsageBased / UsageAndTimeBased
1. Early due - in units
2. Due - in units
3. Late due - in units
4. Counter type, which can be:
* CountExpression - use a flexible expression to increase the counter. In this case it's necessary to provide a valid Usage Based Expression (e.g. ``$Resource.IncreaseAmount`` or ``$Material.Product.ExposureIntensity``)
* CountOne - always increment the counter by one
* CountQuantityOne - increment the counter by the primary quantity
* CountQuantityTwo - increment the counter by the secondary quantity
!!! info
For more information, syntax and available options to create custom expressions, see [Expression Evaluator](../../general/expression_evaluator.md).
5. Counter event, from a pre-defined list of events
TimeBased / UsageAndTimeBased
-
Schedule mode - which defines the day when the maintenance will be scheduled, and that can be:
- AnyDay
- NextWorkingDay
- PreviousWorkingDay
Info
When using NextWorkingDay or PreviousWorkingDay it's necessary to have Calendar Days generated for the appropriate object.
-
Schedule next mode - which defines if the re-scheduling is fixed or dependent on when the activity is being re-scheduled, and that can be:
- Dependant, the counter and schedule are reset once the MAO is completed.
-
Fixed, the counter and schedule are resumed once the MAO is completed. The configuration setting
/Cmf/System/Configuration/MaintenanceManagement/UsageFixedNextMode/controls the counter and targets behavior for usage based activities:- If not defined, the counters are adjusted and the targets remain fixed.
- If defined as ResetCounters, the counters are reset to zero and the targets are adjusted.
-
For time based activities for which the schedule next mode is fixed, it's possible to specify a certain number of occurrences to schedule. Note that these occurrences are scheduled using a sliding window approach.
Execution tab#
This tab defines the main execution parameters.
- Specify whether the begin and complete mode is automatic or manual. When the begin and complete mode is automatic, it's not necessary to perform the Begin and Close Maintenance Activity Order operations, only the Perform Maintenance Activity Order.
- Optionally define a Checklist (must be of scope Maintenance Management) to be performed as part of the normal maintenance. If the begin and complete mode is manual, it's necessary to specify a Checklist to be performed.
- Optionally define a Data Collection to be performed as part of the normal maintenance.
- Optionally define a Data Collection Limit Set to be applied as part of the normal maintenance.
- Optionally define a Checklist (must be of scope Maintenance Management) to be performed as part of rework.
- Optionally define a Data Collection to be performed as part of rework.
- Optionally define a Data Collection Limit Set to be applied as part of rework.
-
If a Data Collection is defined for either normal or rework maintenance, it's possible to define a list of Charts for which data will be sent. The same integration principles as defined for Integrating EDC with SPC apply. For SPC Chart visualization there are the following different possible modes:
- AcknowledgeAlways - the Chart is always displayed and must be acknowledged by the user.
- AcknowledgeOnViolationsOnly - the Chart is only displayed in case that there is a violation and must be acknowledged by the user.
- DisplayAlways - the Chart is always displayed and but does need to be acknowledged by the user.
- DisplayOnViolationsOnly - the Chart is only displayed in case that there is a violation but does need to be be acknowledged by the user.
- None - the Chart is never displayed.
Parts tab#
The parts tab define the bill of parts, expressed as a Bill-of-Materials (BOM), for the maintenance task. It's necessary to define:
- Whether the maintenance activity can only use parts from the BOM or if the user can add additional parts.
- Define the BOM of scope Parts to be used to as the bill of parts.
Rules tab#
The rules tab defines actions which are triggered when the MAO schedule state reaches a particular schedule state.
-
For TimeBased and UsageAndTimeBased activities, the following states can have rules associated by pressing the Manage button in each of the schedule state sections:
- Time early due
- Time due
- Time late due
-
For UsageBased and UsageAndTimeBased activities, the following states can have rules associated by pressing the Manage button in each of the schedule state sections:
- Usage early due
- Usage due
- Usage late due
Info
The system ships with a Rule called SendMaintenanceManagementNotificationMail which allows alerts to be sent whenever the activity reaches that state. A Rule must be defined to ensure any notification is sent to the proper recipients defined under the Distribution List property that is defined when associating the Maintenance Plan to an available entity, thus creating a Maintenance Plan Instance. If no Distribution List is defined for the Maintenance Plan Instance, a notification will be sent to all the users that have the OwnerRole assigned. For more information, see Associate Maintenance Plan.
Note
If a Distribution List is defined, it must be well formed - it must contain valid email addresses, and if multiple email addresses are provided, they must be separated by a semicolon.
After opening the Manage Activity Rules wizard, you can add or remove rules by pressing the or buttons and selecting the appropriate rules.
Personnel tab#
The Personnel tab defines the labor requirements for the Maintenance Activity.
- Select Enable Check-In to enable Employees to check-in into the MAO.
- Select Is Restricted to only allow Employees with one of the required Certifications to check-in into the MAO.
- Select Enforce personnel requirements at perform to only allow Perform MAO to take place if all Personnel Requirements are met.
- Select Automatically check-in employee on begin to automatically check-in the current Employee when the MAO is begun.
- Select Require check-in for perform to prevent Employees which are not checked-in from Performing the MAO.
- Select Employee can check-out others on check-in to allow Employees to replace other Employees when checking-in.
- Select Log check-in activity, to add entries automatically to the Employee Timesheet.
- Select Allow manual report to allow manual labor hours to be reported for the MAO.
Specific personnel requirements can be configured by pressing the Manage button in each of the Personnel Requirements section After opening the Manage Activity Personnel Requirements wizard, you can add or remove rules by pressing the or buttons and selecting the appropriate values for:
- Certification: the required certification.
- Quantity: the quantity required for that certification.
- Allocation: the allocation for the certification, ranging between (and including):
- 0 (no allocation)
- 1 (100% allocation)
- Exclusive: whether the user can only be checked-in at this maintenance activity.
Info
If the Allocation is not set to 100%, the Exclusive flag will not be able to be set as true since the Employee will then have gaps in the assigned Allocation that must be filled. On the other hand, if the Exclusive flag is set to true, the Allocation will automatically be set to 100%.
Info
The difference between Allocation and Quantity can be understood through the following example. In order to have one (1) Employee associated to the Maintenance Activity, possible configurations can be:
| Quantity | Allocation |
|---|---|
| 1 | 1 |
| 2 | 0.5 (50% availability for each employee) |
| 4 | 0.25 (25% availability for each employee) |
| ... | ... |
Table: Allocation and Quantity configurations for Maintenance Activity Personnel Requirements
Contains tab#
This tab is used to define inclusion relationships for the Maintenance Activity. For example, if a Yearly Maintenance Activity includes a Monthly Maintenance Activity, it's possible to establish this relationship and have the system link them together automatically during runtime. There are some rules for inclusion:
- The Maintenance Activities must have the same Schedule Type and must not be Adhoc.
- Both the parent and included Maintenance Activities must be in the same Maintenance Plan version.
- The included Maintenance Activity must have a shorter cycle than the parent Maintenance Activity.
- There cannot be circular references.
- Each Maintenance Activity can only have one top-most Maintenance Activity. For example: A includes B and B includes C is valid whereas A includes B and D includes B is invalid.
- Furthermore, to allow inclusion of one Maintenance Activity in another, the following properties must be identical:
- Material Type Restriction Mode
- Material Type
- Required Material Product
- Required Material Flow
- Required Material Flow Path
- Required Material Logical Flow Path
- Required Material Step
- Qualification Service
- Post Maintenance Activity Qualification
- Requires Evaluation
- Material Evaluation Flow
- Material Evaluation Flow Path
- Material Evaluation Logical Path
- Material Evaluation Step
- Material Evaluation Results Capture Mode
- Add or remove as many Maintenance Activities as desired selecting the option Join Automatically if it's intended that the system joins the two MAOs automatically whenever there's an overlap in the schedule (given by the early due - late due interval). Note that it's always possible to join and separate the MAOs later manually.
Warning
After the creation of a version, the version will be in the state Created. To make it Active, the associated Change Set must be approved. To make it Effective, the version must be set effective.












