Licensed to be used in conjunction with basebox, only.
// integration
YouTrack
Gilt für
Produkt: Cloud · Server · Zielgruppe: Administrator
Der Konnektor YouTrack lässt den basebox-Assistenten Issues in Ihrem JetBrains YouTrack-Projekttracker abfragen und (optional) aktualisieren.
Wann einsetzen
Aktivieren Sie YouTrack, wenn der Assistent:
- Issues nach ID, Zusammenfassung oder Abfrage nachschlagen soll,
- den Stand eines Projekts, Sprints oder Releases zusammenfassen soll,
- Kommentare oder Statusaktualisierungen zu Issues entwerfen soll,
- bei der Triage helfen soll, indem er Duplikate oder verwandte Tickets findet.
Voraussetzungen
- Eine YouTrack-Instanz, die Sie aus dem basebox-Deployment erreichen (Cloud oder selbst gehostet).
- Für jeden Nutzer ein eigenes permanentes Token aus seinem YouTrack-Konto.
- Siehe So erstellen Sie ein YouTrack-Token.
- Scopes, die zu dem passen, was Sie erlauben wollen – mindestens YouTrack: Read Issue; Schreib-Scopes nur, wenn der Assistent Tickets aktualisieren soll.
Konfiguration
YouTrack arbeitet mit persönlichen Zugangsdaten: Der Administrator richtet den Konnektor einmal ein, und jeder Nutzer hinterlegt sein eigenes Token. Anfragen erscheinen in YouTrack unter dem Namen der jeweiligen Person, und YouTrack setzt deren Rechte durch (Konnektor-Authentifizierung).
Als Administrator suchen Sie auf der Seite Admin → Konnektoren den Eintrag YouTrack und füllen aus:
| Feld | Beschreibung |
|---|---|
| Endpoint URL | Die Basis-URL Ihres YouTrack, z. B. https://yourorg.youtrack.cloud oder https://youtrack.example.org. |
Anschließend:
- Klicken Sie auf Verbindung testen, um die URL zu prüfen.
- Schalten Sie den Konnektor ein und geben Sie ihn in den Apps frei, in denen er nutzbar sein soll.
Als Nutzer erstellen Sie ein Token in Ihrem YouTrack-Konto (Anleitung), tragen es beim Konnektor ein und prüfen es mit Verbindung testen.
Verhalten im Chat
Ist YouTrack aktiviert, kann der Assistent:
- Issue-IDs (z. B.
DEV-1042) in Zusammenfassung und aktuellen Status auflösen, - YouTrack-Suchabfragen im Namen des Nutzers ausführen,
- optional Issues aktualisieren, wenn das Token Schreib-Scopes gewährt und die App Schreibwerkzeuge freigibt – standardmäßig sind sie aus.
Links zu YouTrack-Issues werden so gerendert, dass sie in einem neuen Browser-Tab öffnen.
Sicherheitshinweise
- Das Token hat genau die Rechte, die der Nutzer ihm gibt. Empfehlen Sie Ihren Nutzern den kleinsten Satz von Scopes für ihren Anwendungsfall.
- Das Token kann jederzeit auf derselben YouTrack-Seite widerrufen werden, auf der es erstellt wurde – siehe die Hilfeseite.
- basebox speichert das Token nur schreibend: Oberfläche und API geben es nie wieder aus, auch Administratoren sehen es nicht. Verschlüsselt im Ruhezustand speichert die Anwendung es nicht selbst (Verschlüsselung).