Metadata Conversion is the process of creating a new H2 Program by using the configurations of an existing H1 Program as a base. This new H2 Program will re-use as many of the original components as possible, including: Data Elements for Questions and Scores, Sharing Settings, Organisation Units access and the structure of the Assessment.
However, as H2 is designed differently, there will be some additional that need to be performed in order to ensure the new Program works as expected when used by the supervisors.
This is a conversion guide, follow the steps described below to convert any H1 Program to H2. Refer to this guide if you encountered any problems during this process.
Locating the Metadata Conversion Feature
This feature can only be found in the homepage (Programs List page) of the PCA. You can access it by clicking the three-dot menu at the far-right of any HNQIS 1.X Program displayed on the list (see Image 1).
Please Note:
This option is only available for Programs labeled as HNQIS 1.X, every other Program’s three-dot menu will display different options from the ones displayed in Image 1.
Converting a H1 Program
After clicking the Convert the HNQIS 2.0 Program option from any H1 Program, a new window will appear displaying some settings and a preview of the new Program that will be created (see Image 2).
This window displays the name of the selected Program at the top, followed by two settings:
A switch for enabling/disabling Competency Classes in the Program.
A dropdown for selecting the Health Area of the Program.
Both settings can be changed later by editing the Program, however, a Program Health Area must be selected in this step.
Additional to the mentioned settings, a preview of the converted checklist is displayed. Every block represents a Section in the Assessment, displaying the Section name and the amount of Data Elements contained in the section. Clicking on the arrow icon located at the far-right will expand the section, displaying its contents (see Image 4).
Please Note:
H2 Programs aren’t able to emulate H1 Tabs, meaning that a section is created for every Assessment header (from the original H1 program). Each Section is named using the following format: Tab name - Header Name.
There’s also a special Section at the bottom of every other Section in the Assessment, which contains all the Score Data Elements of the Checklist (see Image 5).
Clicking the arrow icon on the far-right will expand the section displaying the Scores structure (see Image 6).
In some checklists you may notice that the scores would follow a sequence like [ …, 1.8, 1.9, 1.11, 1.12, … ], skipping the number ten (see Image 7). This is due to the way Compositive Indicators (the score number) were used by the original HNQIS App and it won’t represent any issues when converting. However, this will represent an issue later that requires some additional tweaking to the converted Program.
After checking the end result, the Program can be converted by clicking the Convert to HNQIS 2.0 button (see Image 8). This will display a small window with some warnings and specifying that the new Program will keep as many configurations from the original Program as possible (see Image 9).
Clicking the Yes, continue button will start the conversion process, indicated by a loading bar (see Image 10).
Once the process is finished, a notification is displayed and the Programs List is filtered to show both the original and the new versions of the checklist (see Image 11). A [HNQIS2] tag will be appended at the beginning of the new Program’s name.
Please Note:
The new H2 Program will share as many configurations from the original H1 Program as possible, this includes: Organisation Units, Sharing Settings, Program Name, Program Short Name, Program Code, Color and Icon.
The H1 Program has been converted to H2, but it still isn’t prepared for new data capture. To see what is next check Steps After Converting a H1 Program.
Add Comment