Difference between revisions of "Known Issue DataStructure Wizard"

From FMR Knowledge Base
Jump to navigation Jump to search
(The Issue)
(2. Make the change locally)
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
== Overview ==
 
== Overview ==
The Data Structure Wizard can render in a manner preventing the user from moving beyond step 2 thus causing maintenance of Data Structures impossible via the wizard.
+
The Data Structure Wizard can render in a manner preventing the user from moving beyond step 2 thus causing maintenance of Data Structures impossible via the wizard. This affects all versions of FMR before version '''11.19.3'''.
  
 
In November 2024, Microsoft Edge and Google Chrome released new versions of their respective browsers with changes to their rendering policy. Due to how the browser rendering engine was changed, this may now cause an issue when using the Fusion Metadata Registry for those responsible for maintaining Structural Metadata. It does not cause an issue for those using the Registry.
 
In November 2024, Microsoft Edge and Google Chrome released new versions of their respective browsers with changes to their rendering policy. Due to how the browser rendering engine was changed, this may now cause an issue when using the Fusion Metadata Registry for those responsible for maintaining Structural Metadata. It does not cause an issue for those using the Registry.
  
 
== The Issue ==
 
== The Issue ==
The issue manifests in in the wizard for the Data Structure. On step 2, this page renders incorrectly and prevents input and the user moving to step 3. The image below shows an example of this
+
The issue manifests in in the wizard for the Data Structure step 2. The last column ( "component type" ) is rendered incorrectly with a "double arrow" control for each element. The controls at the bottom of the wizard are now no longer functional. The image below shows an example of this:
  
::[[File:FMR11 screenshot.png|Fusion Metadata Registry|500px]]
+
::[[File:DSD-Wizard-Issue.png|Step 2 of the DSD Wizard showing the issue|500px]]
  
 
== Methods to Address ==  
 
== Methods to Address ==  
Line 13: Line 13:
 
The following options are available to those responsible for deployment of a Fusion Metadata Registry:
 
The following options are available to those responsible for deployment of a Fusion Metadata Registry:
  
=== 1. Update your Fusion Metadata Registry ===
+
=== 1. Update Fusion Metadata Registry ===
This issue was addressed in release 11.19.2 of the Fusion Metadata Registry. Updating to this release or later will address the issue.
+
This issue was addressed in release '''11.19.3''' of the Fusion Metadata Registry. Updating to this release, or later, will address this issue.
  
 
=== 2. Make the change locally ===
 
=== 2. Make the change locally ===
If you do not wish to update the Registry, the fix is very simple.  
+
If you do not wish to update the Registry, the appropriate file can be modified in your deployment environment. Please follow these steps:
  
 
# Locate the file: '''dsd-wizard.js''' which is in the directory <webapp>/assets/js/pages/data
 
# Locate the file: '''dsd-wizard.js''' which is in the directory <webapp>/assets/js/pages/data
# Edit this file and navigate to line 598
+
# Edit this file.
# This will be '''incorrectly''' stated as:
+
# Navigate to line 598. This will be '''incorrectly''' stated as:
```
+
<pre>
html += "<select></td>";
+
  html += "<select></td>";
```
+
</pre>
Change this to:
+
Change this line to the following:
html += "</select></td>";
+
<pre>
```
+
  html += "</select></td>";
Note: Your users may need to refresh their browsers for this change to take effect (usually performed by pressing CTRL and F5 whilst using the DataStructure wizard or by clearing all the browser's cache)
+
</pre>
 +
 
 +
#<li value="4"> The same issue is also present on line 1511. This is '''incorrectly''' stated as:
 +
<pre>
 +
  html += "<select>";
 +
</pre>
 +
Change this line to the following:
 +
<pre>
 +
  html += "</select>";
 +
</pre>
 +
 
 +
'''Important Note:''' If you follow this approach your users will need to refresh their browsers for this change to take effect.  A page reload, with a clear cache, is usually performed by the affected users pressing CTRL and F5 whilst using the DataStructure wizard. Alternatively the users may simply clear the entire browser's cache.

Latest revision as of 06:20, 4 December 2024

Overview

The Data Structure Wizard can render in a manner preventing the user from moving beyond step 2 thus causing maintenance of Data Structures impossible via the wizard. This affects all versions of FMR before version 11.19.3.

In November 2024, Microsoft Edge and Google Chrome released new versions of their respective browsers with changes to their rendering policy. Due to how the browser rendering engine was changed, this may now cause an issue when using the Fusion Metadata Registry for those responsible for maintaining Structural Metadata. It does not cause an issue for those using the Registry.

The Issue

The issue manifests in in the wizard for the Data Structure step 2. The last column ( "component type" ) is rendered incorrectly with a "double arrow" control for each element. The controls at the bottom of the wizard are now no longer functional. The image below shows an example of this:

Step 2 of the DSD Wizard showing the issue

Methods to Address

The following options are available to those responsible for deployment of a Fusion Metadata Registry:

1. Update Fusion Metadata Registry

This issue was addressed in release 11.19.3 of the Fusion Metadata Registry. Updating to this release, or later, will address this issue.

2. Make the change locally

If you do not wish to update the Registry, the appropriate file can be modified in your deployment environment. Please follow these steps:

  1. Locate the file: dsd-wizard.js which is in the directory <webapp>/assets/js/pages/data
  2. Edit this file.
  3. Navigate to line 598. This will be incorrectly stated as:
  html += "<select></td>";

Change this line to the following:

  html += "</select></td>";
  1. The same issue is also present on line 1511. This is incorrectly stated as:
  html += "<select>";

Change this line to the following:

  html += "</select>";

Important Note: If you follow this approach your users will need to refresh their browsers for this change to take effect. A page reload, with a clear cache, is usually performed by the affected users pressing CTRL and F5 whilst using the DataStructure wizard. Alternatively the users may simply clear the entire browser's cache.