The ecml document - structure and project information
The entire document is wrapped using the opening (line 1) and closing (line 8) <ecml> tag. At the top of the document is the <meta> tag which includes within, meta information regarding your project (see below). Following the <meta> tag is where you describe your form (or forms). The example above shows a single form project and the opening <form> tag contains two simple attributes defining firstly, the number of the form (num="") and secondly, the name of the form (name="")
NOTE: Within your document, you MUST include the model section and at least one form.
The <model> tag
The <meta> tags contain meta information about your project including server location, the location of scripts which allow data to be received/sent to/from the server to/ from the mobile device.
The following example indicates a fully described <meta> section with the tags that you must include.
The model above contains four tags, the first three of which are required and explained as follows
The <submission> tag
Contains the overall details of your project and has three possible attributes as follows:
projectName="" Contains the name of your project, and this will be seen by the user when they load onto a mobile device. This is a REQUIRED attribute
allowDownloadEdits="" States whether you would allow users to modify data they download from the central server on the mobile device. This is NOT REQUIRED and if not present, defaults to false.
versionNumber="" this contains the version number of your ECML document. Should you change anything about your project, we recommend updating this -Within the EpiCollect+ mobile app an attempt to load an existing project with a higher version number will prompt users to overwrite the existing project. This is a REQUIRED attribute
The <uploadToServer> tag
Indicates the location of the scripts on your webserver for uploading data from the mobile device (see section - setting up a server). This is a REQUIRED tag
Indicates the location of the scripts on your webserver for downloading data to the mobile device (see section - setting up a server). This is a REQUIRED tag