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

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

Was du brauchst

• Die GitLab-Integration ist für alle ClickUp-Pläne verfügbar.
• Nur Workspace-Eigentümer und Admins können GitLab-Projekte im App Center hinzufügen.
• Workspace-Eigentümer und Admins können Spaces mit ihren Projekten verbinden und so Mitgliedern ermöglichen, ihre GitLab-Arbeit zu Aufgaben hinzuzufügen.
• Nur Workspace-Eigentümer und Admins können Workspace-Verbindungen erstellen. Mehrere Workspace-Verbindungen sind zulässig.
• Mitglieder und höher können persönliche Verbindungen erstellen.
• Gäste und eingeschränkte Mitglieder können die GitLab-Integration nicht nutzen.

Verbindungstypen

Welche Funktionen und Befehle verfügbar sind, hängt davon ab, welchen Verbindungstyp 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, wird ihm eine Liste von Optionen angezeigt – z. B. Projektlisten –, für die er in GitLab Anzeigerechte hat.

Integration einrichten

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

1. GitLab verbinden.
2. GitLab-Projekte an deinen Workspace anhängen. Projekte sind erforderlich, damit ClickUp Merge Requests automatisch mit den jeweiligen ClickUp-Aufgaben verknüpfen kann.
3. GitLab-Projekte mit ClickUp Spaces verknüpfen.
4. Optional kannst du ein benutzerdefiniertes Format für Branch-Namen festlegen.

Schritt 1: GitLab verbinden

So verbindest du GitLab über das App Center:

1. Suche nach GitLab und wähle es aus.
2. Wähle je nach gewünschtem Verbindungstyp den Tab Persönlich oder Workspace.
3. Wähle, wie du autorisieren möchtest:
   • GitLab-Konto: Autorisiere über dein GitLab.com-Konto.
   • Selbst gehostete Version: Autorisiere über eine benutzerdefinierte GitLab-URL.
4. Klicke auf Weiter.
5. Autorisiere ClickUp.
6. Klicke auf Fertig.

Schritt 2: GitLab-Projekte an deinen Workspace anhängen

Nur der Eigentümer der Verbindung kann Projekte hinzufügen. Das Anhängen eines Projekts gewährt ClickUp-Benutzern keinen Zugriff auf die Codebasis deines Repositorys.

Damit alle GitLab-Projekte im App Center angezeigt werden, lege individuelle Berechtigungen für jedes Projekt fest, anstatt Gruppenberechtigungen zu verwenden.

So fügst du einem Workspace ein Projekt hinzu:

1. Suche im App Center nach GitLab und wähle es aus.
2. Klicke oben rechts auf Einstellungen.
3. Klicke unter Projekte mit Spaces verbinden 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 auswählen, das verbunden werden soll. Verknüpfte Projekte können im App Center eingesehen werden.

Schritt 3: GitLab-Projekte mit ClickUp Spaces verknüpfen

Nachdem du Projekte zu deinem Workspace hinzugefügt hast, kann ein Administrator jedes Projekt zu einem oder mehreren Spaces hinzufügen. Jedem ClickUp Space können mehrere Projekte hinzugefügt werden.

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

So verknüpfst du ein Projekt mit einem Space:

1. Suche im App Center nach GitLab und wähle es aus.
2. Klicke oben rechts auf Einstellungen.
3. Klicke unter Projekte mit Spaces verbinden auf den Namen des Projekts, das du verknüpfen möchtest.
4. Klicke auf Space hinzufügen und wähle einen Space aus. Wiederhole diesen Schritt, um weitere Spaces hinzuzufügen.

Branch-Namensformat festlegen

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

Das Standardformat lautet: :taskId:_:taskName:_:username:

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

Die verfügbaren Optionen sind in der folgenden Tabelle aufgeführt:

So legst du dein Standard-Namensformat über GitLab im App Center fest:

1. Suche nach GitLab und wähle es aus.
2. Klicke oben rechts auf Einstellungen.
3. Gib unter Automatisch generierter Branch-Name dein bevorzugtes Branch-Namensformat ein.
4. Klicke auf Speichern.

Aufgaben aus GitLab verknüpfen

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

Wenn eine ClickUp-Aufgaben-ID in einem Merge Request enthalten ist, wird im Merge Request ein Kommentar mit einem Link zur ClickUp-Aufgabe gepostet. Wenn du einen Merge Request manuell in eine ClickUp-Aufgabe einfügst, wird kein Link angezeigt.

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

Die Aufgaben-ID muss in einem der folgenden Formate angegeben werden:

#{task_id}

CU-{task_id}

