Verknüpfe Spaces direkt mit GitLab-Projekten, damit du immer weißt, welche Arbeit damit zusammenhängt.

Aufgaben in Spaces mit einem verbundenen Projekt können mit Commits, Branches und Merge-Requests verknüpft werden.

Was du wissen musst

• Die GitLab-Integration ist auf allen ClickUp-Plänen verfügbar.
• Nur Workspace-Eigentümer und Administratoren können GitLab-Projekte im App-Center hinzufügen.
• Workspace-Eigentümer und Administratoren können Spaces mit ihren Projekten verbinden, sodass Mitglieder ihre GitLab-Arbeiten zu Aufgaben hinzufügen können.
• Nur Workspace-Eigentümer und Administratoren können Workspace-Verbindungen erstellen. Mehrere Workspace-Verbindungen sind erlaubt.
• Mitglieder und höher können persönliche Verbindungen erstellen.

• Gäste und eingeschränkte Mitglieder können die GitLab-Integration nicht nutzen.

Verbindungstypen

Die verfügbaren Funktionen und Befehle hängen davon ab, welche Art von Verbindung du verwendest.

ClickUp-Befehle für GitLab sind nur für persönliche Verbindungen verfügbar. Die Daten sind nicht mit Workspace-Verbindungen verknüpft. Wenn ein Benutzer eine persönliche Verbindung aktiviert hat und einen GitLab-Befehl ausführt, sieht er eine Liste von Optionen, wie Projektlisten, auf die er in GitLab Zugriff hat.

Richte die Integration ein

Es gibt drei erforderliche Schritte, um die GitLab-Integration in ClickUp einzurichten:

1. Verbinde GitLab.
2. Verknüpfe GitLab-Projekte mit deinem Workspace.
   

   Projekte sind notwendig, damit ClickUp Merge-Requests automatisch mit den entsprechenden ClickUp-Aufgaben verknüpfen kann.

3. Verknüpfe GitLab-Projekte mit ClickUp Spaces.
4. Optional kannst du ein benutzerdefiniertes Branch-Namenformat festlegen.

Schritt 1: Verbinde GitLab

Um GitLab vom App-Center zu verbinden:

1. Suche und wähle GitLab aus.
2. Je nach gewünschter Verbindungsart wähle den Persönlich oder Workspace Tab.
3. Wähle, wie du dich autorisieren möchtest:
   • GitLab-Konto: Autorisiere über dein GitLab.com Konto.
   • Self-hosted Version: Autorisiere über eine benutzerdefinierte GitLab-URL.
4. Klicke auf Weiter.
5. ClickUp autorisieren.
6. Klicke auf Erledigt.

Schritt 2: Verknüpfe GitLab-Projekte mit deinem Workspace

Nur der Verbindungseigentümer kann Projekte hinzufügen. Das Anhängen eines Projekts gibt ClickUp-Benutzern keinen Zugriff auf den Code deines Repos.

Um sicherzustellen, dass alle GitLab-Projekte im App-Center angezeigt werden, setze individuelle Berechtigungen für jedes Projekt anstelle von Gruppenberechtigungen.

Um ein Projekt zu einem Workspace hinzuzufügen:

1. Im App-Center suche und wähle GitLab aus.
2. Oben rechts, klicke auf Einstellungen.
3. Unter Projekte mit Spaces verbinden, klicke auf Projekt hinzufügen.
4. Wähle das Projekt aus, das du hinzufügen möchtest.
5. Wiederhole die obigen Schritte, um weitere Projekte hinzuzufügen.

Wenn du die richtigen Projekte nicht siehst, stelle sicher, dass du beim richtigen Konto angemeldet bist. Ein Workspace-Eigentümer oder Administrator muss jedes Projekt zur Verbindung auswählen. Verknüpfte Projekte können im App-Center eingesehen werden.

Schritt 3: Verknüpfe GitLab-Projekte mit ClickUp Spaces

Nachdem Projekte zu deinem Workspace hinzugefügt wurden, kann ein Administrator jedes Projekt einem oder mehreren Spaces hinzufügen. Jeder ClickUp-Space kann mehrere Projekte hinzugefügt haben.

