> For the complete documentation index, see [llms.txt](https://docs.ninox.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ninox.com/builder-hub/de/visualize-and-organize-your-data/create-and-customize-pages/calendar-component.md).

# Kalender-Komponente

Organisiere datumsbasierte Datensätze in einem Kalenderlayout.

Organisiere datumsbasierte Datensätze mit einer **Kalenderkomponente**.

Bevor du die Komponente hinzufügst, stelle sicher, dass die Tabelle Folgendes enthält:

* ein Feld vom Typ **Datum** oder **Termin**
* ein Textfeld zur Identifikation des Datensatzes
* Felder zum Filtern relevanter Datensätze

## Kalenderkomponente hinzufügen

{% stepper %}
{% step %}
**Tab Hinzufügen öffnen**

Öffne im **Einstellungsbereich** den Tab **Hinzufügen**.
{% endstep %}

{% step %}
**Kalender hinzufügen**

Ziehe die Komponente **Kalender** aus **Ansichten** an die gewünschte Stelle auf der Seite.
{% endstep %}

{% step %}
**Komponente benennen**

Die **Bezeichnung** und der **Interne Name** werden automatisch erstellt. Du kannst sie unter **Einstellungen** bei Bedarf ändern.
{% endstep %}

{% step %}
**Kalender manuell konfigurieren**

Unter **Verhalten**:

* Lasse **Konstant** als Datenpunktoption ausgewählt.
* Wähle die Quell-**Tabelle**.
* Bestimme das Feld mit dem **Datum**, das bestimmt, wo der Eintrag im Kalender angezeigt wird. Das kann auch ein Feld vom Typ **Termin** sein.
* Bei Bedarf wähle unter **Karten konfigurieren** Felder für den **Titel**, ein anzuzeigendes **Bild** oder die **Farbe** der Karte.
  {% endstep %}

{% step %}
**Kalender prüfen**

Prüfe, ob die Datensätze an den richtigen Daten erscheinen. Ziehe die Komponente, um sie zu verschieben. Nutze die Anfasser, um ihre Größe anzupassen.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Um eine Komponente zu entfernen, wähle sie aus und klicke im blauen Menü darüber auf <i class="fa-trash-can">:trash-can:</i> **Komponente löschen**.
{% endhint %}

## Einstellungen der Kalenderkomponente

In **Einstellungen** legst du die grundlegenden Details fest:

* **Bezeichnung** zeigt den Titel der Komponente.
* **Interner Name** wird automatisch ausgefüllt. Ändere ihn nur bei Bedarf und mit Bedacht. Skripte verwenden den Internen Namen, nicht die Bezeichnung.

Unter **Verhalten** konfigurierst du den Kalender:

* **Datenpunkt** stellt die Datenbeschaffung ein. Verwende **Konstant**, um sie mit Steuerelementen zu konfigurieren oder **Logik**, um ein Ninox Skript zu verwenden.\
  \
  Wenn **Datenpunkt** auf **Konstant** gesetzt ist:
* **Tabelle** wählt die Quelltabelle.
* **Datum** wählt das Datums- oder Terminfeld für die Kalendereinträge.
* **Jährlich wiederkehrend** wählst du aus, wenn du ein Datum dieses Typs anzeigst, zum Beispiel Geburtstage.
* **Filtern** begrenzt die Datensätze, die Nutzer anhand einer oder mehrerer Bedingungen sehen können.
* Klicke auf **Karten konfigurieren**, um das folgende zu konfigurieren:
  * **Titel** legt ein Feld mit Textinhalt für den Titel des Kalendereintrags fest.
  * **Bild** zeigt eine Miniaturansicht des Inhalts eines Dateifelds im Eintrag an.
  * **Farbe** unterscheidet Kategorien anhand der Kartenfarbe. Du kannst Farb- oder Auswahlfelder verwenden.
  * Wähle weitere Felder aus, deren Inhalte auf der Karte angezeigt werden sollen.
* **Kalendertyp** wählt als Standardansicht **Monat**, **Woche** oder **Tag**.
* **Kalenderansichtsauswahl anzeigen** zeigt eine Auswahlliste für Monat, Woche und Tag.
* **Suchfeld anzeigen** zeigt ein Suchfeld über dem Kalender.\
  \
  Wenn **Datenpunkt** auf **Logik** gesetzt ist:
* Füge in **Logik** das Ninox Skript für den Datenabruf hinzu.\
  In diesem Fall erwartet Ninox die Werte und optionalen Layout-Einstellungen als Schlüssel-Wert-Paare im JSON-Stil in geschweiften Klammern `{...}`.\
  \
  Der Kalender benötigt ein Array von Ereignisobjekten. Jedes Objekt benötigt:
  * `date`, erstellt mit `format(date, "yyyy-MM-dd")`.\
    Optional:
  * `title` für die Bezeichnung.
  * `color` für die Kartenfarbe.\
    \
    Ein Beispiel dafür findest du im nächsten Absatz.

{% hint style="info" %}
Der bedingte Datenabruf unterstützt keine Drag-and-drop- oder Klickaktionen. Nutzer können Kalendereinträge nicht verschieben oder öffnen.
{% endhint %}

Unter **Sichtbarkeit** wählst du, wie die Komponente auf der Seite angezeigt wird:

* **Sichtbar** zeigt die Komponente auf der Seite.
* **Versteckt** blendet die Komponente auf der Seite aus.
* **Bedingt** definiert eine **Sichtbarkeitsbedingung**, die steuert, wann die Komponente angezeigt oder ausgeblendet wird.\
  Nutze **Bedingt**, wenn der Kalender nur in bestimmten Fällen erscheinen soll.\
  Erstelle die Bedingung anhand von **Feldern** und **Tabellen**.\
  Dies wirkt sich nur auf die Anzeige auf der Seite aus. Datensätze und Berechtigungen bleiben unverändert.

{% hint style="info" %}
Nutze für **Logik** unter **Datenpunkt** Ninox AI im [Funktionen des Logik-Editors](/ninox-scripting/de/automate-your-workflows/explore-core-scripting-elements/logic-editor-features.md), um ein Skript zu erstellen oder ein vorhandenes Skript erklären zu lassen.
{% endhint %}

#### **Schauen wir uns ein Beispiel an:**

Wenn du den Datenabruf über **Logik** ausführst, strukturiere das Skript so:

{% code lineNumbers="true" %}

```
for r in select kunden do
	{
		Datum: r.besuchsdatum
	}
end
```

{% endcode %}

Nutze Ninox AI mit folgendem Prompt, um ein solches Skript zu erstellen:\
"Zeige mir die Besuchsdaten aller Kunden."


---

# 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.ninox.com/builder-hub/de/visualize-and-organize-your-data/create-and-customize-pages/calendar-component.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.