{custom_task_id}

#{custom_task_id}

Zum Beispiel:

#1abc2de

CU-1abc2de

eng-123

#eng-123

Aufgaben aus ClickUp verknüpfen

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

So verknüpfst du eine Aufgabe:

1. Öffne eine Aufgabe und klicke rechts auf das GitLab-Symbol.
2. Auf der rechten Seite siehst du vorgeschlagene Branch-Namen und Commit-Nachrichten, die du in die Zwischenablage kopieren kannst. Du kannst von hier aus auch die Aufgaben-ID kopieren.
3. Klicke in der unteren rechten Ecke auf GitLab-Link hinzufügen.

   

4. Füge einen Link ein.
5. Klicke in der unteren rechten Ecke auf Hinzufügen.

Aktivitäten in ClickUp-Aufgaben

Der Aktivitätsfeed einer Aufgabe blendet ähnliche Aktivitätseinträge manchmal aus, damit du die wichtigsten Details siehst.

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

• Klicke auf Weitere Updates, um ausgeblendete Aktivitäten anzuzeigen.
• Wenn ein Branch gemergt 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 einen einzelnen Commit, um ihn in GitLab zu öffnen.
• Filtere die Aufgabenaktivität nach Git-Einträgen.

Fehlende Aktivitäten

Wenn du bestimmte Aktivitäten nicht finden kannst, stelle sicher, dass du die ClickUp-Aufgaben-ID korrekt referenzierst, um Aktivitäten in GitLab zu verknüpfen. Du kannst eine der folgenden 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 ClickUp-Aufgaben manuell verknüpfen mit GitLab-Commits, Branches und Merge Requests aus der ClickUp-Aufgabe heraus.

GitLab-Linkvorschauen

Wenn du einen GitLab-Link mitten in einem Satz oder in vorhandenem Text einfügst, wird eine Inline-Linkvorschau angezeigt, über die du mit dem Mauszeiger fahren kannst, um weitere Details zu sehen.

Wenn du einen GitLab-Link in einer neuen Zeile einfügst, kannst du wählen, ob er als Inline-Vorschau, als Live-Vorschau oder als reguläre URL angezeigt werden soll.

Linkvorschauen funktionieren in Aufgabenbeschreibungen, Kommentaren, Dokumenten und Chat-Nachrichten. Um den Typ einer Linkvorschau manuell zu ändern, fahre mit dem Mauszeiger darüber und klicke auf das Symbol Ellipsis ….

GitLab-Issues, Branches und Merge Requests aus ClickUp erstellen

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

So erstellst du ein Issue, einen Branch oder einen Merge Request:

1. Öffne eine Aufgabe und klicke auf das GitLab-Symbol.
2. Auf der rechten Seite siehst du vorgeschlagene Branch-Namen und Commit-Nachrichten, die du in deine Zwischenablage kopieren kannst. Du kannst von hier aus auch die Aufgaben-ID kopieren.
3. Klicke in der unteren rechten Ecke auf GitLab-Link hinzufügen.
4. Wähle eine der folgenden Optionen:
   • Neuer GitLab-Branch
   • Neuer GitLab-Merge-Request
   • Neues GitLab-Issue
5. Gib dem Branch, dem Merge Request oder dem Issue einen Namen.
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. Klicke in der unteren rechten Ecke auf Erstellen.

GitLab-App-Panel in Aufgaben

Nachdem du deinen ersten GitLab-Link in eine Aufgabenbeschreibung oder einen Kommentar eingefügt hast, siehst du ein neues GitLab-Symbol in der rechten Seitenleiste aller Aufgaben, die sich in Spaces befinden, die mit Projekten verbunden sind. Du kannst auf dieses Symbol jederzeit klicken, um alle in der Aufgabe geposteten GitLab-Links anzuzeigen.

GitLab-Aufgabenaktivitäten verwenden den ClickUp-Benutzernamen der Person oder deren GitLab-Benutzernamen, wenn sie kein ClickUp-Konto haben.

Aufgaben-Status aus GitLab aktualisieren

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

Die Aufgaben-ID muss in einem der folgenden Formate angegeben werden:

#{task_id}[status]

CU-{task_id}[status]

{custom_task_id}[status]

#{custom_task_id}[status]

So aktualisierst du einen Aufgaben-Status:

1. Füge die ClickUp-Aufgaben-ID in einem beliebigen Teil der Commit- oder Merge-Request-Nachricht ein.
2. Gib den aktualisierten Aufgaben-Status in eckigen Klammern an.

Beispiel: #ud5b[ready]

