This ADC should be apply on chapter and uses merged question to store the result of the selections.
It uses a specific database format generated by the following page
http://www.askia.com/Downloads/dev/adc/hierarchy/CSVConverter.html
This page convert a CSV file to a Javascript database.
- Chrome
- Firefox
- Safari
- Internet Explorer
- Opera
- Javascript database generated with http://www.askia.com/Downloads/dev/adc/hierarchy/CSVConverter.html
Path of the Javascript database file to include in the document. This property is dynamic, we recommend the usage of the ??ResPath?? and include the javascript file in the survey resources.
The file must be generated with http://www.askia.com/Downloads/dev/adc/hierarchy/CSVConverter.html
It contains the following code format:
Hierarchy.databases["name_of_database"] = {/* Database information */ };
Example:
Hierarchy.databases["vehicles"] = {
/* Definition of levels */
"levels" : [
{
"id" : "brand_id",
"name" : "brand",
"liveValues" : ["brand_id"]
},
{
"id" : "model_id",
"name" : "model",
"liveValues" : ["model_id", "model_code"]
},
{
"id" : "version_id",
"name" : "version"
},
{
"id" : "option_id",
"name" : "option"
}
],
/* Map name / index of table headers */
"header" : {
"brand_id" : 0,
"brand" : 1,
"model_id" : 2,
"model" : 3,
"model_code" : 4,
"version_id" : 5,
"version" : 6,
"option_id" : 7,
"option" : 8,
"id" : 9,
"code" : 10
},
/* Records. Array of lines which contains an array of columns
lines[columns[]]
*/
"records" : [
["1", "CITROEN", "7", "C2", "Mo1", "24", "VU", "1", "CDV", "1", "A1"],
["1", "CITROEN", "9", "C4", "Mo1", "24", "VU", "1", "CDV", "2", "A2"],
["1", "CITROEN", "8", "C3", "Mo1", "24", "VU", "1", "CDV", "3", "A3"],
["2", "FIAT", "20", "Ducato 30", "Mo11", "19", "van", "2", "LCV", "11", "A11"],
["2", "FIAT", "21", "Ducato 33", "Mo11", "19", "van", "2", "LCV", "12", "A12"],
["2", "FIAT", "22", "Ducato 35", "Mo11", "10", "light van", "2", "LCV", "13", "A13"]
]
};
Name of the database as it appear in the Javascript database file
Name of fields separate with coma and surround by quotes or double-quotes. It indicates the fields to save on the latest level selection.
Example:
"id", "code", "brand_id", "model_id", "model_code", "version_id", "option_id"
Prefix of all HTML input Ids where the values will be saved. It may be use if you have several instance of the Hierarchy ADC into the same page.
Example: If the field to save is "brand_id" and the prefix is "vehicle_", you must have and HTML input in your page with the id="vehicle_brand_id"
Label of the dropdown for each levels. Each level must have a display names even if it's an empty name. All names must be surrounded by a double-quotes and separate with coma.
It is require to generate the right number of dropdown
Example:
"Brands", "Models", "Versions"
or if you have four levels
"", "", "", ""
Text of the first dropdown options for each levels. All textes must be surrounded by a double-quotes and separate with coma.
Example:
"Please select a brands", "Please select a models", "Please select a versions"
Horizontal or vertical dropdowns orientation.
Default: Vertical
Size of the horizontal space between dropdown (pixel by default). Works with the horizontal orientation
Default: 15px
Indicates the width (including the unit) to use for the both the search input and the dropdown list.
Default: 300px
Indicates the size of the dropdown list. It's the number of options visible before the scroll.
Default: 10
Message to display to the non-supported browser
Default: Sorry this page uses Javascript code, please enable it
Add the input search
Possible values:
- 0 - No search
- 1 - Auto-generate search
- 2 - Custom search input
Default: 1
Id of the custom search input (when useSearch=2)
Default: ''
Text to use in the label of the search input
Name of fields separate with coma and surround by quotes or double-quotes. It's require when using search. It indicates in which fields to search.
Example:
"brand", "model"
Search at the beginning of the field value
Default: Yes
Separator of words in the input search.
Example:
If the separator is "+", the respondent have to enter it to search in different places:
"citroen + c2"
Will search "citroen" AND "c2"
Default: +
Minimum number of characters entered before to trigger the search.
Default: 2
Display first level items
Default: No
Auto select when only one result is found
Default: No
Visibility of sub-levels when not activated.
It could be: "Visible", "Hidden" or "Disabled"
Default: Visible
Maximum number of results to display in the dropdown. Set 0 for unlimited results.
This option is useful if you have a huge database.
Default: 0