The mapping process can be less manual by using .txt files. Please send the files to Hayley Mills to load into Archivist. Once loaded you can then check the mappings. The format specifications are given at below along with examples. A list of the Archivist pages which can be used to check the mappings (and view a list of questions) can be found at the end of the page with examples.
Grid mappings and derived variable mappings currently must be completed using .txt files.
Note: Only one topic can be applied to a grid as a whole- this means that all variables mapped to a grid question must have the same topic.
It is recommended that you create only one topic mapping file first (preferably variable to topictv) as the other will be inherited once the question and variable have been mapped. Any gaps in topics can then be filled afterwards. This should prevent topic conflicts.
...
3. Topic ID (Uses Colectica topic IDs)
tq.txt
Mapping file which links topics and questions (this can be inherited using the qv and tv mappings)Mapping file which links topics and questions.
- Tab delimited
- 3 columns:
1. Questionnaire prefix with _ccs01 suffix
...
3. Dataset prefix
3. Source variable name
...
Viewing and downloading mappings
Note: you must be logged into Archivist to view the below pages.
A question list can be saved as a .txt from Archivist by navigating to the instrument view and then adding /cc_questions.txt to the web address Most .txt files can be viewed from one Instrument Export page. Navigate to Admin > Instrument exports > search for the prefix then select VIEW e.g. https://closer-archivist.closer.ac.ukherokuapp.com/admin/instruments/ncds_65_eq/cc_questions.txtA question list with sequences exports
Question to variable mappings can be saved as a .txt from Archivist by navigating to the instrument view and then adding /mapper.txt to the web address by clicking e.g. Download qv.txt
Question to topic mappings can be saved as a .txt by clicking e.g. https://archivist.closer.ac.uk/instruments/ncds_65_eq/mapper.txtA variable list Download tq.txt
Derived variable mappings can be saved as a .txt from Archivist by navigating to the dataset view and then adding /mapper.txt to the web address e.g. https://closer-archivist.herokuapp.com/datasets/130/variables.txt
Mappings (once applied) can be viewed in Archivist by navigating to either the instrument or dataset view using the following suffixes. Details of the formats for each can be found at the bottom of this page.
Question to variable mappings add /qv.txt to the instrument web address e.g.https://archivist.closer.ac.uk/instruments/ncds_65_eq/qv.txt
Question to topic mappings add /tq.txt to the instrument web address e.g. https://archivist.closer.ac.uk/instruments/ncds_65_eq/tq.txt
Derived variable mappings add /dv.txt to the dataset web address e.g. https://closer-archivist.herokuapp.com/datasets/130/dv.txt
Variable to topic mappings add tv.tx to the dataset we address e.g. https://closer-archivist.herokuapp.com/datasets/130/tv.txtby clicking e.g.e.g. dv.txt
Variable to topic mappings can be saved as a .txt by clicking e.g. e.g. tv.txt
Quesiton to variable mappings with topics included can be viewed and saved by navigating to the instrument map page. On the instrument page search for the prefix then select MAP, then click e.g. Download File, this will list; Question name, Question text, Question Topic ID, Variable name, Variable Topic ID, and Variable Label. Note it doesn't include derived variables mappings.
.txt files to download to create mappings
A question list can be saved as a .txt by clicking e.g Download cc_questions.txt
A question list with sequences can be saved as a .txt by clicking e.g. Download mapper.txt
A variable list can be saved as a .txt by clicking e.g. variables.txt (this will only be available when the dataset has been linked to the instrument)
Dataset and instrument views
...
The question-variable mappings can also be checked through Instruments > search and select the Prefix (or view) of the instrument. This will gives the questionnaire view with the variable names listed against themNote: Variables can be mapped to grid references in the mapping.txt file, but currently these will only be displayed as mapped to the gird as a whole. See table for how to map to grid cells.