Startseite Propstack x Paperless Integration 2.4 Dynamische Templates mit Sichtbarkeitsregeln

2.4 Dynamische Templates mit Sichtbarkeitsregeln

In Paperless kannst du Inhalte in Verträgen mithilfe von Regeln dynamisch steuern – also ein- oder ausblenden, je nachdem, welche Eingaben durch den Empfänger gemacht werden.
Das sorgt für ein intuitiveres Ausfüllerlebnis und eine effizientere Vertragsverwaltung.

Im folgenden Beispiel zeigen wir dir, wie sich Vertragsinhalte automatisch anpassen, abhängig davon, welche Option in einem Auswahlfeld gewählt wurde.

💡 Voraussetzung: Damit du Regeln nutzen kannst, muss das Modul „Rules Engine“ in deinem Workspace unter „Erweiterungen“ aktiviert sein.

Du findest hier ein ausführliches Erklärungsvideo sowie weiter unten im Artikel eine Schritt-für-Schritt-Anleitung mit Beispiel-Code.

Schritt-für-Schritt Anleitung

Zielsetzung: Je nachdem, ob im Radio-Feld angegeben wurde „Es wurden keine Mängel festgestellt“ oder „Es wurden Mängel festgestellt“ [1], soll darunter der Datensatz mit der Dokumentationsmöglichkeit der Mängel angezeigt werden oder nicht [2].

  • Wenn „Es wurden keine Mängel festgestellt“ → soll der Datensatz nicht angezeigt werden

  • Wenn „Es wurden Mängel festgestellt“ → soll der soll der Datensatz angezeigt werden

Voraussetzungen und Umsetzung

Damit die sogenannte bedingte Sichtbarkeit korrekt funktioniert, sind zwei Schritte notwendig:

  1. Vergabe sinnvoller Slugs für das Radio-Feld und seine Optionen

  2. Hinterlegen des passenden JavaScript-Codes im Low-Code Editor

Anpassung der Slugs

Damit du im zweiten Schritt mit deinem Code den richtigen Block ansprichst - in dem Fall die festgestellten Mängel, ist es wichtig, dass dieser Block einen sinnvollen Namen hat. Wenn du den Block anwählst, erscheint oben rechts der generisch vergebene Name des Blocks. Diesen kannst du sinngemäß anpassen.

In diesem Beispiel verwenden wir den Slugnamen maengel

💡 Slugs dürfen keine Umlaute, Großbuchstaben oder Leerzeichen enthalten.

Als Nächstes benennst du die Slugs der Radio-Optionen um. Um diese Slugs umzubenennen, klicke bitte rechts auf "Erweitert".

Auch hier ist bereits ein generisch vergebener Slug hinterlegt.

Wir benennen die Slugs wie folgt um:

  • maengel_nein → für „Es wurden keine Mängel festgestellt“

  • maengel_ja → für „Es wurden Mängel festgestellt“

Schließe die Maske, nachdem du beide Slugs angepasst hast.

Hinterlegen des Java Script Codes

Klicke nun auf den Block, der abhängig von der Auswahl angezeigt werden soll – in unserem Fall: der Mängel-Datensatz. [1]

Aktiviere unten rechts die Option „Bedingte Sichtbarkeit“ [2].

Dadurch öffnet sich automatisch der Low-Code Editor, in dem du deine Regel hinterlegst.Für dieses Beispiel lautet der Code:

blocks.maengel.options.maengel_ja.selected

Erklärung:

Der Block wird nur dann angezeigt, wenn im Radio-Feld maengel die Option maengel_ja ausgewählt wurde – also „Es wurden Mängel festgestellt“.

Neutral formuliert lautet die Regel demnach:

blocks.maengel.options.maengel_ja.selected

Regel testen

  1. Aktiviere die Vorschau (Testmodus)

    Der Block ist aktuell nicht sichtbar, da noch keine Auswahl getroffen wurde.

  2. Klicke auf "Es wurden Mängel festgestellt"

    Deine Regel funktioniert, wenn der Block jetzt sichtbar wird.

💡Die bedingte Sichtbarkeit lässt sich nicht nur mit Radio-Feldern, sondern auch mit Checkboxen kombinieren. Du kannst beliebige Elemente sichtbar machen – z. B. Datensätze, Gruppen, Textfelder oder sogar komplette Vertragsabschnitte.

Sebastian Herd
Verfasst von Sebastian Herd
Zuletzt am 16. Mai aktualisiert