A datamap defines the relationship between raw data and the survey questions asked. The datamap tracks the position of each piece of data in a survey, including:
- Question labels
- Row labels
- Data values for each row (most common in ranking questions, new rows added in between)
When surveys go “live” for the first time, the static data set is generated. Some Data Processing (DP) Teams will request the data set for a survey so that they can pre-generate reports. The datamap usually should not change after this is generated. Keeping the datamap relatively similar gives the client/DP team the ability to combine data sets for analysis
In this document, we’ll learn how to verify the consistency of the data set at the launch of the survey against the data set that is generated after live changes have been made to the survey by using the datamap.
Accessing the Datamap
To access the datamap for your survey, first navigate to the project controls menu in the Portal. Then select "Data Downloads" under Report:
From the Data Downloads page, select the format in which you'd like to view your datamap:
Once selected, the datamap will display in the format you chose in a new browser tab. See below for a short description of each of the available datamap formats:
Tip: To see the column values in the Datamap (All) and Datamap (OE) downloads, you can remove "type=plain" in the report URL.
Viewing the Datamap
Regardless of which format you choose, each datamap will contain at least the basic data information for your survey. Below is an example of a fixed-width datamap, along with descriptions of each of its features:
1. Survey Element Label: Indicates the label used for the survey element when programming the survey
2. Survey Element Text & QA Codes: Indicates the text displayed and QA codes associated with the survey element.
3. Answer Labels & Text: Indicates the labels and text used for answer options in the survey.
4. Data Values: Indicates the data values and data position in the survey; each value is unique.
Verifying the Datamap
To verify that a datamap has not been affected by live survey changes, you must compare the data set from the survey launch against the data set that is generated after live changes. To do this, you’ll need to access the datamap output twice:
- From the main directory where the live survey is housed (after the survey has been launched)
- From the Temp-directory (after after making live changes, but before saving them to the live survey)
Open each datamap (old and new) using the Datamap (Fixed-Width) version. Next compare the data values between both datamaps.
All new questions added to the survey should appear at the bottom of the Temp-directory datamap as shown below.
New answer options added to the survey will appear in the corresponding element with new data value positions (which continue their numbering from the highest data value position in the datamap), as shown below.
Note: The order of the survey elements and answer options shown in the datamap may vary from the actual survey setup.
To verify that the datamap hasn’t shifted between the live survey and the live changes, use the last element’s data position in the Main directory datamap.
Compare that the data value positions match those of the corresponding element in the Temp-Directory Datamap, as shown below.
If the data value positions do not match then the datamap has shifted. Contact your programming team to resolve the issue.