katilingban/mozambique-s3m-forms

UNICEF Mozambique Open Data Kit Form for Simple Spatial Survey Method (S3M) in Sofala Province # UNICEF Mozambique Open Data Kit Form for the Simple Spatial Survey Method (S3M) in Sofala Province This repository contains the Simple Spatial Survey Method (S3M) survey instrument in XLSForm and XForm standard for use in Open Data Kit developed for UNICEF Mozambique. This form (`sofala_s3m.xlsx` and `sofala_s3m.xml`) is for use in the Sofala Province Simple Spatial Survey Method (S3M). ## Usage For those wanting to test out the form on their own Android mobile devices, the following applications need to be downloaded and installed from the Google Play Store: - ODK Collect (link) - ODK Counter (link) Once these applications have been installed, there are two options for getting the Sofala S3M form onto mobile devices. 1. Using ODK Central or other similar ODK servers The XLSForm found in the `forms` directory can be uploaded to a server such as ODK Central, ONA, SurveyCTO, KoBoToolbox and the like. The form is validated and then converted into XML format which can then be retrieved from the server into mobile devices as a blank form. 2. Transfer the XML version of the form to mobile devices via USB cable connection The XML version of this form (available in the `forms` directory) can be transferred to the mobile devices (into the device’s `odk` folder) via local USB connection. This can be done by following the instructions here. Any associated media files for the forms will also need to be transferred to the mobile device. This can be done by following the instructions here. ## Workflow for form deployment to ONA via R This repository is also a `{targets}`-based, `{renv}`)-enabled, and Docker-containerised workflow for automated deployment of the form to ONA via GitHub Actions. This automation is useful during form development and testing. ## Author Ernest Guevarra ## License This work is licensed under a GNU General Public License 3 (GPL-3)