> 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/mehrsprachigkeit.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/darstellungen.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ngsurvey.com/de/projects/import-export/xlsform/umfrageblatt.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.