Projekte und Git-Integrationen

Projekte und Git-Integrationen

Projekte ermöglichen es, Issues unter einem gemeinsamen Schlüsselpräfix zu gruppieren und Git-Repositorys für die automatische Aktivitätsverfolgung zu verbinden.

Ein Projekt erstellen

1. Navigieren Sie zu DevOps > Projects in der Seitenleiste.
2. Klicken Sie auf New Project.
3. Geben Sie einen Namen und einen eindeutigen Projektschlüssel ein (Großbuchstaben und Zahlen, 2 bis 10 Zeichen). Der Schlüssel kann nach der Erstellung nicht mehr geändert werden.
4. Optional können Sie einen Projektleiter, einen Standard-Issue-Typ, einen Standardbearbeiter und ein Standard-Branch-Namensmuster festlegen.
5. Klicken Sie auf Create zum Speichern.

Ein Repository verbinden

1. Öffnen Sie ein Projekt und gehen Sie zur Seite Settings.
2. Klicken Sie auf Add Connection.
3. Wählen Sie einen Anbieter (GitHub, GitLab oder Bitbucket).
4. Geben Sie die Repository-URL, einen Anzeigenamen und Ihr Zugriffstoken ein.
5. Klicken Sie auf Connect. ISO Mate validiert das Token und erkennt die Lese-/Schreibfähigkeiten.

Token-Anforderungen

Jeder Anbieter verwendet einen anderen Token-Typ. ISO Mate erkennt automatisch die Lese-/Schreibfähigkeiten anhand der Token-Bereiche.

GitHub

GitHub unterstützt zwei Token-Typen:

• Classic Personal Access Token: Gehen Sie in GitHub über Ihr Profilsymbol zu Settings > Developer settings > Personal access tokens > Tokens (classic). Wählen Sie den Bereich repo für vollen Zugriff (Branches, PRs, Commits). Für schreibgeschützten Zugriff auf öffentliche Repos wählen Sie public_repo.
• Fine-grained Personal Access Token: Gehen Sie in GitHub über Ihr Profilsymbol zu Settings > Developer settings > Personal access tokens > Fine-grained tokens. Wählen Sie das Ziel-Repository, setzen Sie dann Contents auf Read and write und Pull requests auf Read and write für vollen Zugriff. Für schreibgeschützten Zugriff setzen Sie Contents auf Read-only.

GitLab

GitLab unterstützt Personal Access Tokens und Project Access Tokens:

• Personal Access Token: Gehen Sie zu User Settings > Access > Personal Access Tokens. Wählen Sie den Bereich api für vollen Zugriff. Für schreibgeschützten Zugriff wählen Sie read_api und read_repository.
• Project Access Token: Gehen Sie zu Project > Settings > Access Tokens. Wählen Sie den Bereich api und weisen Sie mindestens die Rolle Developer für Schreibzugriff zu.

Bitbucket

Bitbucket Repository Access Tokens sind die empfohlene Option (App Passwords sind seit September 2025 veraltet):

• Repository Access Token: Gehen Sie zu Repository Settings > Security > Access Tokens. Wählen Sie den Bereich pullrequest:write für vollen Zugriff (einschließlich Branch-Erstellung, Push und PR-Verwaltung). Für schreibgeschützten Zugriff wählen Sie den Bereich repository.
• Workspace Access Token: Gehen Sie zu Workspace Settings > Security > Access Tokens. Die gleichen Bereiche gelten, aber das Token funktioniert für alle Repositorys im Workspace.

Git-Aktivität anzeigen

Sobald ein Repository verbunden ist, synchronisiert ISO Mate Branches, Commits und Pull Requests alle 15 Minuten. Es sucht nach Issue-Schlüsseln (z. B. PROJ-42) in Branch-Namen, Commit-Nachrichten und PR-Titeln, um die Aktivität den entsprechenden Issues zuzuordnen.

Öffnen Sie ein beliebiges Issue und scrollen Sie zum Abschnitt Git Activity, um verknüpfte Branches, Commits und Pull Requests nach Repository gruppiert anzuzeigen. Jedes Element verlinkt zur Weboberfläche des Anbieters.

Branches und Pull Requests erstellen

Klicken Sie auf der Issue-Detailseite auf Create Branch, um einen neuen Branch in einem oder allen verbundenen Repositorys zu erstellen. Der Branch-Name wird automatisch mit dem Issue-Schlüssel und der Zusammenfassung ausgefüllt. Klicken Sie auf Create MR/PR, um einen Entwurfs-Pull-Request mit dem Issue-Schlüssel im Titel zu öffnen.

Pull Requests können über das Kontrollkästchen im Dialog als Entwurf markiert werden. Für GitLab wird das Präfix “Draft:” automatisch zum Titel hinzugefügt. Für GitHub wird das native Draft-Flag gesetzt. Aktivieren oder deaktivieren Sie das Kontrollkästchen, um das Draft-Präfix zum Titel hinzuzufügen oder zu entfernen.

Diese Aktionen erfordern Schreibzugriff auf das Repository-Token. Wenn eine Verbindung nur Lesezugriff hat, werden die Schaltflächen deaktiviert und ein Tooltip erklärt die Anforderung.

Verknüpfte Branches und Pull Requests verwalten

Jeder Branch und Pull Request im Abschnitt Git Activity hat ein Aktionsmenü (Drei-Punkte-Symbol) mit folgenden Optionen:

• Unlink Branch: Entfernt die Verknüpfung zwischen dem Branch und dem Issue. Der Branch bleibt im Repository erhalten.
• Delete Branch: Löscht den Branch dauerhaft aus dem Remote-Repository und entfernt alle lokalen Einträge. Nur verfügbar, wenn die Verbindung Schreibzugriff hat. Vor dem Fortfahren wird ein Bestätigungsdialog angezeigt.
• Unlink Pull Request: Entfernt die Verknüpfung zwischen dem Pull Request und dem Issue. Der Pull Request bleibt beim Anbieter geöffnet.
• Close Pull Request: Schließt den Pull Request im Remote-Repository und aktualisiert den lokalen Status. Nur für offene Pull Requests verfügbar. Vor dem Fortfahren wird ein Bestätigungsdialog angezeigt.

Verbindungen verwalten

Auf der Projekteinstellungsseite zeigt jede Verbindung ihren Status (Active, Error oder Syncing) und ihre Fähigkeitsstufe (Read Only oder Read & Write) an. Sie können eine Verbindung bearbeiten, um ihr Token zu aktualisieren, eine Verbindung im Fehlerzustand erneut validieren oder eine Verbindung vollständig löschen.

Funktion

• Project Git Integrations