Section-Repository (zentrale Feldgruppen)

Manche Feldgruppen kommen in vielen Formularen gleich vor — ein Währungsblock, Angaben zum Antragsteller, eine Bankverbindung nach Hausstandard. Das Section-Repository hält solche Gruppen zentral: Du pflegst sie an einer Stelle, und jede Änderung wirkt sofort in allen Formularen, die die Gruppe verwenden.

Abgrenzung

• Ein Baukasten-Baustein ist eine Kopiervorlage: Nach dem Einfügen gehören die Felder dem Formular; spätere Änderungen am Baustein erreichen es nicht.
• Eine Section aus dem Repository bleibt eine Referenz: Die Felder im Formular werden bei jeder Änderung der Section neu aufgebaut.
• Nicht zu verwechseln mit Section-Datasets (verschachtelte Datensätze über Abschnitte).

Eine Section anlegen

Aus einem Formular heraus (der übliche Weg):

1. Im Formular-Editor die gewünschten Felder in der Felderliste markieren (Strg/Umschalt + Klick).
2. Rechtsklick → Ins Section-Repository ….
3. Im Dialog Auswahl ins Section-Repository ablegen Anzeigename (z. B. „Bankverbindung"), Technischer Name (z. B. bankverbindung) und optional eine Beschreibung eintragen, speichern.

In der Verwaltung: System-Administration → Formular-Bausteine → Section-Repository → + Neue Section. Dort legst du mit + Feld die Felder an (Name, Beschriftung, Eigenschaften), ordnest sie mit ↑/↓ und siehst eine Vorschau. Die Liste links zeigt je Section Kennung, Version und wie oft sie verwendet wird (z. B. waehrungsmodul · v3 · 1×).

Eine Section in ein Formular einbauen

Im Formular-Editor erscheinen alle Sections im Baukasten in einer eigenen Kategorie Sections. Ziehe eine Section in die Felderliste — KCForms legt ihre Felder an und merkt sich den Einbau (kc:mountedSections).

Die Feldnamen bekommen ein Präfix (z. B. waehrung_betrag, waehrung_titel für die Überschrift). Jedes eingebaute Feld trägt kc:fromSection mit Section, Präfix und Einbau-Nummer.

Gesperrte Felder

Eingebaute Felder sind im Formular-Editor gesperrt:

• Der Eigenschaften-Dialog zeigt den Hinweis „🔒 Aus zentraler Section … — zentral verwaltet".
• Umbenennen und Löschen einzelner Felder ist nicht möglich.
• Lokale Änderungen an Eigenschaften würden bei der nächsten Aktualisierung der Section überschrieben.

Ganz entfernen lässt sich eine Section über Section entfernen im Hinweis des Eigenschaften-Dialogs — das nimmt alle Felder dieses Einbaus aus dem Formular.

Was beim Speichern einer Section passiert

1. Die Version der Section wird hochgezählt, der alte Stand als Snapshot aufbewahrt.
2. Alle Formulare, die die Section eingebaut haben, werden neu aufgebaut: Die Felder jedes Einbaus werden durch die aktuellen Section-Felder ersetzt, das Schema gespeichert und die Datenbank-Tabelle um neue Spalten ergänzt.

So wirkt eine zentrale Änderung sofort überall — Renderer, Druck, Listen und Export sehen ganz normale Felder.

Felder aus einer Section entfernen

Entfernst du ein Feld aus einer Section, verschwindet es aus allen Formularen. Die zugehörigen Spalten bleiben mit ihren Daten in den Datenbank-Tabellen stehen, werden aber nicht mehr angezeigt.

Transport

Beim Transport eines Formulars reisen die eingebauten Sections mit, damit das Formular auf dem Zielsystem vollständig ist.