Difference between revisions of "Restore (Rollback) Structures"

From FMR Knowledge Base
Jump to navigation Jump to search
(Rollback)
Line 7: Line 7:
 
[[File:Roll1.PNG|1000px]]
 
[[File:Roll1.PNG|1000px]]
  
An alternative approach to view structure modifications is to use the left-hand menu to navigate to the '''Activity-> Structure Submissions''' page.  This page shows the modifications made to each structure, and includes structures which have been subsequently deleted from the system.  As the Structure Submissions page contains deleted structures, it is possible to perform an undelete operation from this page. [https://fmrwiki.sdmxcloud.org/View_Activity Click here to read more about this feature.]<br>
+
An alternative approach to view structure modifications is to use the left-hand menu to navigate to the '''Activity -> Structure Submissions''' page.  This page shows the modifications made to each structure, and includes structures which have been subsequently deleted from the system.  As the Structure Submissions page contains deleted structures, it is possible to perform an undelete operation from this page. [https://fmrwiki.sdmxcloud.org/View_Activity Click here to read more about this feature.]<br>
  
 
Rollback functionality is also available through the REST API function. [https://fmrwiki.sdmxcloud.org/Audit_REST_API Click here to read more about this feature.]
 
Rollback functionality is also available through the REST API function. [https://fmrwiki.sdmxcloud.org/Audit_REST_API Click here to read more about this feature.]
  
'''Note''': the Rollback feature is only available if you have the Audit settings switched on. [https://fmrwiki.sdmxcloud.org/Audit_Settings Click here to read more about this feature.]
+
'''Note''': to take full advantage of the Rollback feature it advisable that Audit Events is switched on. [https://fmrwiki.sdmxcloud.org/Audit_Settings Click here to read more about this feature.]
  
 
=Preparation=
 
=Preparation=
Line 39: Line 39:
  
 
==View Details==
 
==View Details==
The '''Modification Detail'''s box will open as shown in the image below. Again, you can use this as part of your verification process prior to performing the rollback.
+
The '''Modification Details''' box will open as shown in the image below. Again, you can use this as part of your verification process prior to performing the rollback. To view the Log Details, Log Events should be enabled in Audit Settings.  
  
  
Line 45: Line 45:
  
  
It is possible to '''Download''' a CSV log file which will also show details as in the example below. Again you can use this to check the details prior to rolling back.
+
It is possible to '''Download''' a CSV log file which will also show details as in the example below provided that Log Events has been enabled. Again you can use this to check the details prior to rolling back.
  
  

Revision as of 08:01, 10 November 2020

Overview

Fusion Metadata Registry records all modifications to structures and makes this information available to the Agency who owns the structure.

The structure modifications can be viewed in the details section which is displayed below the table of structures once you select a structure as shown below.

Roll1.PNG

An alternative approach to view structure modifications is to use the left-hand menu to navigate to the Activity -> Structure Submissions page. This page shows the modifications made to each structure, and includes structures which have been subsequently deleted from the system. As the Structure Submissions page contains deleted structures, it is possible to perform an undelete operation from this page. Click here to read more about this feature.

Rollback functionality is also available through the REST API function. Click here to read more about this feature.

Note: to take full advantage of the Rollback feature it advisable that Audit Events is switched on. Click here to read more about this feature.

Preparation

Rolling back to a previous version is not something that should be done lightly. To assist, there are a number of options to help you check before making the final action of rolling back.

Compare Revision

From the GUI, before you perform the Rollback you can use the Compare Revision option. The revision are shown on the dropdown list.


Roll2.PNG

Clicking the Compare button will open the Compare page in a new tab in your browser.


Roll3.PNG

Use the Master and Target drop down to select two Revisions to compare, the differences will be shown as is the example above.

Download Revision

This option allows you to download a zip file which will contain the structure in SDMX-XML format. This allows you to check before you decide which version you want to rollback to.

An example is shown below.


Roll4.PNG

View Details

The Modification Details box will open as shown in the image below. Again, you can use this as part of your verification process prior to performing the rollback. To view the Log Details, Log Events should be enabled in Audit Settings.


Roll5.PNG


It is possible to Download a CSV log file which will also show details as in the example below provided that Log Events has been enabled. Again you can use this to check the details prior to rolling back.


Roll6.PNG

Rollback

Lastly, having checked which version you want to rollback to, you can use the Rollback button on the View Details box. Roll7.PNG