Du kannst jederzeit Projekte zu Spaces hinzufügen oder daraus entfernen.

Um ein Projekt mit einem Space zu verknüpfen:

1. Im App-Center suche und wähle GitLab aus.
2. Oben rechts, klicke auf Einstellungen.
3. Unter Projekte mit Spaces verbinden, klicke auf den Namen des Projekts, das du verlinken möchtest.
4. Klicke auf Space hinzufügen und wähle einen Space. Wiederhole diesen Schritt, um weitere Spaces hinzuzufügen.

Lege dein Branch-Namen-Format fest

Wenn deine Organisation ein spezifisches Format für Branch-Namen verwendet, kannst du dies auf der GitLab-Seite im App-Center festlegen. Wenn Personen Branches aus ClickUp-Aufgaben erstellen, wird dieses Format verwendet.

Das Standardformat ist: :taskId:_:taskName:_:username:

Zum Beispiel: CU-ae27de_Auto-generated-naming_John-smith

Die verfügbaren Optionen werden in der folgenden Tabelle angezeigt:

Um dein Standardnamen-Format von GitLab im App-Center festzulegen:

1. Suche und wähle GitLab aus.
2. Oben rechts, klicke auf Einstellungen.
3. Unter Automatisch generierter Branch-Name, gib dein bevorzugtes Branch-Namenformat ein.
4. Klicke auf Speichern.

Verknüpfe Aufgaben von GitLab

ClickUp verknüpft automatisch neue GitLab-Aktivitäten mit Aufgaben, wenn du eine gültige ClickUp Aufgaben-ID in einem Teil des Merge-Request-Titels, der Merge-Request-Beschreibung, des Branch-Namens oder der Commit-Nachricht einfügst.

Wenn eine ClickUp-Aufgaben-ID in einem Merge-Request enthalten ist, wird ein Kommentar mit einem Link zur ClickUp-Aufgabe im Merge-Request gepostet. Ein Link wird nicht angezeigt, wenn ein Merge-Request manuell in eine ClickUp-Aufgabe eingefügt wird.

Der Kommentar wird über das GitLab-Konto der Person gepostet, die das Projekt und die Space-Zuordnung eingerichtet hat.

Die Aufgaben-ID muss eines dieser Formate verwenden:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Zum Beispiel:

#1abc2de

CU-1abc2de

eng-123

#eng-123

Verknüpfe Aufgaben aus ClickUp

Du kannst auch manuell ClickUp-Aufgaben mit GitLab-Commits, Branches und Merge-Requests aus der ClickUp-Aufgabe verlinken. Stelle sicher, dass die Aufgabe in einem Space liegt, der mit einem Projekt verknüpft ist.

Um eine Aufgabe zu verlinken:

1. Öffne eine Aufgabe und klicke auf das GitLab -Symbol rechts.
2. Rechts siehst du vorgeschlagene Branch-Namen und Commit-Nachrichten, die du in deine Zwischenablage kopieren kannst. Du kannst auch die Aufgaben-ID von hier kopieren.
3. In der unteren rechten Ecke klicke auf GitLab-Link hinzufügen.
   
4. Füge einen Link ein.
5. Klicke unten rechts auf Hinzufügen.

ClickUp-Aufgabenaktivität

Der Aktivitätsfeed für Aufgaben kollabiert manchmal ähnliche Aktivitätselemente, um sicherzustellen, dass du die wichtigsten Details siehst.

Du kannst folgende Aktionen durchführen, um GitLab-Aktivitäten zu finden:

• Klicke auf Mehr Updates, um versteckte Aktivitäten anzuzeigen.
• Wenn ein Branch zusammengeführt wird, werden Commits als einzelner Aktivitätseintrag im Aktivitätsfeed der Aufgabe angezeigt.
  • Klicke auf den Link zu allen Commits, um ein Menü zu öffnen.
  • Klicke auf ein einzelnes Commit, um es in GitLab zu öffnen.
• Filtere Aufgabenaktivitäten nach Git-Elementen.

