Baukasten (Toolbox)¶

Der Baukasten ist eine Bibliothek vorgefertigter Formular-Bausteine. Statt jede Überschrift, jeden Hinweistext und jedes Standardfeld von Hand anzulegen, ziehst du sie aus dem Baukasten in dein Formular — fertig konfiguriert, mit sinnvoller Beschriftung und Vorgaben.

Der Baukasten ist der schnellste Weg, ein Formular zu bauen, und zugleich der bequemste Ort für eigene wiederverwendbare Bausteine.

Worum geht es?¶

Der Baukasten besteht aus Ordnern, in jedem Ordner liegen Bausteine (Items). Mitgeliefert werden diese Ordner:

Ordner	Inhalt
📑 Überschriften	Überschrift 1–3, jeweils auch mit Sprungmarke für die Seitenleiste
📝 Leittext	Absätze, Hinweise, aufklappbare Texte, HTML-Texte mit Makros
↔ Layout	Leerzellen, Trennlinien, Rahmen-Box, PDF-Viewer für Dateianlagen
✏️ Eingabefelder	Textfeld (ein- und mehrzeilig), Zahl, Währung, Datum, E-Mail, Unterschrift, Ankreuzfelder, Radio-Gruppen, Tag-Liste, E-Mail-Empfänger, Auswahlliste, Detail-Tabellen
🧩 Feldgruppen	Anschrift, Bankverbindung, Kontaktdaten, Empfängerauswahl, Briefkopf, Personen- und Firmenstammdaten, Notfallkontakt, Termin, Maße & Gewicht
▶ Schaltflächen	Schaltflächen (primär, sekundär, gefährlich, Icon, Link), die ein Skript auslösen
⚙ Standardaktionen	Speichern, Schließen, Drucken, Validieren, Zurücksetzen

Dazu kommen eigene Ordner, die ein Administrator anlegt, und — falls vorhanden — die zentralen Feldgruppen aus dem Section-Repository.

Ein Baustein fügt entweder ein Element ein oder — bei Feldgruppen — mehrere Felder auf einmal, meist mit einer Überschrift davor. Danach kannst du alles beliebig anpassen; der Baukasten gibt nur den Startpunkt vor.

Wer darf den Baukasten benutzen?

Benutzen dürfen ihn alle, die den Formular-Editor öffnen dürfen. Pflegen (Ordner und Bausteine anlegen, ändern, löschen) dürfen nur Administratoren.

Teil 1: Den Baukasten benutzen (Formular-Autor)¶

Den Baukasten öffnen¶

Öffne den Editor: Zahnrad oben rechts → Formular-Editor, dann links in der Liste Formulare das gewünschte Formular anklicken.
Am rechten Rand steht eine senkrechte Leiste mit den Reitern Baukasten, Felder, Eigenschaften und Modell.
Ein Klick auf Baukasten dockt ihn als eigene Spalte an; ein zweiter Klick schließt ihn wieder.

Einen Baustein ins Formular ziehen¶

Greife den Baustein mit der Maus.
Ziehe ihn in die Spalte Felder (Felderliste).
Eine blaue Linie zwischen zwei Feldern zeigt, wo der Baustein landet.
Lass los — der Baustein erhält einen eindeutigen Feldnamen und ist sofort ausgewählt.

Lässt du den Baustein unter dem letzten Feld los, wird er angehängt. Im Absolut- und Hybrid-Layout kannst du Bausteine auch direkt auf das Druckblatt ziehen; dann entscheidet die Position auf dem Blatt.

Feldgruppen

Eine Feldgruppe (z. B. Anschrift) legt mehrere Felder auf einmal an. Die Feldnamen bekommen ein gemeinsames Präfix (anschrift_strasse, anschrift_ort …). Ziehst du dieselbe Gruppe ein zweites Mal hinein, zählt das Präfix hoch (anschrift_2_strasse).

Eingefügten Baustein einstellen¶

Nach dem Einfügen zeigt die Spalte Eigenschaften das neue Feld. Typische erste Schritte:

