> 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.md).

# Umfrageblatt

Das Survey-Blatt ist das Herz Ihres XLSForm. Hier definieren Sie die Fragen, die in Ihrem Formular gestellt werden, deren Typen, Labels, Namen und Logik wie Skips, Relevanz und Constraints.

Jede Zeile im Survey-Blatt stellt eine Frage, eine Notiz oder eine Gruppe dar. Jede Spalte liefert Informationen darüber, wie sich diese Frage verhält.

Hier ein einfaches Beispiel, wie es aussehen könnte:

<table><thead><tr><th>Typ</th><th width="128">name</th><th>label</th><th>appearance</th><th>erforderlich</th><th>relevant</th><th>constraint</th><th>hint</th></tr></thead><tbody><tr><td>begin_group</td><td>page1</td><td>Seite mit persönlichen Informationen</td><td>field-list</td><td></td><td></td><td></td><td></td></tr><tr><td>note</td><td>startnote</td><td>Wir führen eine neue Umfrage durch. Bitte beantworten Sie die folgenden Fragen.</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>text</td><td>name</td><td>Wie ist Ihr vollständiger Name?</td><td></td><td>yes</td><td></td><td></td><td>Geben Sie Vor- und Nachname ein.</td></tr><tr><td>integer</td><td>age</td><td>Wie alt sind Sie?</td><td></td><td>yes</td><td></td><td>. >= 0 and . &#x3C;= 120</td><td>Muss zwischen 0 und 120 liegen.</td></tr><tr><td>select_one sex</td><td>gender</td><td>Welches Geschlecht haben Sie?</td><td></td><td></td><td>${age} >= 10</td><td></td><td>Wählen Sie eine Option.</td></tr><tr><td>end_group</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

## 🔑 Wichtige Spalten erklärt

1. **Typ**\
   Dies definiert, welche Art von Frage Sie stellen. Häufige Typen:

* `text` – für Texteingabe
* `integer` oder `decimal` – für Zahlen
* `select_one list_name` – für Einfachauswahl-Fragen
* `select_multiple list_name` – für Mehrfachauswahl-Fragen
* `note` – zur Anzeige statischen Texts
* `begin group` / `end group` – um Fragen in [Gruppen](/de/projects/import-export/xlsform/umfrageblatt/gruppen.md) Seiten oder Gruppen von Antworten zu organisieren

{% hint style="info" %}
`select_one gender` bedeutet, dass die Auswahlmöglichkeiten aus einer Liste mit dem Namen stammen `gender` (die im Name-Blatt definiert wird).
{% endhint %}

#### 2. Name

Dies ist der intern verwendete Variablenname. Er sollte:

* kurz und beschreibend sein
* kleingeschrieben, ohne Leerzeichen oder Sonderzeichen
* einzigartig innerhalb des Formulars sein

{% hint style="info" %}
Der Variablenname ist die Referenz, wie auf die Daten zugegriffen wird, wenn relevant- und constraint-Funktionen verwendet werden
{% endhint %}

#### 3. Label

Dies ist der Fragetext, den der Benutzer sieht. Er unterstützt auch [mehrere Sprachen](/de/projects/import-export/xlsform/umfrageblatt/mehrsprachig.md) wenn Sie eine Umfrage in mehreren Sprachen erstellen müssen (z. B., `label::English`, `label::French`).

{% hint style="info" %}
Seien Sie klar und benutzerfreundlich. Zum Beispiel: „Wie lautet Ihr aktueller Berufsbezeichnung?“
{% endhint %}

#### 4. Appearance (optional)

Die Appearance ermöglicht Ihnen, zusätzliche Eigenschaften für jedes Ihrer Elemente zu steuern. ngSurvey unterstützt mehrere [Appearance-Optionen](/de/projects/import-export/xlsform/umfrageblatt/erscheinungsbilder.md) zur Erstellung von Bewertungsskalen, Seiten, Kommentarfeldern, maskierten Eingaben oder benutzerdefinierten Ausrichtungen von Feldern. &#x20;

#### 4. Required (optional)

Auf `yes` setzen, wenn die Frage oder Antwort beantwortet werden muss, bevor fortgefahren wird. Wenn leer gelassen, ist die Frage optional&#x20;

#### 5. Relevant (optional)&#x20;

Wird für Skip Logic verwendet. Die Frage wird nur angezeigt, wenn die Bedingung erfüllt ist.

> &#x20;Beispiel: `relevant: ${age} >= 18`\
> Die Frage erscheint nur, wenn das Alter 18 oder älter ist.

#### 6. Constraint (optional)

Wird verwendet, um Antworten mit Logik zu validieren, wenn die Antwort auf einer Texteingabe basiert.

> &#x20;Beispiel: `. >= 0 and . <= 100`\
> Dies stellt sicher, dass die Eingabe zwischen 0 und 100 liegt. Das `.` repräsentiert die Antwort der aktuellen Frage.

#### 7. Hint (optional)

Hilfetext, der dem Benutzer als ? Tooltip angezeigt wird, um zu erklären, was erwartet wird, wenn er darüber schwebt.


---

# 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.md?ask=<question>&goal=<endgoal>
```

`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.