Fehlende Aktivität 

Wenn du bestimmte Aktivitäten nicht finden kannst, stelle sicher, dass du die ClickUp-Aufgaben-ID korrekt verwendest, um Aktivitäten in GitLab zu verknüpfen. Du kannst eine dieser drei Optionen verwenden, um deine ClickUp-Aufgaben in Commits, Branch-Namen und Merge-Requests zu referenzieren:

#{task_id}

CU-{task_id}

{custom_task_id}

Zum Beispiel:

#1abc2de

CU-1abc2de

prefix-1

Du kannst manuell verlinken ClickUp-Aufgaben zu GitLab-Commits, Branches und Merge-Requests von der ClickUp-Aufgabe.

GitLab Link-Vorschauen

Wenn du einen GitLab-Link in eine ClickUp-Aufgabe, Chat oder Dokument einfügst, siehst du die Option, ihn als Vorschau, Erwähnung oder URL einzufügen.

Erstelle GitLab-Probleme, Branches und Merge-Requests aus ClickUp

Du kannst auch direkt aus Aufgaben neue Probleme, Branches und Merge-Requests erstellen. Stelle sicher, dass die Aufgabe in einem Space liegt, der mit einem Projekt verknüpft ist.

Um ein Problem, einen Bereich oder einen Merge-Request zu erstellen:

1. Öffnen Sie eine Aufgabe und klicken Sie auf das GitLab -Symbol.
2. Rechts siehst du vorgeschlagene Branch-Namen und Commit-Nachrichten, die du in deine Zwischenablage kopieren kannst. Du kannst auch die Aufgaben-ID von hier kopieren.
3. In der unteren rechten Ecke klicke auf GitLab-Link hinzufügen.
4. Wähle eine der folgenden Optionen:
   • Neuer GitLab Branch
   • Neuer GitLab Merge-Request
   • Neues GitLab-Issue
5. Benenne den Branch, Merge-Request oder das Issue.
6. Wähle ein Projekt aus und fülle die Informationen aus. Füge einen Quell-Branch und einen Ziel-Branch hinzu, falls zutreffend.
7. In der unteren rechten Ecke, klicke auf Erstellen.

GitLab App-Panel in Aufgaben

Nachdem du deinen ersten GitLab-Link in einer Aufgabenbeschreibung oder einem Kommentar eingefügt hast, siehst du ein neues GitLab -Symbol in der rechten Seitenleiste von allen Aufgaben, die in Spaces leben, die mit Projekten verbunden sind. Du kannst dieses Symbol jederzeit anklicken, um jeden GitLab-Link zu sehen, der in der Aufgabe gepostet wurde.

Die GitLab-Aufgabenaktivität verwendet den ClickUp-Benutzernamen der Person oder ihren GitLab-Benutzernamen, falls sie kein ClickUp-Konto haben.

Aktualisiere Aufgabenstatus aus GitLab

Du kannst den Status einer ClickUp-Aufgabe aktualisieren, wenn du einen Commit verlinkst, einen Commit pushst oder eine Merge-Anfrage erstellst. ClickUp erfasst automatisch neue GitLab-Aktivitäten und ordnet sie Aufgaben zu, wenn du eine gültige Aufgaben-ID in einem Teil des Merge-Request-Titels, der Merge-Request-Beschreibung, des Branch-Namens oder der Commit-Nachricht einfügst.

Die Aufgaben-ID muss eines dieser Formate verwenden:

#{task_id}[status]

CU-{task_id}[status]

{custom_task_id}[status]

#{custom_task_id}[status]

Um den Status einer Aufgabe zu aktualisieren:

1. Füge die ClickUp Aufgaben-ID an beliebiger Stelle der Commit- oder Merge-Request-Nachricht hinzu.
2. Füge den aktualisierten Aufgabenstatus in eckigen Klammern hinzu.

Zum Beispiel: #ud5b[ready]

Alle Formate, die im Abschnitt „Aufgaben aus GitLab verknüpfen“ dieses Artikels aufgeführt sind, können verwendet werden. Um das richtige Format zu gewährleisten, füge keinen Abstand zwischen der Aufgaben-ID und den Statusinformationen hinzu.

