Jira Issues#
OakCore verknüpft Spezifikationsknoten (Anforderungen, Tests, Risiken) mit Jira-Cloud-Issues. OakCore hält eine schreibgeschützte Momentaufnahme jedes verknüpften Issues und schreibt eine OakCore-Landing-URL in ein konfiguriertes Custom Field auf dem Jira-Issue.
Connection-Setup (Site-URL, Projekt-Key, API-Token, Backlink-Feld, Webhooks): Jira Cloud-Verbindung.
Issue an Knoten binden#
- Knoten öffnen, dessen Typ Issue-Binding unterstützt (Anforderung, Test, Risiko).
- In der Seitenleiste Info → Bindings → Issues.
- Connection wählen (nach Label), Issue-Referenz einfügen, verknüpfen.
Erfordert eine Jira-Cloud-Verbindung für das Zielprojekt.
Akzeptierte Referenzen:
| Format | Beispiel |
|---|---|
| Issue-Key | PROJ-42 |
| Browse-URL | https://acme.atlassian.net/browse/PROJ-42 |
Key oder URL müssen zum Projekt der Connection gehören.
Nach dem Verknüpfen:
- Lädt aktuelle Issue-Daten (Summary, Status, Assignee, Priorität, Labels, …).
- Schreibt die Landing-URL ins konfigurierte URL-Custom-Field — der Backlink.
Wenn das Custom Field nicht aktualisiert werden kann (falscher Screen, Feldtyp oder Berechtigung), setzt OakCore fallback auf einen Issue-Kommentar mit demselben Link — analog zu GitHub Issues.
Beispiel-Landing-URL:
{ihre-oakcore-url}/integration-issue?projectId={project_id}&artifactId={artifact_id}
Beim Entfernen des letzten Knotens von einem Issue löscht OakCore den Backlink-Feldwert.
Status-Anzeige#
Jira-Statusnamen erscheinen unverändert. Für Open/Closed-Zähler mappt OakCore Jira-Statuskategorien:
| Jira-Statuskategorie | OakCore state_category |
|---|---|
| To Do, In Progress | open |
| Done | closed |
Webhook-Ereignisse#
Am Jira-Webhook Issue updated und Issue deleted abonnieren.
Fehlerbehebung#
| Symptom | Prüfen |
|---|---|
| Bind abgelehnt — falsches Projekt | Issue-Key-Präfix muss zum Projekt-Key der Connection passen |
| Snapshot bleibt pending | Test auf Connection; Hintergrund-Sync abwarten |
| Kein Backlink | Anzeigename des Backlink-Felds; Feld auf Issue-Screen; Token darf Issues bearbeiten |