Skip to main content

Create a Root Cause Analysis Report

availability
Platform:WebMobile
Plan Type:BasicEssentialPremiumEnterprise
User Type:RequesterFull UserAdministrator

This article explains how to create root cause analysis reports in MaintainXยฎ to document asset failures.

Requirementsโ€‹

To create root cause analysis reports, you must have root cause analysis categories and options set up for your organization. For more information, see Set Up Root Cause Analysis Categories.

Workflow Overviewโ€‹

To create a root cause analysis report, do the following:

  1. Start a Root Cause Analysis Report: Create a new report when you change an asset's status, or from scratch.
  2. Link a Work Order: Link the work order that triggered the root cause analysis to the report so you can return to the work order for more details about the asset failure.
  3. Set the Incident Period and Repair Time: Set start and end dates for the incident, and optionally, the amount of time it took to complete the repair.
  4. Document the Asset Failure: Use your root cause analysis categories and options to document why the asset failed using standard, consistent terms.
  5. Add Notes: Notes fill in important details that structured categories and options don't capture.
  6. Save the Report.

Start a Root Cause Analysis Reportโ€‹

You can start a new root cause analysis report by changing an asset's status, or you can create one from scratch from an asset or a work order.

Create a Report When You Change an Asset's Statusโ€‹

  1. Change the status of the asset that you want to start a root cause analysis report for. You can change the status from the following places:

    • From the asset details page: On the Insights tab, navigate to the Status and Meter Readings section and select a new status from the drop-down.

      Screenshot showing the asset status dropdown on the asset details page in the MaintainX web application
      Changing asset status from the asset details
    • From a work order: in the work order details, navigate to the Asset section and select a new status from the drop-down.

      Screenshot showing the asset status dropdown on the work order details page in the MaintainX web application
      Changing asset status from a work order

    The Update Asset Status dialog opens.

    Screenshot of the Update Asset Status dialog in the MaintainX web application
    The Update Asset Status dialog
  2. If you selected an Offline status, choose a Downtime Type 1.

  3. (Optional) Fill in the other fields as needed.

    If the asset is part of an asset hierarchy, you can use the Update parent and sub-assets options 2 apply the status update to more than one asset in the hierarchy. In that case, the root cause analysis report will include all the selected assets. For details, see Root Cause Analysis Reports for Asset Hierarchies.

  4. Select Update and start root cause analysis 3.

  5. The Root Cause Analysis page opens.

  6. (Optional) Select Add Work Order to link a work order to the report. For details see Link a Work Order.

  7. Enter the Start and End dates for the Incident Period and, optionally, add the Repair Time. If the work order includes time tracking, that information is auto filled in the Repair Time section. For details, see Set the Incident Period and Repair Time.

  8. Document one or more problems using the root cause analysis categories and options. For details, see Document the Asset Failure.

Create a Report from Scratchโ€‹

Create a root cause analysis report from an asset without changing the asset's status.

  1. From the sidebar, select Assets.
  2. Select an asset to view its details.
  3. On the Insights tab of the asset details, navigate to the Root Cause Analysis section and select Create New.
  4. (Optional) Select Add a Work Order to link a work order to the report. For details see Link a Work Order.
  5. Enter the Start and End dates for the Incident Period and, optionally, add the Repair Time. If the work order includes time tracking, that information is auto filled in the Repair Time section. For details, see Set the Incident Period and Repair Time.
  6. Document one or more problems using the root cause analysis categories and options. For details, see Document the Asset Failure.

Create a Report from a Work Orderโ€‹

Create a root cause analysis report from a work order without changing the asset's status. Creating a report from the work order automatically links that work order to the report.

Important

To create a report from a work order, you have to associate an asset with the work order. If there is no asset, the Root Cause Analysis section doesn't appear.

  1. From the sidebar, select Work Orders.
  2. Select a work order to view its details.
  3. Navigate to the Root Cause Analysis section and select Create New. The Root Cause Analysis page opens.
  4. Since the report is started from a work order, it automatically shows as a Linked Work Order.
  5. Enter the Start and End dates for the Incident Period and, optionally, add the Repair Time. If the work order includes time tracking, that information is auto filled in the Repair Time section. For details, see Set the Incident Period and Repair Time.
  6. Document one or more problems using the root cause analysis categories and options. For details, see Document the Asset Failure.

Link a work order to a root cause analysis report. A report can have one linked work order at a time. If you started the root cause analysis from a work order, that work order is automatically linked to the report.

  1. Create a new root cause analysis report, or open an existing report.
  2. In the Linked Work Order section, select Add Work Order.
  3. On the Link Work Order page, select from the list of Recent Work Orders, or enter a work order name, ID, or keyword in the Search Work Order field.
  4. (Optional) Apply available filters or select Add filter to narrow your search.
  5. Select the work order you want to link from the list. You can only select one work order.
  6. Select Link Work Order.
  7. The work order appears in the Linked Work Order section of the report.

If you want to link a different work order, or no longer want a work order associated with the report, you can unlink it.

