Das Plugin arbeitet im Staff-Bereich von osTicket. Die Bedienoberfläche ist das Panel in der Ticket-Ansicht. Die Beschriftungen im Panel sind englisch.
Bei jedem Ticket fügt das Plugin ein Panel über den Ticket-Tabs ein. Es enthält:
| Bereich | Inhalt |
|---|---|
| Badge Parent Ticket | Erscheint nur, wenn das Ticket mindestens ein Child hat, mit der Anzahl, zum Beispiel „Parent Ticket (3 Sub-Tickets)“. Das Badge wird unter die Ticket-Überschrift verschoben |
| Abschnitt Parent Ticket | Hat das Ticket einen Parent: Link mit Nummer und Betreff, Status und die Schaltfläche Unlink from Parent. Sonst „No parent ticket“ und die Schaltfläche Link to Parent |
| Abschnitt Child Tickets | Liste der Children mit Nummer, Betreff, Status und je einer Schaltfläche Unlink, sonst „No child tickets“. Darunter immer die Schaltfläche Create Subticket |
Die Children sind nach Erstellungsdatum aufsteigend sortiert.
tickets.php?a=open&subticket_parent=<ID des Parents>). Das Formular ist nicht vorausgefüllt.Das Plugin merkt sich die Parent-ID in der Session, sobald du die Adresse mit
subticket_parentaufrufst, und löscht sie erst, wenn in dieser Session ein Ticket angelegt wurde. Brichst du das Formular ab und legst später ein anderes Ticket an, wird dieses ebenfalls mit dem Parent verknüpft. Rufe in dem Fall das Formular über Create Subticket erneut auf oder trenne die Verknüpfung wieder.
number nach, die interne Ticket-ID funktioniert nicht.Das Plugin lehnt die Verknüpfung ab, wenn:
Bei Ablehnung zeigt das Panel die Meldung Failed to link tickets. Den genauen Grund nennt es nicht.
Das Trennen setzt nur ticket_pid des Childs auf NULL. Das Ticket selbst wird nicht gelöscht. Auch hier ist der Zugriff auf die Abteilung des Child-Tickets nötig.
In der Ticket-Warteschlange zeigen Parent-Tickets ein Code-Fork-Icon mit der Anzahl der Children, der Tooltip lautet „N Sub-Ticket(s)“. Dafür gibt es zwei Mechanismen:
queue-indicator.js sammelt die Ticket-IDs der sichtbaren Zeilen, fragt sie gebündelt über ajax-subticket.php?action=batch_parent_status ab und hängt das Icon an die Zelle mit dem Ticket-Link. Das Skript wirkt nur auf Seiten, deren Pfad tickets.php enthält.ParentTicketDecoration („Parent Ticket Icon“) ist eine Unterklasse von QueueColumnAnnotation. Damit stellt das Plugin osTicket eine Dekoration für Queue-Spalten bereit, die dasselbe Icon serverseitig rendert.Die Seite scp/subtickets.php erreichst du über den Staff-Navigationspunkt Applications → Subtickets oder über die Kachel auf scp/apps.php. Die Seite trägt die Überschrift „Ticket Hierarchies“ und zeigt eine Tabelle mit den Spalten Parent-Ticket, Betreff, Status, Anzahl und Child-Tickets.
Das Plugin legt keine eigenen Rollen-Berechtigungen an. Es unterscheidet nur zwischen angemeldetem Staff und allen anderen.
| Aktion | Voraussetzung |
|---|---|
| Panel sehen, Übersichtsseite öffnen, Children abfragen, Queue-Indikator | Angemeldeter Agent |
| Verknüpfen, Trennen | Angemeldeter Agent mit Zugriff auf die Abteilung des Child-Tickets (Administratoren immer), gültiges CSRF-Token |
| Subticket per AJAX anlegen | Angemeldeter Agent mit Zugriff auf die Abteilung des Parent-Tickets, gültiges CSRF-Token |
Bis zu 100 AJAX-Anfragen pro Minute und Session sind erlaubt, danach sperrt das Plugin die Session für 60 Sekunden (Details unter AJAX-API).
ticket_pid (und legt über die AJAX-Schnittstelle auf Wunsch neue Tickets an).