83 lines
3.3 KiB
Markdown
83 lines
3.3 KiB
Markdown
# Zammad Sync und Integration
|
|
|
|
TicketTracker nutzt Zammad, ohne Zammad zu ersetzen. Zammad bleibt das führende Ticketsystem für Ticketstammdaten, Organisationen, Status und Prioritäten.
|
|
|
|
## Persönlicher Zammad-Token
|
|
|
|
Jeder Benutzer kann im Profil einen persönlichen Zammad API-Token speichern. Beim Speichern ruft TicketTracker Zammad ab, prüft den Token und speichert die Zammad User-ID.
|
|
|
|
Der Token wird verschlüsselt in der Datenbank gespeichert.
|
|
|
|
Der persönliche Token wird unter anderem für benutzerbezogene Zammad-Funktionen verwendet, zum Beispiel interne Notizen oder personenbezogene Synchronisierungen.
|
|
|
|
## Admin-Zammad-Zugang
|
|
|
|
Im Adminbereich wird der Zammad-Zugang für systemweite Synchronisierungen gepflegt.
|
|
|
|
Der Admin kann Organisationen aus Zammad synchronisieren. Dabei werden lokale Organisationen angelegt, aktualisiert oder entfernt beziehungsweise von alten Verknüpfungen gelöst.
|
|
|
|
## Ticketdaten aus Zammad
|
|
|
|
TicketTracker kann Ticketdaten aus Zammad übernehmen:
|
|
|
|
- Ticketnummer
|
|
- Titel
|
|
- Organisation
|
|
- Work-Type, zum Beispiel Support oder Consulting
|
|
- Status
|
|
- Priorität
|
|
- Owner
|
|
- Teamspace-Projektinformationen
|
|
|
|
Zammad-verwaltete Ticketstammdaten bleiben geschützt. Ticketnummer, Titel, Art und Organisation können dann in TicketTracker nicht beliebig überschrieben werden.
|
|
|
|
## Consulting-Projekte aus Zammad
|
|
|
|
Beim Zammad-Sync oder beim Anlegen eines Projekts können Consulting-Projektinformationen übernommen werden.
|
|
|
|
Dazu gehören insbesondere:
|
|
|
|
- Teamspace-Projekt-ID oder mehrere Teamspace-Projekt-IDs
|
|
- Zammad-Owner
|
|
- Projektstatus-Hinweise, zum Beispiel Review bei Abschlussstatus
|
|
|
|
Die Teamspace-Projekt-ID aus Zammad ist die fachliche ID, zum Beispiel `EP-2026-A-035`. Für Teamspace-API-Abfragen speichert TicketTracker zusätzlich die interne Teamspace-API-ID.
|
|
|
|
## Teamspace-Projekt-ID-Sync auf der Zammad-Sync-Seite
|
|
|
|
Auf der Zammad-Sync-Seite gibt es den Sync für Teamspace-Projekt-IDs, Budgets und Positionen.
|
|
|
|
Voraussetzungen:
|
|
|
|
- Admin hat die Teamspace-Base-URL gespeichert.
|
|
- Benutzer hat im Profil Teamspace-Geraete-ID und Geraetepasswort gespeichert.
|
|
- Die Teamspace User-ID ist bekannt.
|
|
- Das Projekt hat eine Teamspace-Projekt-ID.
|
|
|
|
Der Sync speichert:
|
|
|
|
- Teamspace-API-ID
|
|
- Teamspace-API-URL
|
|
- Gesamtbudget
|
|
- Unterpositionen
|
|
- Budgets und Istwerte der Unterpositionen
|
|
- Stückpositionen
|
|
|
|
## Interne Zammad-Notizen
|
|
|
|
Beim Timerabschluss und beim manuellen Nachtragen kann TicketTracker einen internen Zammad-Article erzeugen.
|
|
|
|
Der Article enthält die Tätigkeit und optional den `time_unit`-Wert. Im Profil kann eingestellt werden:
|
|
|
|
- ob die interne Notiz standardmäßig aktiv ist
|
|
- welcher Zammad-Zeitbuchungstyp vorausgewählt wird
|
|
- ob `time_unit` auf 5, 10, 15 oder 30 Minuten aufgerundet wird
|
|
|
|
Wenn Zammad nicht erreichbar ist oder die Notiz fehlschlägt, speichert TicketTracker die Session trotzdem. Die fehlgeschlagene Notiz wird geparkt und kann später im Profil erneut gesendet werden.
|
|
|
|
## eMail-/Article-Import
|
|
|
|
TicketTracker kann Zammad-Articles prüfen und daraus Sessions vorbereiten. Das ist besonders hilfreich, wenn Arbeit per eMail-Import ins Ticket kam.
|
|
|
|
Solche Sessions können nachträglich geprüft, zugeordnet und bewertet werden. Wenn ein importierter Eintrag keinem Teamspace-Projekt zugeordnet ist, kann das im Projektdetail sichtbar werden.
|