...
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 the end of the page, along with examples.
Archivist pages to view 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 e.g.https://archivist.closer.ac.uk/instruments/alspac_01_rat/cc_questions.txt
A question list with sequences can be saved as a .txt from Archivist by navigating to the instrument view and then adding /mapper.txt to the web address e.g.https://archivist.closer.ac.uk/instruments/alspac_01_rat/mapper.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/alspac_01_rat/qv.txt
Question to topic mappings mappings add /tq.txt to the instrument web address e.g. https://archivist.closer.ac.uk/instruments/alspac_01_rat/tq.txt
Derived variable mappings add /dv.txt to the dataset web address e.g. https://closer-archivist.herokuapp.com/datasets/12/dv.txt
Variable to topic mappings add tv.tx to the dataset we address e.g. https://closer-archivist.herokuapp.com/datasets/12/tv.txtThe following steps can be used to upload mappings via the .txt files. Note you must notify Hayley Mills when you are carrying out these mappings using this method, so the appropriate server can be turned on first.
1) Import the sledgehammer XML
...
Dataset
...
and
...
Note: The prefix used when running Sledgehammer must be identical to the instrument prefix. This must be checked carefully as otherwise this will mean mappings will have to be redone.
Note: DDI-Flavour must be run after Sledgehammer has been run, and before importing.
Note: This step is currently run by the CLOSER team, as the dataset needs to be linked with the instrument, which is a feature yet to be added to Archivist.
2) Import the variable mappings
Admin > Datasets > search for the loaded dataset (prefix or dataset name) > Import Mappings. Both the tvlinking.txt and the dv.txt can be imported. If uploading new mapping files, these will not replace those already mapped, but will add any additional mappings.
3) Import the question mappings
Admin > Instruments > search for the questionnaire prefix > Import Mappings. Both the qvmapping.txt and tqlinking.txt can be imported. If uploading new mapping files, these will not replace those already mapped, but will add any additional mappings.
4) Check the mappings in both the dataset and instrument view.
...
instrument views
Datasets > search and select the Name of the dataset. Any mapping conflicts will appear in red.
...
Note: 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.
Format specifications
...
cc_questions.txt
Question list produced by Archivist.
...