Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

The content of this page describes the steps that must be followed to enable data capture in converted H1 Programs. To proceed with this guide, ensure that you’ve already converted a an H1 Program to H2 using the Metadata Conversion guide.

Please Note:

The steps described in this guide can be followed before or after the Data Transfer process, you’re not required to Set Up the H2 Program logic to transfer old Assessments Data.

After Converting the Metadata from the original H1 Program to the new H2 version, some changes may be required before being able to generate the Checklist Program Rules and Analytical Objects. Some Checklists may not required require any additional tweaking, but this won’t always be the case.

Checking the Assessment Structure

In some cases you may want to change the order of the Sections generated by the Conversion, this can be done by simply dragging and dropping any Section in the Assessment Stage.

In some other cases you maw may want to remove completely one specific Section, you can also do that by clicking the three-dot menu at the far-right of every Section and the selecting Delete This Section (see Image 1).

...

Please Note:

Every tool from the PCA is available to be used in any converted H1 Program, there’s no distinction between native H2 Programs and converted H1 Programs.

Fixing Conversion Issues

Almost every issue will occur during the Validation process in the H2 Program’s Assessment Stage. Most of the issues will be related to questions length or with Feedback Order gaps (see Image 2).

...

Tip

Errors related to Feedback Order gaps are easier to fix by using the Excel Template of the Program.

The program depicted in Image 3 contains a Feedback Order gap, as shown in the Metadata Conversion step (see Image 4). Fixing that gap will generate more gaps that will also need to be fixed, this is a common issue when converting H1 Programs to H2.

...

The Feedback Order Gap must be fixed in the Score Data Element, and then all the Data Elements that contributed to that Score must be remapped (see Images 5 and 6).

...

After fixing any other Validation Errors (either by using the PCA, the Maintenance App or Importing a an Excel Template), Validate & Save your changes to enable the Set Up Programbutton.

Other Unusual Conversion Issues

  • In some older programs, Non-Critical questions do not have scores, legend, and parent questions assigned (compare with the H1 program to know if any parent questions are missing).

  • Labels are sometimes marked as Critical Questions and Compulsory. Check those fields are marked as ‘No’ and the Value Type is defined as ‘LONG_TEXT’. Also, check they do not have an Option Set assigned.

  • If the tab header text in the H1 is too long, this can cause errors when converting because the PCA appends the header text with the section name. The error will appear if the resulting text length is more or equal to 200 characters.

Building Program

After fixing any Validation Errors that may have occuredoccurred, you can proceed with the Validation and Setup steps (see Image 7).

...