Mapping data is an exclusive Epicollect5 feature where you can assign a short identifier to each question or to each possible answer. You will have access to this functionality if your role is either CREATOR or MANAGER.
This is particularly useful when you want to download your data in CSV format and you need the column name to match an existing identifier, or some possible answer to be mapped against a number or a code. It is also possible to exclude (hide) some questions.
For example, a question like "What is your name" can be mapped against just "name"
For possible answers, if the options are like "Red", "Blue" and "Green", they could be mappend against "R", "B", "G".
Each short identifier (the 'Mapping To" field) for questions must be from 1 to 20 chars in length and can contain only alphanumeric and underscores
For possible answers, up to 150 chars and any char is accepted aside from
'<' and '>'
You can create up to 3 custom mappings and set one as the default, the one that will be used when downloading or accessing data via the API for any user who has got access to your data.
The default mapping, called "EC5_AUTO", is generated automatically by the system and cannot be modified.
See the following screenshot, showing a custom data mapping named "Map Test" we created for our EC5 Demo Project
The tabs at the top allows you to navigate across your mapping or create a new one.
Below the tabs on the right hand side, there is a for selsection dropdown to select the form to make the edits to.
Below the tabs on the right hand side there are four action buttons:
- Delete: deletes the currently selected mapping
- Rename: renames the currently selected mapping
- Make default: set the currently selected mapping as the default one (it will be "pinned") so it is loaded by default when you reload the page, and it is selected by default when downloading the data
- Update: saves all the changes you make to a mapping
Here is the downloaded data set (csv) selecting "Map Test":
Mapping child forms
By default the first form of your questionnaire is shown. To switch to a child form, click on the dropdown button at the top left and pick the form you want: