# Replacement Causes

In this module, you can view all the Replacement Causes registered for the current asset. Each cause can be associated with components or subgroups. When maintenance is performed, the replacement cause will only be applicable to the components it is associated with.

<figure><img src="https://content.gitbook.com/content/pAbYPeH0IeVsC8b0gI87/blobs/aeC0kMrRqGTKRy8kFhs9/2025-09-03%2011_04_55-Greenshot.png" alt=""><figcaption><p>Image A</p></figcaption></figure>

#### Adding Replacement Causes

<figure><img src="https://content.gitbook.com/content/pAbYPeH0IeVsC8b0gI87/blobs/42ivyELCZs2OPsYchTuZ/2025-09-03%2011_05_12-Greenshot.png" alt=""><figcaption><p>Image B</p></figcaption></figure>

To add a replacement cause, use the *Add Replacement Cause* button, which opens a window where the required data can be entered (Image B). The information to be provided is as follows:

* Cause Code: unique code identifying the cause;
* Severity: an integer value indicating the severity of the cause;
* FMECA: flag specifying whether the current replacement cause should be considered as FMECA  (relevant breakage I want to further inspect) type or not;
* Translations: for each cause, translations must be entered both for the effects and for the cause name itself. Translations must be provided in all project languages.

<figure><img src="https://content.gitbook.com/content/pAbYPeH0IeVsC8b0gI87/blobs/skEP4CO9q2ic2OcdLKkM/2025-09-03%2011_05_28-Greenshot.png" alt=""><figcaption><p>Image C</p></figcaption></figure>

#### Associating Components and Subgroups

To associate components and subgroups with a cause, use the *Select Components and Subgroups* button highlighted in Image C. A window will open as shown in Image D, displaying the full component hierarchy and allowing you to select objects.

If a component is selected, only that object will be linked to the replacement cause. If an entire subgroup is selected, all components currently included in it and any added in the future will automatically be associated with the cause.

<figure><img src="https://content.gitbook.com/content/pAbYPeH0IeVsC8b0gI87/blobs/Tl9kQlOrPz6j10xcwzQJ/2025-09-03%2011_06_00-Greenshot.png" alt=""><figcaption><p>Image D</p></figcaption></figure>

#### Uploading Attachments

Each replacement cause can have multiple attachments associated with it. The *Attachments* button in Image C opens the view shown in Image E. Here, all attachments related to the specific cause can be managed. In addition to adding or deleting files, it is also possible to download a zip file containing all of them.

<figure><img src="https://content.gitbook.com/content/pAbYPeH0IeVsC8b0gI87/blobs/9RuvCzm0WDZTRbp83M3c/2025-09-03%2011_06_47-Greenshot.png" alt=""><figcaption><p>Image E</p></figcaption></figure>

#### Excel Catalog Upload

To upload multiple replacement causes at once, an Excel file can be used. The buttons allow you to either import an Excel file or download one containing the application’s current data.

For more information on the file structure and guidelines on how to complete it, please refer to the [dedicated documentation](https://40factory.gitbook.io/mat-webapp-1/additional-mat-modules/maintenance/excel-catalogs).
