Skip to content
This repository has been archived by the owner on Jun 8, 2020. It is now read-only.

Latest commit

 

History

History
20 lines (14 loc) · 1.73 KB

update-standard-forms.md

File metadata and controls

20 lines (14 loc) · 1.73 KB

This guide is intended to help anyone updating Collect forms for the Standard config. A similar procedure applies for updating App and Contact forms, so instructions for those are included as well. These steps use medic-conf so you must first have it installed. Once you have it installed, navigate to your folder with the Medic Mobile configuration.

cd {path-to-medic}/config/standard

Standard forms are created as Google Sheets to make collaborative translations easier to manage. These XLSForm files are stored in a Google Drive folder here, and exported as XLS files using medic-conf. The files to download are listed in forms-on-google-drive.json. Use the fetch-forms-from-google-drive action in medic-conf to get the forms, then follow the instructions to authenticate accordingly.

medic-conf fetch-forms-from-google-drive

Once downloaded medic-conf is used again to convert the new XLSX files into XML files, which can be uploaded to Medic Mobile instances. You can use all of the convert actions, or just the one needed for the forms that changed.

medic-conf convert-collect-forms convert-app-forms convert-contact-forms

It is good practice to commit the XML and XLSX files together for any form where more than just the version number changed in the XML.

If a new Collect build is needed, the XML files must be copied to medic-projects/tree/master/_medic-collect-flavors/standard/assets/forms before the new build is made.