> For the complete documentation index, see [llms.txt](https://docs.ngsurvey.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ngsurvey.com/de/projects/import-export/xlsform/umfrageblatt/gruppen.md). # Gruppen Gruppen werden verwendet, um verwandte Fragen in Ihrem Formular zu organisieren. Eine Gruppe wird mit den `begin_group` und `end_group` Typen definiert. Sie können steuern, wie sich eine Gruppe verhält, indem Sie die `appearance` Spalte. ## 📄 Gruppe mit appearance: field-list Wenn Sie `field-list` als appearance einer Gruppe verwenden, erscheinen alle Fragen innerhalb der Gruppe auf demselben **gleichen Bildschirm**. Dies erzeugt ein seitenähnliches Layout, in dem Benutzer mehrere verwandte Fragen gleichzeitig beantworten können. Jede Zeile innerhalb der Gruppe wird als **einzelne Frage**behandelt, und das Gruppenlabel (falls verwendet) kann je nach Plattform als Abschnittsüberschrift angezeigt werden. Beispiel – field-list-Gruppe mit gemischten Fragetypen | Typ | name | label | appearance | erforderlich | | ------------------ | ------------ | -------------------------- | ---------- | ------------ | | begin\_group | contact | Kontaktdaten | field-list | | | text | fname | Vorname | | yes | | text | lname | Nachname | | yes | | select\_one gender | gender | Geschlecht | | | | select\_multiple | contact\_way | Bevorzugte Kontaktmethoden | | | | end\_group | | | | | ### Choices-Blatt | list\_name | name | label | | ------------ | ------ | ------- | | gender | male | Male | | gender | female | Female | | gender | other | Other | | contact\_way | E-Mail | E-Mail | | contact\_way | phone | Telefon | | contact\_way | SMS | SMS | Was passiert:\ Diese Gruppe wird als einzelne Seite mit den folgenden Feldern angezeigt: * Vorname (Text) * Nachname (Text) * Geschlecht (eine Option wählen) * Bevorzugte Kontaktmethoden (mehrere Optionen wählen) Alle Eingaben befinden sich auf einer Seite, sodass der Benutzer mehrere zusammenhängende Informationen gleichzeitig eingeben kann. ## 🔠 Gruppe mit appearance table-list Wenn Sie `appearance: table-list` auf eine Gruppe anwenden und Fragen auswählen, die dieselbe Auswahlliste teilen, können diese als Matrix/Gitter angezeigt werden – eine Zeile pro Frage, eine Spalte pro Auswahl. **survey sheet** | Typ | name | label | appearance | | --------------------------- | ------------ | ------------------------------------ | ---------- | | begin\_group | opinion\_grp | Bitte geben Sie Ihre Meinung an: | table-list | | select\_one agree\_disagree | q1 | Ich vertraue Online-Pharma-Diensten. | | | select\_one agree\_disagree | q2 | Die Website ist einfach zu bedienen. | | | select\_one agree\_disagree | q3 | Ich würde diese Plattform empfehlen. | | | end\_group | | | | **choices sheet** | list\_name | name | label | | --------------- | -------- | --------------- | | agree\_disagree | agree | Zustimmen | | agree\_disagree | disagree | Nicht zustimmen | ## ⁉️ Gruppe ohne appearance Wenn keine appearance festgelegt ist, wird die Gruppe eher wie eine strukturierte Frage mit unterschiedlichen Antworttypen behandelt. Das Label der Gruppe wird zur Hauptfrage, und jede Zeile innerhalb der Gruppe wird als separate Antwort behandelt. Beispiel – keine appearance | Typ | name | label | | ------------ | ------- | ------------------------------ | | begin\_group | contact | Geben Sie Ihre Kontaktdaten an | | text | fname | Vorname | | text | lname | Nachname | | text | address | Straßenadresse | | integer | zip | Postleitzahl | | end\_group | | | Als Bonus können Sie eine Einschränkung für die PLZ-Frage hinzufügen, um sicherzustellen, dass es sich um eine gültige US-Postleitzahl (5 Ziffern) handelt: | Typ | name | label | constraint | constraint\_message | | ------- | ---- | ------------ | ------------------- | ----------------------------------------- | | integer | zip | Postleitzahl | regex(., '^\d{5}$') | Muss eine 5-stellige US-Postleitzahl sein | Was passiert: Das Formular zeigt eine Reihe verwandter Fragen unter der Aufforderung „Geben Sie Ihre Kontaktdaten an“ an, wobei jedes Feld als Teil dieser einzelnen Aufforderung betrachtet wird. #### Zusammenfassung Das Verhalten der Gruppe ändert sich je nachdem, ob Sie die `field-list` appearance: | Appearance | Verhalten | | ---------- | ---------------------------------------------------------------------------------- | | field-list | Zeigt alle Fragen der Gruppe auf demselben Bildschirm an | | (keine) | Behandelt die Gruppe als eine einzelne Frage mit mehreren Teilen oder Unterfeldern | ## 📰 Gruppe mit appearance: field-list, die eine verschachtelte Gruppe enthält Sie können eine Gruppe mit `appearance: field-list` erstellen und andere Elemente darin platzieren, einschließlich: * einer verschachtelten Gruppe ohne appearance (die sich wie eine strukturierte mehrteilige Frage verhält) * anderen einzelnen Fragen (wie select\_one oder text) Dies ermöglicht es Ihnen, eine gesamte Seite mit verwandten Eingaben anzuzeigen und gleichzeitig von strukturierten Unterabschnitten innerhalb dieser Seite zu profitieren, wie ein Seitenlayout mit einem Block für Kontaktinformationen und einer bevorzugten Kontaktmethode In diesem Beispiel: * Die Hauptgruppe verwendet `field-list`, sodass alles auf einer Seite erscheint. * Darin befindet sich eine verschachtelte Gruppe (ohne appearance), die als Block verwandter Textfragen fungiert. * Nach der verschachtelten Gruppe gibt es eine select\_one-Frage, die fragt, wie der Befragte kontaktiert werden möchte. ### **survey sheet** | Typ | name | label | appearance | | ------------------ | ------------ | ------------------------------ | ---------- | | begin\_group | full\_block | Kontaktseite | field-list | | begin\_group | contact | Geben Sie Ihre Kontaktdaten an | | | text | fname | Vorname | | | text | lname | Nachname | | | text | address | Straßenadresse | | | integer | zip | Postleitzahl | | | end\_group | | | | | select\_one method | contact\_way | Bevorzugte Kontaktmethode | | | end\_group | | | | ### **choices sheet** | list\_name | name | label | | ---------- | ------ | ------- | | method | E-Mail | E-Mail | | method | phone | Telefon | | method | SMS | SMS | Was passiert: * Der Befragte sieht eine Seite. * Oben wird er aufgefordert, seine Kontaktdaten auszufüllen (Vorname, Nachname usw.) — diese erscheinen gruppiert, werden jedoch als Teile eines strukturierten Abschnitts behandelt. * Darunter kann er auf demselben Bildschirm seine bevorzugte Kontaktmethode wählen. Dieser Ansatz hält verwandte Informationen übersichtlich organisiert und effizient auszufüllen. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.ngsurvey.com/de/projects/import-export/xlsform/umfrageblatt/gruppen.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.