> [← open.SERVICE](<open.SERVICE Plugin Overview.md>) # Ticketformulare und Benachrichtigungen Beides liegt auf einer Seite: **Formular-Konfigurationen** (`/admin/form-config`), im Administrationsbereich in der Gruppe **Ticketsystem**. Die Seite hat zwei Reiter. Für den Zugang genügt `openservice-core:can-access-admin`. ## Formular-Konfigurationen Eine Formular-Konfiguration legt fest, **welche Felder im Dialog „Ticket erstellen" erscheinen**, in welcher Reihenfolge, welche davon Pflicht sind und womit sie vorbelegt werden. Das ist der Hebel, um das Ticketsystem an eine Zielgruppe anzupassen: ein Werker, der eine Störung meldet, braucht Titel, Anlage und Beschreibung — nicht Projekt, Ausfallzeit und Einschränkung. ### Eine Konfiguration anlegen | Feld | Bedeutung | | -------------- | --------------------------------------------------------------------------- | | **Name** | nur zur Unterscheidung, z. B. „Störungsmeldung Shopfloor" | | **Priorität** | höhere Zahl gewinnt, wenn mehrere Konfigurationen passen | | **Rollen** | für wen sie gilt — **leer lassen für den globalen Standard** | | **Benutzer** | einzelne Personen, die sie bekommen sollen | Im Reiter **Felder** ordnen Sie per Drag & Drop, blenden ein und aus und setzen je Feld: - **Pflicht** - **Bezeichnung überschreiben** — „Anlage" heißt bei Ihnen vielleicht „Maschine" - **Standardwert** — wird beim Anlegen vorbelegt - bei der Priorität zusätzlich eigene **Prioritäts-Bezeichnungen** **Titel und Status sind immer sichtbar und immer Pflicht.** Einige Felder sind nicht konfigurierbar, weil das System sie selbst setzt: Nummer, Erstellt von, Übergeordnet, Geschätzt, Tatsächlich, Geschlossen, Erstellt. ### Welche Konfiguration greift Beim Öffnen des Dialogs wird in dieser Reihenfolge gesucht: 1. eine Konfiguration, die den **Benutzer** namentlich nennt (höchste Priorität zuerst) 2. eine Konfiguration, die eine seiner **Rollen** nennt 3. der **globale Standard** — die Konfiguration ohne Rollen und ohne Benutzer 4. ohne all das: die mitgelieferte Feldauswahl > [!tip] Mit dem globalen Standard anfangen > Legen Sie zuerst eine Konfiguration ohne Rollen an — sie gilt dann für alle. > Rollenspezifische Varianten kommen später dazu und gewinnen automatisch. ### QR-Codes Je Konfiguration lässt sich ein **QR-Code** drucken. Er wird an der Maschine oder der Station angebracht; wer ein Ticket anlegen will, drückt im Dialog „Ticket erstellen" auf **„QR scannen"** und bekommt genau diese Konfiguration — einschließlich der hinterlegten Standardwerte. So meldet jemand an der Anlage eine Störung mit drei Feldern, während die Instandhaltung dasselbe Ticketsystem mit dem vollen Formular benutzt. > [!warning] Ein gescannter Code gilt für jeden im Mandanten > Der Scan setzt die Konfiguration direkt — Rollen und Benutzer der Konfiguration > werden dabei nicht geprüft. Wer den Code scannt, bekommt also dieses Formular, > auch wenn die Konfiguration eigentlich für eine andere Rolle gedacht ist. > > Hinterlegen Sie in einer Konfiguration, deren Code öffentlich aushängt, deshalb > keine Standardwerte, die nicht jeder sehen soll. Zum Anlegen eines Tickets > braucht der Scannende weiterhin `openservice-ticket:can-create-ticket`. ### Regeln beim Speichern Im Reiter **Regeln** derselben Konfiguration hinterlegen Sie Aktionen, die beim Speichern ausgeführt werden, wenn eine Bedingung zutrifft — zum Beispiel: Priorität mindestens „Hoch" → **Zuweisen** an eine bestimmte Rolle. Die Zuweisung ist additiv: bestehende Zuweisungen bleiben erhalten. Regeln laufen beim Anlegen **und** beim Bearbeiten. ## Ticket-Benachrichtigungen Der zweite Reiter. Hier legen Sie fest, **wer bei der Ticket-Erstellung benachrichtigt wird**, wenn eine Bedingung zutrifft. Je Regel: eine Bedingung über die Ticketfelder und die Aktion **„Benachrichtigen"** mit zwei Angaben: - **Empfänger** — Rollen und/oder einzelne Benutzer - **Auf Startseite anzeigen** — die Nachricht erscheint auf der Startseite statt nur im Postfach > [!warning] Nur beim Anlegen > Die Regeln werden ausschließlich bei der **Erstellung** eines Tickets > ausgewertet. Das Bearbeiten eines Tickets löst keine Benachrichtigung aus. Anders als die Formular-Konfigurationen gelten diese Regeln **für den ganzen Mandanten** — sie hängen nicht an einer Rolle und werden serverseitig ausgewertet. Vergessen Sie nicht, nach Änderungen auf **Speichern** zu drücken. Jede so erzeugte Benachrichtigung trägt einen Knopf, der direkt in das Ticket springt. ## Verwandt - [[End-User/Modules/open.SERVICE/features/Tickets|Tickets]] - [[End-User/Modules/open.SERVICE/Administration/Kopfdaten und Erfassungsfelder|Kopfdaten und Erfassungsfelder]]