Researchware, Inc.

Converting from HyperRESEARCH 4.0.3 Study

If your study file was created in HyperRESEARCH 4.0.3 (or created in HyperRESEARCH version 3 and already converted in version 4.0 - 4.0.3), HyperRESEARCH version 4.5.x will automatically update your study file when you first open it in the new version of the software.

Please save your HyperRESEARCH study under a new name indicating that it is for HyperRESEARCH version 4.5.0, because the new file format cannot be read by HyperRESEARCH version 4.0.x.

Converting from HyperRESEARCH version 2 or 3 Studies (through HyperRESEARCH version 3.7.5)

If your HyperRESEARCH study is currently in the HyperRESEARCH .hs2 study file format (HyperRESEARCH version 3 study file), you will need to convert the study file to the HyperRESEARCH '.hs4" study file format for HyperRESEARCH versions 4.0 - 4.5.

Here are the steps for converting a ".hs2" study file to the ".hs4" file format (Windows and macOS through Mojave) using the built-in "Convert Version 2-3 Study..." feature in HyperRESEARCH:

1. Launch HyperRESEARCH version 4 (HyperRESEARCH versions 4.0.3 or 4.5.0 or higher)
2. Choose Create New --> HyperRESEARCH Study
3. Choose File --> Convert Version 2-3 Study...
4. Locate, select, and open the ".hs2" HyperRESEARCH study file you wish to convert.
5. Watch the "Updating Study Name Here" for progress and any potential alerts.
6. When the conversion is done, use Save As... to save the study file with a name and to a location where you can easily locate it again.
7. Review the study file (cases and codes and source selections) before proceeding to work with your study in HyperRESEARCH 4.5.x.

Video Tutorial: Converting Version 2-3 Study to HyperRESEARCH Version 4

Troubleshooting

In order to convert the study file, HyperRESEARCH needs access to the source files. (The way code reference positions are calculated changed in HyperRESEARCH version 4.0 - 4.5, so the code references must be updated.)

HyperRESEARCH will alert you if any of the source files are "missing" (not in the location specified in the study file you are converting). Source files may go "missing" if you moved them or renamed them (or any of the folders they were nested within).

Locating "Missing" Source Files:

If you know the current location of the source files for the study you are converting, go ahead and click "Proceed."

HyperRESEARCH will present a dialog asking you to "Please locate 'Source File Name' for me."

Locate the matching source file, and click "Open."

If the source file's name or contents have changed, HyperRESEARCH will present a warning: "The file '<Chosen Source File Current Name>' appears to have the correct contents, but the name has changed. Are you sure '<Original Source File Name>' has changed to '<Chosen Source File Current Name>'?

If you are sure that the renamed source file is the correct source file, go ahead and click "OK. (Don't worry, if you make a mistake, you can use the "Update File's Location" feature in the Sources List to replace the file with the correct source file once you've found and verified it.)

When you locate the first source file on the list of missing source files, HyperRESEARCH will check the folder that source file is in to see if other "missing" source files are located within the same folder. If so, you're good to go: HyperRESEARCH will continue with the conversion process.

Source File's Content Changed

If HyperRESEARCH detects a change in the contents of your source file, it will present a different warning: "The file '<Chosen Source File>' has changed since the last time HyperRESEARCH accessed it. Any coding you've already done in this file might change position due to the file changes."

Be especially careful in updating source files that HyperRESEARCH indicates have different content (rather than file name changed or location changed)... This indicates that at some point since the study file was last saved, the text source file was edited. This can affect the start and endpoints of the text selections assigned to codes applied to that source file.

"Help! My source files are all over the place!"

If you're not sure where your source files are, or if they are organized into multiple folders, it may be best to gather them all together in HyperRESEARCH version 3.7.5 before proceeding with conversion to HyperRESEARCH version 4.

To do this, open your study in HyperRESEARCH version 3.7.5.

Use the Sources List feature to update the source file locations. Review your study thoroughly to make sure all of the source files have been located, with the codes pointing to the correct source material.

When satisfied that the study is good, use the Study Packager Tool to create a compressed "package" containing your study file and all of your source files in one place.

You can then transfer that study package (with file name extension ".hsz") to the computer where HyperRESEARCH version 4 (4.0.3 or 4.5.0) is installed 

Use the Study Packager Tool to open the study package you created in HyperRESEARCH version 4. All of the source files are already located and contained in the study package. HyperRESEARCH will unpack the study package and perform the conversion for you.

Ask For Help!

If you have any questions or would like assistance, please contact Researchware's support team: http://researchware.com/contact/get-support.html