Summary

This article covers compiling and decompiling. 


Table of Contents


This page is a tutorial for teaching how to step through the compiling and decompiling processes.

Concepts Covered

This tutorial covers the following topics:

  • Compiling the DataArchitect
  • Decompiling the DataArchitect

Compiling

Compiling a DataArchitect will produce the XML code that is used for the eClinical applications. During the Compile process, the DataArchitect is reviewed for errors in configuration and corrections can be made prior to publishing the DataArchitect to Trial Manager.

Step 1: Log into secure.datatrak.net

Open a new browser window and access “https://secure.fountayn.com" from the address bar.  Next, enter Username and Password and click the Sign In button.

Step 2: Access Trial in Trial Manager

Under the Trial Manager folder click on your Trial Manager link.  Next, click on the Trials tab.  Then, find the correct trial and click on the link.

You can use the filters to help limit the search for your trial. For example, select “Protocol” from the Trial filter and then enter in the name of your trial in the open text field or you can use an asterisk (*) to help limit searches (i.e. “a*” would give all protocols that begin with the letter ‘a’).


Step 3: Access Compile Architect Action

Find the Form Links tree on the left hand side and click the plus sign (+) next to the Design link to expand the additional links.  Next, find and click the Compile Architect link.

Step 4: Compiling the DataArchitect

Click the Browse… button associated with the DataArchitect File field and select the DataArchitect file for the trial.  Then, click the Compile button.

Step 5: Reviewing for Errors

Once the Compile is complete the Compiler Output will display below the Compile button.  If errors are found within the DataArchitect, each finding will be listed detailing the configuration error as either a warning or an error. You can then make any corrections needed and repeat the process if necessary.
These are some examples of errors in the Compile output that must be corrected in order for the trial to publish correctly:

  • DataArchitect file name does not match the trial name. No files will be committed or published
  • Error: Display Line 2: questionId ‘subjid’ was defined in the Display worksheet for ‘enroll’ but is not defined for ‘enroll’ in the Question layout – Template worksheet.
  • Error: Forms – Template Line 7: formTypeId ‘pe’ is not defined in the Form Types – definition worksheet. All forms must be defined in the Forms Type – Definition worksheet.

And an example of an error in the Compile output that does not need to be corrected in order for the trial to publish correctly:

  • Error: Codes Line 13: Reference – Key Name can not be empty.

There are also Warnings that can be listed during the compile process. These are guidelines to help you design with best practices in mind but will not affect publishing of the trial. It is ideal to have the cleanest DataArchitect possible upon initial deployment to production. The final Compiler Output desired is:

  • Compile successful: 0 errors, 0 warnings

Decompiling

Decompiling will pull the DataArchitect from Trial Manager.  Committing the DataArchitect to Trial Manager serves as a versioning system instead of storing the DataArchitect locally on your PC and when the DataArchitect is decompiled you will be able to review what a version contains.

Step 1: Log into secure.datatrak.net

Open a new browser window and access “https://secure.fountayn.com" from the address bar. Next, enter Username and Password and click the Sign In button.

Step 2: Access Trial in Trial Manager

Under the Trial Manager folder click on your Trial Manager link. Next, click on the Trials tab. Then, find the correct trial and click on the link.

You can use the filters to help limit the search for your trial. For example, select “Protocol” from the Trial filter and then enter in the name of your trial in the open text field or you can use an asterisk (*) to help limit searches (i.e. “a*” would give all protocols that begin with the letter ‘a’).


Step 3: Access Decompile Architect Action

Find the Form Links tree on the left hand side and click the plus sign (+) next to the Design link to expand the additional links. Next, find and click the Edit Architect link.

Step 4: Decompiling the DataArchitect

Click the radio button associated with the DataArchitect version you wish to open.   In the box above the versions, make sure that Open DataArchitect File is selected.  Click Go.  A download box will appear and you will have the option to either open the file directly or save it to your computer.

In Conclusion

After completing this tutorial, you should be capable of performing the following:

  • Compiling the DataArchitect
  • Decompiling the DataArchitect

Need more help?

Please visit the Fountayn Contact Information page.