Verwalte GitLab-Probleme, Branches, Merge-Requests und Commits von ClickUp aus

Nachdem du Issues, Branches, Merge-Anfragen oder Commits verlinkt hast, werden diese auf der rechten Seite deiner Aufgabe angezeigt, wenn du auf das GitLab -Symbol klickst. Verwende das ellipsis ... Menü, um den Link zu kopieren oder das Element zu löschen.

Wenn du dem Workspace als Gast beigetreten bist, kannst du die GitLab-Integration nicht nutzen. Kontaktiere deinen Workspace-Eigentümer oder Administrator, um ein Upgrade auf ein Workspace-Mitglied zu beantragen.

Sobald du ein GitLab-Element verlinkst, werden die folgenden Informationen in deiner ClickUp-Aufgabe angezeigt:

Informationen zum Problem

Nachdem ein Problem verknüpft wurde, kannst du folgende Details sehen:

• Die Person, die das Problem eröffnet hat, bekannt als der Autor
• Projekt
• Der Status des Problems
• URL

Branch-Informationen

Nachdem ein Branch verlinkt wurde, kannst du die folgenden Details sehen:

• Die Person, die den Branch erstellt hat, bekannt als der Autor
• Link-Ersteller
• Projekt
• URL

Informationen zu Merge-Requests

Nachdem ein Merge-Request verknüpft wurde, kannst du folgende Details sehen:

• Die Person, die den Merge-Request eröffnet hat, bekannt als der Autor
• Alle zugewiesenen Prüfer
• Projekt
• Der Status des Merge-Requests
• URL

Commit-Informationen

Nachdem ein Commit verknüpft wurde, kannst du folgende Details sehen:

• Die Person, die den Commit erstellt hat, bekannt als der Autor
• Zeilenänderungen
• Projekt
• URL

Füge dein GitLab-Konto zu ClickUp hinzu

Workspace-Mitglieder können ihre GitLab-Konten im Voraus oder beim Erstellen eines Branches oder Merge-Requests mit ihrem ClickUp-Konto verknüpfen.

Um dein GitLab-Konto über das App-Center hinzuzufügen:

1. Suche und wähle GitLab aus.
2. Klicke neben Persönliche Verbindung erstellen auf Verbinden.
3. Melde dich bei GitLab an und autorisiere ClickUp.
4. Klicke auf Erledigt.

Sieh dir Merge-Requests in der Listen- oder Tabellenansicht an

Füge die Pull Requests-Spalte zu jeder Listenansicht oder Tabellenansicht hinzu, um deine GitLab-Merge-Requests schnell zu sehen.

Verbindungsprobleme

Manchmal ist das falsche GitLab-Konto verknüpft oder es gibt ein Problem mit der Verbindung. In diesem Szenario kannst du versuchen, deine Projekte oder das gesamte Konto zu trennen und erneut zu verbinden.

Diese Aktionen beeinträchtigen nicht die Fähigkeit von jemandem, über sein GitLab-Konto auf Projekte zuzugreifen, die durch GitLab verwaltet werden.

Um ein Projekt zu trennen:

1. Aus dem App-Center, wähle GitLab.
2. Klicke in der oberen rechten Ecke auf Einstellungen.
3. Unter Projekt, klicke auf das Ellipsenmenü ... rechts vom Projekt.
4. Klicke auf Von ClickUp löschen.

Der folgende Abschnitt enthält Anweisungen zum Trennen deines gesamten Kontos.

Trenne die GitLab-Integration

Wenn du keinen Zugriff mehr auf GitLab-Dateien in ClickUp benötigst, kannst du die Integration von deinem Workspace trennen.

Nur Eigentümer und Administratoren können Workspace-Verbindungen trennen.

Über das App-Center:

1. Suche und wähle GitLab aus.
2. Wähle den Workspace -Tab.
3. Klicke neben Verbunden auf das Menü Ellipsen ....
4. Wähle Trennen.
5. Zum Bestätigen klicke auf Trennen.