> For the complete documentation index, see [llms.txt](https://docs.polyteia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.polyteia.com/formulare/erstellen/feldtypen/raster.md).

# Raster

## Was ist das?

Ein Raster ist eine Tabelle in Ihrem Formular. Sie legen die Zeilen und Spalten fest. Die Ausfüller tragen dann ihre Antworten in die Zellen ein.

### Vergleich aus dem Alltag

Stellen Sie sich eine Klassenliste vor. Links stehen die Schülernamen (Zeilen). Oben stehen die Spalten: Anwesenheit, Note, Bemerkung. Die Lehrkraft füllt für jeden Schüler jede Spalte aus. Genau so funktioniert ein Raster im Formular.

### Wann brauchen Sie das?

* Sie stellen die gleichen Fragen für mehrere Einrichtungen (z.B. Bewertungen für verschiedene Schulen oder Standorte)
* Sie wollen Daten in Tabellenform sammeln (z.B. Quartalsmeldungen, Ausstattungslisten)
* Sie brauchen eine strukturierte Übersicht (z.B. Maßnahmen mit Status und Zuständigkeit)

{% hint style="info" %}
**Gut zu wissen:** Jede Spalte kann einen eigenen Eingabetyp haben. Eine Spalte kann Text sein, eine andere eine Zahl, und eine dritte eine Auswahlliste.
{% endhint %}

***

## Raster erstellen

{% stepper %}
{% step %}

#### Raster hinzufügen

Ziehen Sie das Element **Raster** aus dem linken Bereich in Ihr Formular. Sie finden es in der Liste der Feldtypen.

Das Raster erscheint als leere Tabelle mit einer Standard-Zeile und einer Standard-Spalte.
{% endstep %}

{% step %}

#### Zeilen einrichten

Zeilen sind die linke Seite der Tabelle. Jede Zeile ist ein "Eintrag", den der Ausfüller bearbeiten soll.

**So fügen Sie Zeilen hinzu:**

1. Klicken Sie auf den Bereich **Zeilen** in der Konfiguration
2. Klicken Sie auf **Zeile hinzufügen**
3. Geben Sie den **Zeilentitel** ein (z.B. "Grundschule Nord", "Januar", "Bezirk Mitte")
4. Der **Systemname** wird automatisch erzeugt. Sie können ihn anpassen

{% hint style="info" %}
**Tipp:** Drücken Sie die Eingabetaste nach der Eingabe eines Zeilentitels. So wird automatisch eine neue Zeile hinzugefügt.
{% endhint %}

**Beispiel:** Für eine Bürgerbefragung könnten Ihre Zeilen so aussehen:

* Öffentlicher Nahverkehr
* Straßenzustand
* Grünflächen
* Sicherheit
  {% endstep %}

{% step %}

#### Spalten einrichten

Spalten definieren, welche Informationen Sie pro Zeile sammeln. Jede Spalte hat einen eigenen Eingabetyp.

**So fügen Sie Spalten hinzu:**

1. Klicken Sie auf den Bereich **Spalten** in der Konfiguration
2. Klicken Sie auf **Spalte hinzufügen**
3. Geben Sie den **Namen** der Spalte ein (z.B. "Bewertung", "Kommentar")
4. Wählen Sie den **Spaltentyp** aus der Liste

**Beispiel:** Für eine Bürgerbefragung könnten Ihre Spalten so aussehen:

* "Bewertung" (Schieberegler, 1-10)
* "Handlungsbedarf?" (Ja/Nein)
* "Anmerkung" (Langer Text)
  {% endstep %}

{% step %}

#### Zeilen und Spalten neu ordnen

Sie können die Reihenfolge der Zeilen und Spalten jederzeit ändern. Ziehen Sie ein Element an die gewünschte Stelle.
{% endstep %}
{% endstepper %}

***

## Unterstützte Spaltentypen

Jede Spalte in Ihrem Raster kann einen eigenen Eingabetyp haben. So können Sie verschiedene Arten von Informationen in einer Tabelle sammeln.

| Spaltentyp               | Beschreibung                 | Beispiel                 |
| ------------------------ | ---------------------------- | ------------------------ |
| Freitext                 | Kurze einzeilige Texteingabe | Name, Bezeichnung        |
| Langer Text              | Mehrzeilige Texteingabe      | Kommentare, Begründungen |
| Zahl                     | Numerische Eingabe           | Menge, Betrag, Alter     |
| Datum                    | Datumsauswahl mit Kalender   | Stichtag, Geburtsdatum   |
| Uhrzeit                  | Zeitauswahl ohne Datum       | Beginn, Ende             |
| Datum und Uhrzeit        | Kombinierte Auswahl          | Terminzeitpunkt          |
| E-Mail-Adresse           | Mit Formatprüfung            | Kontakt-E-Mail           |
| Telefonnummer            | Mit Formatprüfung            | Rückrufnummer            |
| URL                      | Mit Formatprüfung            | Webseiten-Link           |
| Ja/Nein                  | Umschalter                   | Zustimmung, Status       |
| Einzelauswahl (Liste)    | Ausklappmenü                 | Kategorie, Abteilung     |
| Einzelauswahl (Optionen) | Optionsfelder                | Bewertungsstufe          |
| Mehrfachauswahl          | Mehrere Optionen wählbar     | Betroffene Bereiche      |
| Schieberegler            | Visuelle Wertauswahl         | Bewertung 1-10           |

{% hint style="success" %}
**Tipp:** Wählen Sie immer den passenden Spaltentyp. Eine "Zahl"-Spalte verhindert, dass jemand Text eingibt. Eine "E-Mail"-Spalte prüft automatisch das Format.
{% endhint %}

***

## Erweiterte Funktionen

### Pflichtfelder

Sie können einzelne Spalten als Pflichtfeld markieren. Dann müssen Ausfüller in jeder Zeile einen Wert für diese Spalte eintragen.

### Bedingungen für Zeilen

Zeilen können bedingt ein- oder ausgeblendet werden. So zeigen Sie bestimmte Zeilen nur an, wenn sie relevant sind.

**Mögliche Bedingungen:**

* **Sichtbar, wenn** – Die Zeile erscheint nur unter bestimmten Voraussetzungen
* **Versteckt, wenn** – Die Zeile wird unter bestimmten Voraussetzungen ausgeblendet
* **Pflicht, wenn** – Die Zeile wird unter bestimmten Voraussetzungen zur Pflicht
* **Deaktiviert, wenn** – Die Zeile wird unter bestimmten Voraussetzungen nicht bearbeitbar

{% hint style="info" %}
Mehr über Bedingungen erfahren Sie unter [Bedingungen](/formulare/erweitert/bedingungen.md).
{% endhint %}

### Bedingungen für Spalten

Auch Spalten können Bedingungen haben. So können Sie bestimmte Spalten nur anzeigen, wenn sie gebraucht werden.

### Validierung pro Spalte

Sie können für jede Spalte eigene Prüfregeln festlegen. So stellen Sie sicher, dass die Eingaben korrekt sind.

{% hint style="info" %}
Mehr über Validierungsregeln erfahren Sie unter [Validierungsregeln](/formulare/erweitert/validierung.md).
{% endhint %}

***

## Praktische Beispiele

### Beispiel 1: Bürgerbefragung zur Lebensqualität

|                         | Bewertung (1-10) | Handlungsbedarf? | Anmerkung                       |
| ----------------------- | ---------------- | ---------------- | ------------------------------- |
| Öffentlicher Nahverkehr | 6                | Ja               | Taktung am Wochenende erhöhen   |
| Straßenzustand          | 4                | Ja               | Schlaglöcher in der Hauptstraße |
| Grünflächen             | 9                | Nein             |                                 |
| Sicherheit              | 7                | Nein             | Mehr Beleuchtung im Park        |

**Zeilen:** Öffentlicher Nahverkehr, Straßenzustand, Grünflächen, Sicherheit **Spalten:** Bewertung (Schieberegler), Handlungsbedarf? (Ja/Nein), Anmerkung (Langer Text)

### Beispiel 2: Quartalsweise Haushaltsmeldung

|    | Ausgaben (€) | Haushaltstitel | Freigabe erteilt? |
| -- | ------------ | -------------- | ----------------- |
| Q1 | 45.000       | Bildung        | Ja                |
| Q2 | 38.500       | Soziales       | Ja                |
| Q3 | 52.100       | Infrastruktur  | Nein              |

**Zeilen:** Quartale (Q1 bis Q4) **Spalten:** Ausgaben (Zahl), Haushaltstitel (Einzelauswahl), Freigabe erteilt? (Ja/Nein)

### Beispiel 3: Schulausstattung erfassen

|                  | Anzahl Räume | Internetanschluss | Ansprechperson                |
| ---------------- | ------------ | ----------------- | ----------------------------- |
| Grundschule Nord | 12           | Ja                | <schulleitung-nord@stadt.de>  |
| Realschule Mitte | 24           | Ja                | <schulleitung-mitte@stadt.de> |
| Gymnasium Süd    | 30           | Nein              | <schulleitung-sued@stadt.de>  |

**Zeilen:** Schulen im Bezirk **Spalten:** Anzahl Räume (Zahl), Internetanschluss (Ja/Nein), Ansprechperson (E-Mail)

***

## Tipps und Hinweise

{% hint style="success" %}
**Weniger ist mehr:** Halten Sie die Tabelle übersichtlich. 3-5 Spalten und 5-10 Zeilen sind ideal. Zu große Raster können unübersichtlich werden.
{% endhint %}

{% hint style="info" %}
**Scrollen möglich:** Bei breiten Rastern können Ausfüller seitlich scrollen. Die Zeilenüberschriften bleiben dabei links sichtbar. Auch die Spaltenüberschriften bleiben beim Scrollen nach unten sichtbar.
{% endhint %}

{% hint style="warning" %}
**Spaltentyp nach Erstellung:** Sie können den Spaltentyp auch nach der Erstellung ändern. Beachten Sie aber: Bei bereits freigeschalteten Formularen können sich bestehende Antworten ändern.
{% endhint %}

***

## Raster-Daten im Datensatz

Wenn jemand ein Formular mit Raster einreicht, werden die Daten automatisch in Ihren Datensatz übernommen. Dabei wird jede einzelne Zelle des Rasters zu einer eigenen Spalte im Datensatz.

### Wie sieht das aus?

Stellen Sie sich vor, Ihr Raster heißt "Bewertung der Einrichtungen" und hat diese Struktur:

|             | Bewertung | Handlungsbedarf? |
| ----------- | --------- | ---------------- |
| Nahverkehr  | 6         | Ja               |
| Grünflächen | 9         | Nein             |

Im Datensatz erscheinen daraus **vier einzelne Spalten** – eine für jede **Zelle**:

| Spalte im Datensatz                                        | Wert |
| ---------------------------------------------------------- | ---- |
| Bewertung der Einrichtungen: Bewertung, Nahverkehr         | 6    |
| Bewertung der Einrichtungen: Bewertung, Grünflächen        | 9    |
| Bewertung der Einrichtungen: Handlungsbedarf?, Nahverkehr  | Ja   |
| Bewertung der Einrichtungen: Handlungsbedarf?, Grünflächen | Nein |

### Das Benennungsmuster

Jede Spalte im Datensatz folgt diesem Muster:

**Rastertitel: Spaltenname, Zeilenname**

So können Sie in der Datenvorschau und in Auswertungen sofort erkennen, zu welcher Zelle ein Wert gehört.

### Reihenfolge der Spalten

Die Spalten im Datensatz sind nach **Zeilen** sortiert. Zuerst alle Spalten der ersten Zeile, dann alle Spalten der zweiten Zeile, und so weiter. Die Reihenfolge entspricht der Anordnung, die Sie im Raster festgelegt haben.

{% hint style="info" %}
**Gut zu wissen:** Sie können die Raster-Daten im Datensatz ganz normal in Auswertungen verwenden – filtern, zusammenfassen oder in Diagrammen darstellen.
{% endhint %}

***

## Häufige Fragen

**Wie viele Zeilen und Spalten sind möglich?** Es gibt kein festes Limit. Für die Benutzerfreundlichkeit empfehlen wir maximal 10 Spalten und 20 Zeilen.

**Kann ich verschiedene Spaltentypen mischen?** Ja. Jede Spalte hat einen eigenen Typ. So können Sie Text, Zahlen und Auswahlfelder in einer Tabelle kombinieren.

**Können Zeilen bedingt angezeigt werden?** Ja. Jede Zeile kann Bedingungen haben. So zeigen Sie bestimmte Zeilen nur an, wenn bestimmte Voraussetzungen erfüllt sind.

**Wo finde ich die Raster-Daten in meinem Datensatz?** Die Daten werden automatisch in den Datensatz übernommen. Jede Zelle wird zu einer eigenen Spalte mit dem Muster "Rastertitel: Spaltenname, Zeilenname". Mehr dazu im Abschnitt [Raster-Daten im Datensatz](#raster-daten-im-datensatz).

***

## Weitere Hilfe

**→** [**Feldtypen**](/formulare/erstellen/feldtypen.md) – Alle verfügbaren Feldtypen im Überblick

**→** [**Formular-Editor**](/formulare/erstellen/formular-editor.md) – Felder hinzufügen und anordnen

**→** [**Bedingungen**](/formulare/erweitert/bedingungen.md) – Felder bedingt anzeigen

**→** [**Validierungsregeln**](/formulare/erweitert/validierung.md) – Eingaben automatisch prüfen


---

# 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:

```
GET https://docs.polyteia.com/formulare/erstellen/feldtypen/raster.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
