====== Multi-Level Listing ======

With a [[:en:create:multilevel]], several cases/rows are created in the dataset as part of an interview:

  * One superordinate case (level 2)
  * Several subordinate cases (level 1)

The Multi-Level Listing is a function that displays the subordinate entries in the superordinate questionnaire. Respondents will then be able to edit the entries in the order they prefer. Optionally, the Multi-Level Listing allows new entries to be added and/or deleted.

**Note:** If you are using a Multi-Level Structure but would like to specify the subordinate cases and the order of processing, use the ''[[:en:create:functions:multileveldown]]'' function instead of the Multi-Level Listing.


===== Application Example ====

For example, respondents can enter all the medication that they take regularly into the list. They can then enter details about the medication (e.g. name and dosage) in the subordinate questionnaires. The data structure would then be as in the following example.

^Case^Description^Age^Gender^Medication^Dosage^
| 1|Superordinate data line | 46 | m | - | - |
| 2|First subordinate case | - | - |RamiLich| 1.25 mg |
| 3|Second subordinate case | - | - |Pantoprazole Aristo| 20 mg |
| 4|Third subordinate case | - | - |Thyronajod 75 Henning | 75 µg |

For this use case, the subordinate questionnaire would ask (only) for the name of the medication and the dosage. The Multi-Level Listing would start without entries and allow the creation and deletion of new entries.


===== Usage =====

Create the subordinate questionnaire, which is to be queried for each entry in the list, in advance. It can contain one or more pages.

  * Create a new question with the question type “Multi-Level Listing” in the **List of Questions** in a section of your choice.
  * In the new question, select the subordinate questionnaire created above under //Subordinate questionnaire//.
  * Under //Variable for the title//, enter the ID of the variable whose answer is to be displayed as a list entry (optional). In the application example above, this would be the name of the medication.
  * Save the question and drag it to a page of the superordinate questionnaire under **Compose Questionnaire**.

With the other settings in the Multi-Level Listing, you can control, among other things, whether respondents can add new cases and delete existing cases.

If you enter the ID of another variable under //Variable for description//, the content of this variable will be displayed in the list as the second line under the title of the entry.

**Tip:** You can control the display in the list very precisely if you enter an [[:en:create:questions:internal|internal variable]] there and define the content of the internal variable in the subordinate questionnaire using ''[[:en:create:functions:put]]''.

===== Creating Subordinate Cases =====

By default, the question shows an “Add” button with which you can create new subordinate cases.

The ''[[:en:create:functions:multilevelprepare]]'' function can be used to create cases in advance, which can then be selected for editing in the Multi-Level Listing. The button for adding new cases can be deactivated in this case.