Feld-ID anpassen — der technische Feldname (z. B. lieferantenname). Er wird zur Spalte in der Datenbank.
Titel anpassen — das liest der Anwender im Formular.
Bei Bedarf Pflichtfeld, Spaltenbreite, Sichtbarkeit usw. einstellen.

Was ist eine gute Feld-ID?

Kleinbuchstaben, keine Umlaute, keine Leerzeichen, Wörter mit Unterstrich trennen: kunden_email, lieferdatum, bemerkung_intern. Eine spätere Umbenennung ist möglich (Umbenennen im Kontextmenü), betrifft aber die Datenbankspalte — bei Formularen mit Daten also mit Bedacht.

Doppelklick: der Eigenschaften-Dialog¶

Doppelklicke ein Feld in der Vorschau oder in der Felderliste. Die Eigenschaften öffnen sich dann in einem großen Dialog mit Reitern (Allgemein, Sichtbarkeit, Format, Auswahl, Hilfe, Erweitert, Kommentar — je nach Feldtyp auch weitere). Schließen mit Esc oder Schließen.

Rechtsklick: Kontextmenü der Felderliste¶

Ein Rechtsklick auf einen Eintrag in der Felderliste bietet:

Eigenschaften … — den Eigenschaften-Dialog öffnen
Umbenennen … — die Feld-ID ändern
Als Pflichtfeld markieren
Nach oben / Nach unten
Duplizieren — Kopie mit neuer ID (wert1 → wert1_2)
Kopieren (Strg+C) — zum Einfügen in ein anderes Formular
Als Feldgruppe speichern … — die markierten Felder als eigenen Baustein im Baukasten ablegen
Ins Section-Repository … — die Felder als zentrale, in mehreren Formularen genutzte Feldgruppe ablegen
Löschen …

Mit gedrückter Strg- oder Umschalt-Taste markierst du mehrere Einträge auf einmal.

Teil 2: Den Baukasten pflegen (Administratoren)¶

Eigene Bausteine — ein Adressblock in eurem Hausstil, ein fester Fußzeilen-Hinweis, ein Datumsfeld mit euren Vorgaben — legst du in der Baukasten-Verwaltung an.

Die Verwaltung öffnen¶

Zahnrad → System-Administration → Formular-Bausteine → Baukasten.

Die Seite Baukasten verwalten hat drei Spalten:

Spalte	Inhalt
Ordner	alle Ordner mit Anzahl der Bausteine und Sortierung
Items	die Bausteine des gewählten Ordners
Vorschau	Vorschau und Editor des gewählten Bausteins

Einen Ordner anlegen¶

In der Spalte Ordner auf + Neu klicken.
Namen (z. B. Adressblöcke) und ein Symbol eintragen (Emoji oder ein bis drei Zeichen).
Bestätigen — der Ordner erscheint sofort.

Beim Überfahren eines Ordners erscheinen die Knöpfe ▲ ▼ (Reihenfolge), ✎ (umbenennen, Symbol ändern), 👁 / 🚫 (im Formular-Editor ein- oder ausblenden) und 🗑 (löschen samt Bausteinen).

Builtin-Ordner

Ordner und Bausteine mit dem Etikett builtin liefert KCForms mit und zieht sie bei jedem Start nach. Sie lassen sich nur deaktivieren, nicht löschen — und Änderungen daran werden beim nächsten Start überschrieben. Eigene Varianten legst du deshalb als eigenen Baustein an.

Einen Baustein anlegen¶

