This shows you the differences between two versions of the page.
— | en:create:simple-filters [09.11.2019 00:12] (current) – created d.aulenkamp | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Filter questions (question filter) ======= | ||
+ | If the participant' | ||
+ | |||
+ | |||
+ | ===== Define question filter ====== | ||
+ | |||
+ | To define a question filter, select the filter question in the **Question Catalog** and then click on the //Filter Question// tab under //More Settings//. A filter consists of two parts: | ||
+ | |||
+ | * In the //Filter Condition// you specify when the filter becomes active. | ||
+ | * The //Filter Effects// determines what happens when the filter becomes active. | ||
+ | |||
+ | **Important: | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | **Important: | ||
+ | |||
+ | You can define one or more filters for a question. Once a filter has been defined and the question has been saved, it is marked with a symbol ({{:: | ||
+ | |||
+ | **Note:** A filter is already saved with a click on the check mark, it is not necessary to save the question as well. However, the display in the navigation is not updated until the question is saved or another question is called. | ||
+ | |||
+ | |||
+ | ===== Filter condition ===== | ||
+ | |||
+ | A filter condition can either be true or false. | ||
+ | |||
+ | With a question filter, the filter condition refers only to the answer in the filter question. With [[: | ||
+ | |||
+ | Which variants of the filter condition are available depends on the type of question. | ||
+ | |||
+ | |||
+ | |||
+ | ===== Filter effects ===== | ||
+ | |||
+ | For the filter effects -- that is, what happens when the filter condition occurs -- the following options are uniformly available. | ||
+ | |||
+ | |||
+ | ==== Show/hide question or text ===== | ||
+ | |||
+ | Another question or text defined in the question catalog should be displayed or hidden depending on the filter condition. | ||
+ | |||
+ | **Note:** Text modules that were created under **Text modules and labels** cannot be shown or hidden with this filter condition. | ||
+ | |||
+ | In this filter navigation, use the dropdown to select a question or text from the question catalog and specify whether this is to be displayed or hidden if the filter condition applies. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | **Important: | ||
+ | |||
+ | |||
+ | === Application example ==== | ||
+ | |||
+ | * On page 1 of the questionnaire there is a Yes-No question (selection) FF01 as to whether the respondent has a smartphone. | ||
+ | * The question FF01 is defined as a mandatory question ("must be answered" | ||
+ | * On page 2 of the questionnaire (or on a later page) you have placed a question FF02 about the brand of the smartphone. This question shall only be displayed if the participant answered " | ||
+ | * In question FF01 a filter is defined under //More Settings// -> //Filter Question// as follows: | ||
+ | * Filter condition: | ||
+ | * Filter effect:\\ Show/hide question or text\\ Show [x] (otherwise hide)\\ // | ||
+ | * Confirm the filter with the check mark or save question FF01 ({{: | ||
+ | |||
+ | If the answer "No, I don't have a smartphone" | ||
+ | |||
+ | Alternatively, | ||
+ | |||
+ | * Filter condition: | ||
+ | * Filter effect:\\ show/hide question or text\\ [x] hide (show otherwise)\\ question/ | ||
+ | |||
+ | The filter guidance with positive (top) and negative (bottom) wording has the same function, provided that the filter question is a mandatory question. Otherwise, the case "-9 no answer" | ||
+ | |||
+ | If several filters compete for the display of the question FF02, hiding the question (whether by a positive or negative filter) has priority over displaying it. So if one filter wants to show the question and another filter wants to hide it, the question is __not__ shown (hidden) in the interview. | ||
+ | |||
+ | |||
+ | ==== Show/hide single items of a question ===== | ||
+ | |||
+ | Not only a complete question can be hidden, but also individual items. | ||
+ | |||
+ | * The same conditions apply as for showing/ | ||
+ | * Such a filter can only influence questions, not texts. | ||
+ | |||
+ | |||
+ | ==== Show/hide page(s) in questionnaire ===== | ||
+ | |||
+ | This filter effect leads to complete pages in the questionnaire being skipped. | ||
+ | |||
+ | **Important: | ||
+ | |||
+ | === Application example ==== | ||
+ | |||
+ | On page 2 of the questionnaire, | ||
+ | |||
+ | * Enter the page ID " | ||
+ | * Page 7 gets the page identifier " | ||
+ | * Enter a filter in the FF03 filter question in the **question catalogue** as follows: | ||
+ | * Filter condition\\ If one of the following options was selected ...\\ [x] Facebook | ||
+ | * Filter effect\\ [x] Show/hide page(s) in questionnaire\\ [x] Show [x] (otherwise hide)\\ // | ||
+ | * Confirm the filter by clicking on the check mark. | ||
+ | |||
+ | **Note:** You can specify one or more pages to display or hide. Multiple pages can be specified either separated by a comma (" | ||
+ | |||
+ | In this example, a negative wording would also be possible as an alternative to the positive wording of the filter: | ||
+ | |||
+ | * Filter condition\\ If the following options were __not__ all selected ...\\ [x] Facebook | ||
+ | * Filter effect\\ [x] Show/hide page(s) in questionnaire\\ [x] Hide (otherwise show)\\ // | ||
+ | |||
+ | It goes without saying that only those pages that are further back in the questionnaire than the page with the filter question can be hidden. | ||
+ | |||
+ | |||
+ | ==== Jump within the questionnaire ===== | ||
+ | |||
+ | After clicking on " | ||
+ | |||
+ | **Important: | ||
+ | |||
+ | **Important: | ||
+ | |||
+ | |||
+ | ==== End interview (Screenout) ===== | ||
+ | |||
+ | The interview is to be ended and a screenout text (farewell) is to be displayed. | ||
+ | |||
+ | The farewell is created beforehand as //text// in the question catalog. | ||
+ | |||
+ | ===== Test filter and solve problems ====== | ||
+ | |||
+ | To test the correct function of a filter, use the preview function under **Questionnaire**. Usually it saves a lot of time to start directly on the page with the filter question ({{: | ||
+ | |||
+ | * In debug mode, after answering the filter question, you can jump directly to the page where the filter shall become active. To do this, move the mouse over the page number in the top left corner. | ||
+ | * In debug mode you can see if the filter condition is met (after clicking " | ||
+ | |||
+ | A detailed description can be found in the [[: | ||
+ | |||
+ | If you do not find the error, please provide the following information in an online support question: | ||
+ | |||
+ | * A description of what the filter shall do | ||
+ | * That you are using a question filter (not a PHP filter) | ||
+ | * The identification of the filter question | ||
+ | * The identification(s) of the questions, texts, pages to be filtered | ||
+ | * The //Debug Information// | ||
+ | * The //Debug Information// | ||
+ | |||
+ | |||
+ | ===== Caution: Multi-level filters ====== | ||
+ | |||
+ | Question filters become active __only__ if the filter question was displayed in the questionnaire. For example: | ||
+ | |||
+ | * Question FF01 asks for ownership of a smartphone. | ||
+ | * Question FF02 is only displayed if the participant owns a smartphone and asks for the brand of the device. Question FF02 is itself a filter question with 2 filters: | ||
+ | * If the brand " | ||
+ | * If the brand " | ||
+ | |||
+ | Problems now arise if the participant indicates that he does not have a smartphone. Then question FF02 (brand) is not displayed at all. Their filters are not active and both the " | ||
+ | |||
+ | The solution is to add another filter to question FF01 (possession of a smartphone): |