How does the cause and consequence section work?

The causes and consequences help us to have a deeper management of the risks that exist, being able to trace their origin and the effect they would have within the organization.

Now in Pirani causes and consequences will have a specialized section, where you will be able to create and manage your cause and consequence registers, associate them to risks and assign them a responsible to supervise in one place.

→ Remember that this module is available for ORM, AML and Compliance management systems.

How to create a cause and consequence?

Go to the left menu and go to the "Causes and consequences" section, then click on the "Create cause and consequence" button. There you will see a box where you must enter a name and choose whether you are going to create a cause or consequence.

If it is a cause: You must choose the category that indicates the origin of the risk. It can be due to: process, infrastructure, technology, external factor or human resources. 

If it is a consequence: You must choose the category that indicates how the risk will affect you. It can be: legal, economic, reputational or operational.

Then you must write a description for your cause and consequence, and finally you must click on the "Create" button to save it.

How to associate a cause and/or consequence to a risk?

You will be able to associate the cause or consequence you are creating with one or several risks. To do this, inside the create or edit box go to the left side to the "risks" section and click on the "associate" button, there you will find a list with all the risks that you have registered and you can choose one or more risks that are linked to the cause and consequence.
To make the association you must click on the "+" icon on the right side of the risk to be selected.

How to associate a responsible person?

To associate a person responsible for supervising the cause or consequence, go to the left side of the "create" box and click on the "associate" button, there you will see the list of groups responsible for the cause or consequence created or create a new group. In this section you can search for the registers with the search engine or choose from the options available in the module.
To make the association you must click on the "+" icon on the right side of the register to be selected.

How to associate a cause and/or consequence to a control?

To associate a cause or consequence to a control, you must first have a cause and consequence created and associated to a risk, then have a control associated to the risk mentioned above. After having the previous creations and associations, go to the "Controls" section and select the control to which you want to associate the cause or consequence of the risk. Then select the causes and consequences option and click on the "Associate" button, there you will find the causes and consequences that impact the risk to which the control is linked and which you could associate to the control. To associate effectively, you must click on the "+" icon of the cause or consequence of interest.

How to associate a cause and/or consequence to an event?

To associate a cause or consequence to an event, you must first have a cause and consequence created and associated to a risk, then have an event associated to the risk mentioned above. After having the above creations and associations, go to the "Events" section and select the event to which you wish to associate the cause or consequence of the risk. Then select the causes and consequences option and click on the "Associate" button, there you will find the causes and consequences that impact the risk to which the event is linked. To effectively associate, you must click on the "+" icon of the cause or consequence of interest.

How to disassociate a cause and/or consequence?

If you consider that it is no longer necessary to have a cause or consequence associated to a particular risk, you can disassociate it in two ways.

1: Go to the risks section, choose the risk of interest and click on the "Causes and consequences" option, now click on the "X" icon that appears at the bottom right of the register to be eliminated. With this action you will not be eliminating the cause or consequence in other risks but only in the one you have selected.

2: Go to the "Causes and consequences" section, choose the cause or consequence of interest and click on the "risks" option, now click on the "X" icon that appears at the bottom right of the register to be eliminated. With this action you will be eliminating the association between the cause and the risk.

How to edit a cause and/or consequence?

Go to the "cause and consequences" section, choose the cause or consequence you want to edit and click on the "see more" button, here you will see the form so you can edit any of the fields.

Remember that after editing the necessary fields you must click on "Save changes" for the edition to be successful.

How to delete a cause and/or consequence?

If you no longer wish to have the register you can delete it by clicking on the cause or consequence and a trash can icon will appear on the right side before clicking on it, remember that it will be removed from all the risks it is associated with. If you are sure, click on the delete button. 

How to perform a bulk update?

The bulk update functionality is available within the "Causes and Consequences" module.

From the "Causes and Consequences" module, click the three-dot button (...) and select the "Import" option.

Another option is to click the gear icon, select ORM or the risk management system of interest, and then choose the "Import" option.

How do you want to start the import?

Select the "Single entity" option. Once selected, click "Next" to continue with the process.

How to manage causes and consequences from a single entity?

1. Go to the "Single entity" section.
2. Select the "Causes and Consequences" module.
3. Click on the dropdown menu "What would you like to do with this entity?"
4. Choose the option that best fits your need:

• Create records from file

• Update records from file 

How to update causes and consequences from a file?

In this case, select the option "Update records from file". Then, follow these steps:

1. Make sure your Excel file is properly structured and saved in .csv format, following best practices for bulk upload files.
   
   
2. Keep in mind that it’s not necessary to include all the fields of the entity. You only need to upload the fields you want to update.
   
   
3. However, there is one mandatory field that must always be included to ensure the update is performed correctly:
   
   referenceCode: The unique identifier of the cause or consequence. This field allows the system to locate the record to be updated.
   
   
4. Once your .csv file is ready, upload it to the platform.
   
   
   

   Click "Next" to continue with the update process.

   In this step, you'll need to map the fields from your .csv file to those in the Pirani form.

   Learn how to correctly map the fields for the update:

   • The system automatically maps fields based on matching column names in your file.
     If you want to make changes, you can expand the available options in the "Form field" column.
   • If there are columns you do not want to update in the system, simply leave the checkbox unchecked next to the corresponding field name.
     Please note that some checkboxes cannot be unchecked, as those fields are mandatory.

   Once you’ve completed the field mapping, click "Upload" to start the bulk update of causes and consequences.

   
   
   

   Click "Upload" and confirm that the file has been successfully uploaded.
   You're all set! The data to be updated will now begin reflecting in the causes and consequences section.

   If you want to check the status of your upload, you can expand the details in the Import History — the most recent upload appears at the top.

   Note:

   • This process may take some time, so the status will appear as "In progress." To check if the process has finished, click the "Refresh" button.
     
     
   • If the status shows "Failed," you can expand the details to see how many records failed to update. A downloadable .csv file with error information will be available.
     For more information about this file, go to the Bulk Upload section in the Help Center.
     
     
   
   

   How do you want to start the import?

   Select the "Multiple related entities" option. Once selected, click "Next" to continue with the process.

   
   

   How to manage causes and consequences from multiple related entities?
   Go to the "Multiple related entities" section.

   Select the "Risks" entity — in this case, we define it as the parent.
   Click on the parent entity's dropdown menu "What would you like to do with this entity?"

   Choose the option that best fits your need:

   • Create records from file.
   • Update records from file.
   • Use existing records in the system.
     
     

   Next, select the "Causes and Consequences" entity.
   Click on the parent entity's dropdown menu "What would you like to do with this entity?"

   Choose the option that best fits your need:

   • Create records from file.
   • Update records from file.
     
     

Once your file is properly structured following the best practices for bulk upload files, upload the Excel file in .csv format.

Keep in mind that for a bulk update, it is not necessary to include all the fields of the entity — you can upload only the fields you want to update.

However, the following fields are mandatory:

Mandatory fields in the Excel file:

• referenceCode: Unique identifier of the cause or consequence.
  
  
• parentReferenceCode: Code that links the record to the main event.
  Since this is an update, this field is optional unless, for example, you need to reassign the cause or consequence to a different module — in that case, it becomes required.

If your file contains no errors, it will be uploaded successfully, allowing you to proceed to the next step.
Otherwise, review the file requirements found in the Help Center to ensure your upload meets the necessary conditions.

Once your causes and consequences update file is correct and you wish to continue without associating additional entities, click "Next" to begin mapping the fields in your file.

In this step, you’ll need to map the fields from your .csv file to the corresponding fields in the Pirani form.

Learn how to correctly map the fields for the update:

1. The system automatically maps fields based on matching column names in your file.
   If you wish to modify the mapping, you can open the available options in the "Form field" column.
2. If there are columns you do not want to update in the system, simply leave the checkbox next to the field name unchecked.

Note: Some checkboxes cannot be unchecked, as they are mandatory fields.

Once you’ve finished mapping the fields, click "Upload" to start the bulk update of causes and consequences.

If you want to check the status of your upload, you can expand the details in the Import History. The most recent upload appears at the top of the list.

Note:

• This process may take some time, so its status may appear as "In progress." To refresh and check whether the process has finished, click the "Refresh" button.
  
  
• If the upload status shows "Failed," you can expand the details to see how many records failed to update. A downloadable .csv file with the errors will be available. To learn more about this file, go to the Bulk Upload section in the Help Center.

How do we view the information?

To verify that the information was updated correctly, follow these steps:

1. Go to the "Risks" module.
   
   
2. Select the event you want to review.
   
   
3. In the left-hand menu, navigate to the "Causes and Consequences" section.
   
   
4. Select the specific cause or consequence you want to view — you can locate it by its code.
   
   
5. Check that the Cause or Consequence was updated correctly.
   
   

If you have any questions about this process or encounter errors during the upload, don’t hesitate to contact us by submitting a ticket or sending us a message.

You can do it now! Start managing your causes and consequences.
Don’t have the Starter plan? Schedule a demo! →