Wie lege ich die Einstellungen eines eigenen Moduls fest?
Aktualisiert am Lesezeit: 3 Min.
Auf dieser Seite
Viele eigene Module bieten Einstellungen an, die du ohne Code änderst: Texte, Zahlen, Schalter, Auswahllisten, Farben und auch Personen, Rollen oder Gruppen. So steht zum Beispiel im Mängelmelder nicht fest im Code, wer die Meldungen bekommt. Du trägst unter Haustechniker eine Person ein, und das Modul schickt jeden Bericht an diese Person. Wechselt die Zuständigkeit, änderst du nur die Einstellung.
Info
Einstellungen ändern System-Admins und Personen, die das Modul bearbeiten oder seine Daten verwalten dürfen. Welche Einstellungen es gibt, legt das Modul selbst fest. Bietet es keine an, steht unter Modul-Parameter: „Dieses Modul hat noch keine Parameter.“
Modul-Parameter öffnen#
Öffne die Seite Moduldaten. Darf deine Rolle die Daten eines Moduls verwalten, findest du sie in der Administration unter Plattform. Als System-Admin hast du dort keinen Menüeintrag und rufst die Seite direkt auf: Hänge an die Adresse deiner Plattform /administration/module-data an.
Klick auf das Modul.
Wechsle oben auf den Reiter Modul-Parameter. Du siehst alle Einstellungen, die das Modul anbietet, mit ihrer Beschreibung.
Bearbeitest du das Modul im Modul-Studio, findest du dasselbe Formular dort unter Einstellungen → Modul-Parameter. Nach dem Speichern lädt die Vorschau neu.
Werte eintragen#
Ändere den Wert. Schalter und Auswahllisten werden sofort gespeichert, getippte Texte, Zahlen und Farben kurz nach der letzten Eingabe.
Bei einer Einstellung für Personen oder Rollen wählst du aus dem Verzeichnis bzw. aus den Rollen deiner Plattform, zum Beispiel den Haustechniker oder die Rolle Teamleitung.
Bei einer Einstellung für Gruppen klickst du auf Gruppe auswählen oder Gruppe hinzufügen und suchst die Gruppe über ihren Namen. Du findest nur Gruppen, die du selbst sehen kannst.

Willst du zum Wert zurück, den das Modul vorgibt, klick auf Auf Standard zurücksetzen und bestätige die Rückfrage mit Zurücksetzen. Der Wert wird sofort gespeichert.
Ist das Modul gerade bei jemandem geöffnet, erscheint dort der Hinweis, dass sich die Einstellungen geändert haben, mit Neu laden. Danach arbeitet das Modul mit den neuen Werten.
Arten von Einstellungen#
Art | Was du einträgst | Beispiel |
|---|---|---|
Text | eine Zeile oder einen längeren Text | Überschrift der Meldeseite |
Zahl | eine Zahl, oft mit Mindest- und Höchstwert | Frist in Tagen |
Schalter | An oder Aus | Fotos verlangen |
Auswahl | einen Eintrag aus einer Liste | Standard-Priorität |
Farbe | eine Farbe | Farbe der Kopfzeile |
Person | genau eine Person aus dem Verzeichnis | Haustechniker |
Personen | mehrere Personen | Ersthelfende |
Rolle | genau eine Rolle der Plattform | Teamleitung, die Meldungen freigibt |
Rollen | mehrere Rollen | Rollen, die alle Meldungen sehen |
Gruppe | genau eine Gruppe | Team, das den Dienstplan bekommt |
Gruppen | mehrere Gruppen, höchstens 50 | Standorte, die informiert werden |
Wofür Personen, Rollen und Gruppen gut sind#
Empfänger: Das Modul schickt Mails oder Berichte an die eingetragene Person oder an die Mitglieder einer eingetragenen Gruppe, zum Beispiel einen Mängelbericht als PDF an den Haustechniker. Wie das funktioniert, steht unter Wie verschickt ein eigenes Modul E-Mails und PDFs?.
Zuständigkeit: Das Modul zeigt Schritte wie Freigeben oder Erledigt nur den eingetragenen Personen oder den Inhabern der eingetragenen Rollen, zum Beispiel einer zweistufigen Freigabe durch Teamleitung und Geschäftsführung. Gruppen eignen sich dafür nicht, sie legen keine Zuständigkeit fest.
Wechsel ohne Code: Neue Zuständige trägst du einfach ein. Das Modul selbst bleibt unverändert.
Warnung
Verlässt eine eingetragene Person das Unternehmen oder wird eine Rolle oder Gruppe gelöscht, fällt sie aus der Einstellung heraus. Trag dann eine neue Person, Rolle oder Gruppe ein, sonst erreicht der Bericht niemanden.
Was du wissen solltest#
Einstellungen gehören zu eurer Installation. Sie erzeugen keine neue Version des Moduls und bleiben bei Updates erhalten.
Jede Person, die das Modul nutzt, kann die Werte der Einstellungen lesen. Trag deshalb nie Passwörter, Zugangsdaten oder andere Geheimnisse ein.
Jede Änderung einer Einstellung steht mit altem und neuem Wert im Änderungsprotokoll.
Von einer eingetragenen Person erfährt das Modul nur den Namen, nie die E-Mail-Adresse. Von einer Gruppe erfährt es nur den Namen, nie die Mitglieder.