Alle im Abschnitt „Aufgaben aus GitLab verknüpfen" dieses Artikels aufgeführten Formate können verwendet werden. Füge für eine korrekte Formatierung kein Leerzeichen zwischen der Aufgaben-ID und den Statusinformationen ein.

GitLab-Issues, Branches, Merge Requests und Commits aus ClickUp verwalten

Nachdem du Issues, Branches, Merge Requests oder Commits verknüpft hast, werden sie 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. Wende dich an den Eigentümer oder Administrator deines Workspace, um ein Upgrade auf ein Workspace-Mitglied anzufordern.

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

Issue-Informationen

Nachdem ein Issue verknüpft wurde, kannst du die folgenden Details einsehen:

• Die Person, die das Issue geöffnet hat (Autor)
• Projekt
• Der Issue-Status
• URL

Branch-Informationen

Nachdem ein Branch verknüpft wurde, kannst du die folgenden Details einsehen:

• Die Person, die den Branch erstellt hat (Autor)
• Link-Ersteller
• Projekt
• URL

Merge-Request-Informationen

Nachdem ein Merge Request verknüpft wurde, kannst du die folgenden Details einsehen:

• Die Person, die den Merge Request geöffnet hat (Autor)
• Alle zugewiesenen Reviewer
• Projekt
• Der Merge-Request-Status
• URL

Commit-Informationen

Nachdem ein Commit verknüpft wurde, kannst du die folgenden Details einsehen:

• Die Person, die den Commit erstellt hat (Autor)
• Zeilenänderungen
• Projekt
• URL

Dein GitLab-Konto zu ClickUp hinzufügen

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

So fügst du dein GitLab-Konto über das App Center hinzu:

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

Merge-Requests in der Listenansicht oder Tabellenansicht anzeigen

Füge die Spalte „Pull Requests" zu einer beliebigen Listenansicht oder Tabellenansicht hinzu, um deine GitLab-Merge-Requests schnell anzuzeigen.

Verbindungsprobleme

Deine GitLab-Verbindung kann fehlschlagen, wenn: Dein GitLab-Hostname nicht über das öffentliche Internet auflösbar ist – zum Beispiel, wenn er nur im internen Netzwerk deines Unternehmens erreichbar ist. Der Hostname öffentlich auflösbar ist, aber auf eine private IP-Adresse verweist. Wenn dein GitLab-Server öffentlich erreichbar ist, deine Firewall aber eingehenden Datenverkehr auf bestimmte IPs beschränkt: Aktiviere Static IP während der Verbindungseinrichtung in ClickUp. Trage 54.70.112.216 auf deiner Firewall für eingehenden Datenverkehr zu deinem GitLab-Server in die Zulassungsliste ein. Weitere Fehlerbehebung

Manchmal ist das falsche GitLab-Konto verknüpft oder es liegt ein Problem mit der Verbindung vor. In diesem Fall kannst du versuchen, deine Projekte oder dein gesamtes Konto zu trennen und erneut zu verbinden.

Diese Aktionen haben keinen Einfluss auf die Möglichkeit anderer Personen, über GitLab auf Projekte zuzugreifen.

So trennst du ein Projekt:

1. Wähle im App Center GitLab aus.
2. Klicke in der oberen rechten Ecke auf Einstellungen.
3. Klicke unter Projekt auf das Ellipsis-...-Menü rechts neben dem Projekt.
4. Klicke auf Aus ClickUp löschen.

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

Weitere Fehlerbehebung

Manchmal ist das falsche GitLab-Konto verknüpft oder es liegt ein Problem mit der Verbindung vor. In diesem Fall kannst du versuchen, deine Projekte oder dein gesamtes Konto zu trennen und erneut zu verbinden.

Diese Aktionen haben keinen Einfluss auf die Möglichkeit anderer Personen, über GitLab auf Projekte zuzugreifen.

So trennst du ein Projekt:

1. Wähle im App Center GitLab aus.
2. Klicke in der oberen rechten Ecke auf Einstellungen.
3. Klicke unter Projekt auf das Ellipsis-...-Menü rechts neben dem Projekt.
4. Klicke auf Aus ClickUp löschen.

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

GitLab-Integration trennen

Wenn du nicht mehr auf GitLab-Dateien in ClickUp zugreifen möchtest, kannst du die Integration von deinem Workspace trennen.

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

Im App Center:

1. Suche nach GitLab und wähle es aus.
2. Wähle den Tab Workspace aus.
3. Klicke neben Verbunden auf das Ellipsis-...-Menü.
4. Wähle Trennen aus.
5. Klicke zur Bestätigung auf Trennen.