Ordner links wählen.
In der Spalte Items auf + Neu klicken.
Titel eintragen (z. B. „Postadresse Deutschland").
Symbol und Beschreibung sind optional — die Beschreibung erscheint als Tooltip im Formular-Editor.
Feldnamen-Vorschlag (z. B. adresse) — diese ID vergibt KCForms beim Einfügen.
Rechts das eigentliche Snippet einstellen (siehe unten) und speichern.

Eigenschaften oder JSON¶

Der Editor eines Bausteins hat zwei Reiter:

Eigenschaften — das gleiche Eigenschaften-Panel wie im Formular-Editor. Du wählst zuerst die Art des Elements (Text, Zahl, Datum, Auswahlliste, Leittext, Schaltfläche, Detail-Tabelle …); KCForms legt ein passendes Grundgerüst an, das du per Klick verfeinerst. Das ergibt garantiert ein gültiges Snippet — der empfohlene Weg.

JSON — das Snippet als Roh-JSON, für Sonderfälle. ↳ Formatieren rückt es ein; ungültiges JSON wird markiert.

Beispiel — ein Textbereich über die volle Breite:

{
  "type": "string",
  "title": "Bemerkung",
  "kc:widget": "textarea",
  "kc:colspan": "full"
}

Ein Baustein mit mehreren Feldern verwendet kc:bundle:

{
  "kc:bundle": {
    "lead":   { "type": "string", "title": "Lieferadresse", "kc:section": true },
    "fields": [
      { "name": "strasse", "schema": { "type": "string", "title": "Straße" } },
      { "name": "plz",     "schema": { "type": "string", "title": "PLZ" } },
      { "name": "ort",     "schema": { "type": "string", "title": "Ort" } }
    ]
  }
}

Solche Bausteine entstehen am einfachsten im Formular-Editor: Felder markieren, Rechtsklick → Als Feldgruppe speichern ….

Bausteine ausblenden oder löschen¶

Ausblenden (🚫) — der Baustein verschwindet im Formular-Editor, bleibt aber erhalten. 👁 blendet ihn wieder ein.
Löschen (🗑) — endgültig. Builtin-Bausteine lassen sich nur ausblenden.

Teil 3: Export & Import¶

Den Baukasten kannst du sichern, versionieren oder auf ein anderes System übertragen. Oben rechts in Baukasten verwalten:

Knopf	Wirkung
↓ Export	lädt den ganzen Baukasten als JSON-Datei herunter
+ Import (anhängen)	legt fehlende Ordner und Bausteine an; vorhandene mit gleichem Namen bleiben unverändert
⚠ Import (alles ersetzen)	löscht alle eigenen Ordner samt Bausteinen und spielt dann die Datei ein

Builtin-Ordner bleiben beim Ersetzen erhalten — sie kämen beim nächsten Start ohnehin zurück.

Vorsicht beim Ersetzen

Import (alles ersetzen) lässt sich nicht rückgängig machen. Vorher exportieren.

Häufige Fragen¶

Ich ziehe einen Baustein, aber es passiert nichts¶

Lass den Baustein in der Spalte Felder los. Kurz vorher muss die blaue Linie erscheinen; fehlt sie, steht der Mauszeiger nicht über einer gültigen Stelle.

Mein Leittext zeigt seltsamen Text¶

Das passiert, wenn kc:text als Text statt als Objekt im Snippet steht. Richtig:

{
  "type": "string",
  "kc:text": { "content": "Hier dein Text", "level": "p" }
}

Der Reiter Eigenschaften schreibt automatisch die richtige Form.

Wie versioniere ich den Baukasten?¶

Regelmäßig exportieren und die Datei in Git einchecken. Der Export ist stabil sortiert und lässt sich gut vergleichen.

Kann ich Bausteine zwischen Ordnern verschieben?¶

Nicht direkt. Snippet im Reiter JSON kopieren, im Zielordner einen neuen Baustein mit diesem JSON anlegen, den alten löschen.

Spickzettel¶

Situation	Aktion
Baukasten öffnen	Reiter Baukasten an der rechten Leiste des Formular-Editors
Baustein einfügen	in die Spalte Felder ziehen → blaue Linie → loslassen
Feld-ID ändern	Rechtsklick → Umbenennen …
Eigenschaften groß bearbeiten	Doppelklick auf das Feld
Feld duplizieren	Rechtsklick → Duplizieren
Eigene Feldgruppe anlegen	Felder markieren → Rechtsklick → Als Feldgruppe speichern …
Bausteine pflegen	System-Administration → Formular-Bausteine → Baukasten
Sicherung ziehen	Baukasten verwalten → ↓ Export