Unlinking a work order doesn't delete the work order or the root cause analysis report, it removes the association between the report and the work order. A system message is added to the work order's activity history when you add or remove a link.

To unlink a work order:

  1. Open the root cause analysis report.
  2. In the Linked Work Order section, select the (close) icon next to the work order.
  3. When prompted, confirm that you want to Unlink.

Set the Incident Period and Repair Timeโ€‹

A root cause analysis report has a required Incident Period section and an optional Repair Time section.

  • Incident Period is the total time period of the incident you're documenting in the root cause analysis report.

    The incident period Start and End date fields are both required.

  • Repair Time is the portion of the incident period that technicians spent working on the asset. Normally, this is number of hours that the team logged for repairs (i.e., wrench time).

    Repair Time is optional. To add it manually to the report, select Add repair time. Then fill in the Hours and Minutes fields.

    tip

    Although Repair Time isn't required, if you include it consistently, it can be useful for seeing how much of your overall asset downtime is actually spent fixing assets.

    A big difference between the total durations of incident periods and repair times might be a sign that there are inefficiencies or scheduling problems in your repair process that you need to address.

Linked Work Orders and Repair Timeโ€‹

If you link a work order to the report, the Repair Time field is automatically filled with the total labor hours logged on that work order. The auto fill only happens when the Repair Time field is empty and won't overwrite a value you have already entered. You can edit the auto filled value in the report at any time. However, if you update the repair time from the linked work order, it won't automatically update in the report.

Document the Asset Failureโ€‹

After you create a new root cause analysis report, you can document the asset failure using the root cause analysis categories and options defined for your organization.

A root cause analysis consists of one or more problems that led to the asset failure. Each problem has a Problem Type, Failure, Cause, and one or more Actions.

OptionDescription
Problem TypesThe kind of problem, but not the specific point of failure (e.g., component wear, vibration, temperature extremes).
FailuresThe specific component or system that failed (what broke)
CausesThe underlying reason or condition that led to the failure (why it broke)
ActionsThe work you do to repair the asset and get it back online (how it was fixed).

If you add more than one category to a report, problems are grouped by category.

note

You can only choose from the categories and options that are already configured for your organization. For more information about managing categories and options, see Set Up Root Cause Analysis Categories.

To add problem descriptions to a root cause analysis report:

  1. Create a new root cause analysis report or open an existing draft.

  2. On the Root Cause Analysis page, select a problem category from the Problem Categories list.

    Screenshot of the options to select a problem category for root cause analysis in the MaintainX web application
    Selecting a problem category for root cause analysis
  3. Select a Problem Type, Failure, Cause, and one or more Actions.

    Screenshot of the options for documenting problem details in a root cause analysis report in the MaintainX web application
    Documenting problem details in a root cause analysis report
  4. (Optional) To add another problem in the same category, select Add Problem.

  5. (Optional) To add another category, select it from the Add Problem Category list. Then add one or more problems for the new category.

    Screenshot of options to add a new problem category to a root cause analysis report in the MaintainX web application
    Adding a new problem category to a root cause analysis report

Add Notes (Optional)โ€‹

Adding notes to your root cause analysis reports help you record important details about an asset failure that are hard to capture with predefined categories and options. Notes complement the structured data to provide a comprehensive description of an incident.

  • To add notes for a specific problem in a report, select Add Notes.
  • Use the Notes field at the end of the form to add general notes for the whole report.

Save the Reportโ€‹

While you're working on a root cause analysis report, select Save Draft any time to save a snapshot of your work in progress.

When the report is finished, select Save to save the final version.

note

You can save a draft even if it's missing required information, but to save the final version of the report, you must complete all required fields.

Finish a Draft Reportโ€‹

If you save a root cause analysis as a draft, you can edit it to continue or complete it.

To edit a draft report:

  1. From the Assets module, select the asset whose draft report you want to edit to view its details.

  2. On the Insights tab of the asset details, locate the draft report you want to edit and select Finish Report to open it.

  3. Edit the report as needed:

  4. Select Save Draft to save your changes, or Save if the report is complete.

Root Cause Analysis Reports for Asset Hierarchiesโ€‹

If an asset is part of an asset hierarchy (see About Asset Hierarchies), a failure might affect its parent asset or sub-assets.

To include all the affected assets in the root cause analysis report for the incident, you have to create the report when you change the asset's status (see Create a Report When You Change an Asset's Status).

In the Update Asset Status (web) / Update Status (mobile) options, select the Update parent and sub-assets option to choose the assets in the hierarchy that you want to apply the status change to.

Screenshot of the options to select affected assets from an asset hierarchy to include in a root cause analysis report (MaintainX web application)
Selecting affected assets from an asset hierarchy

When you fill out the report, the title includes a link to a list of affected assets.

Screenshot showing the link from the root cause analysis report creation screen to the list of affected assets
The root cause analysis report creation screen links to a list of affected assets

The published report lists the affected assets.

Screenshot of a published root cause analysis report displaying affected assets
The published root cause analysis report lists affected assets

An asset's root cause analysis history lists all the reports where it's either the main asset or one of the affected assets.