Zum Inhalt springen
AppArch AppArch Docs

Jira

Die Jira-Integration wandelt AppArch-Befunde in Jira-Issues um und liest die zugeordneten Jira-Projekte für die Issue-Fluss-Analyse.

Verbinden

Abschnitt betitelt „Verbinden“
  1. Integrations → Jira.
  2. Geben Sie die Atlassian-Site-URL (z. B. https://your-team.atlassian.net), die E-Mail des Kontos und ein API-Token ein.
  3. AppArch prüft das Token gegen Jira (/rest/api/3/myself), bevor es verschlüsselt gespeichert wird.

Jeder Workspace hat eine Jira-Verbindung. Zur Verwaltung braucht man im Workspace die Berechtigung für Integrationen.

Projekte zuordnen

Abschnitt betitelt „Projekte zuordnen“

Eine Zuordnung verbindet ein AppArch-Projekt mit einem Jira-Projekt. Pro Zuordnung wählen Sie:

  • den Standard-Issue-Typ (Bug, sofern Sie keinen anderen wählen),
  • optional ein Board, ob das Issue dem laufenden Sprint des Boards hinzugefügt wird, und den Anfangsstatus,
  • die Regeln für automatisches Anlegen: ein Issue öffnen, wenn ein ArchPilot-Review fehlschlägt, und/oder für kritische ArchScan-Befunde.

Issues anlegen

Abschnitt betitelt „Issues anlegen“
  • Von Hand: Befunde in einem ArchScan-Lauf oder einem ArchPilot-Merge-Request im Panel markieren und dafür Issues anlegen.
  • Automatisch: Die Regeln laufen im Hintergrund. Der erste Durchlauf schaut 24 Stunden ab dem Einschalten der Regel zurück, und pro Zuordnung werden je Durchlauf höchstens 50 Issues geöffnet; der Rest folgt in späteren Durchläufen.

Die Zusammenfassung eines Issues lautet [AppArch] <Regelcode>: <Meldung> (höchstens 200 Zeichen); die Beschreibung enthält Modul, Repository, Regel und Schweregrad, Datei und Zeile, Branch, wo der Befund gesehen wurde, die Meldung und den Lösungsvorschlag, falls vorhanden.

Der Befund zeigt danach ein Abzeichen mit dem Issue-Schlüssel, das auf das Issue verlinkt. Verknüpfungen werden über den Fingerabdruck des Befunds zugeordnet; ein Befund, den ein späterer Lauf erneut meldet, behält sein Issue statt ein neues zu bekommen.

AppArch zeigt den Status des Issues nicht am Befund an und fügt den Kommentaren, die ArchPilot auf Pull Requests schreibt, keine Jira-Schlüssel hinzu.

Issue-Fluss

Abschnitt betitelt „Issue-Fluss“

Sobald ein Workspace mindestens ein Jira-Projekt zuordnet, liest AppArch auch die Issues der zugeordneten Projekte (der erste Lauf schaut 180 Tage zurück) für den Issue-Fluss-Bericht - siehe Engineering Analytics.