6 Min. Lesezeit

Funktion

monday-dev-banner (2).png

Die GitHub-Integration, die du bereits kennst, kann in deine monday dev Workflows integriert werden. Aber was würdest du sagen, wenn du synchronisierte Daten in Echtzeit von GitHub direkt in deinem Board anzeigen könntest? Genau das wollen wir dir mit der App GitHub UI bieten!

Was ist GitHub UI?

GitHub UI ist eine App, die als Widget in deiner Elementkarten-Ansicht hinzugefügt werden kann, um eine Vorschau der Daten aus deinen GitHub-Repositorys anzuzeigen. Du kannst die App so anpassen, dass sie alle deine GitHub-Zweige, Commits, Pull Requests und den CI/CD-Status für jede deiner Entwicklungsaufgaben anzeigt. Sie wird mit deinem GitHub-Konto synchronisiert, um dir nur Echtzeitdaten anzuzeigen.

Wie erfolgt die Einrichtung?

Öffne die Elementkarte eines beliebigen Elements in deinem Board und klicke auf das „+“-Symbol, um Git UI aus der Elementansichtszentrale hinzuzufügen. Die App öffnet sich als neuer Git UI-Tab. Klicke jetzt einfach auf Mit GitHub verbinden. Group 64 (75).png

Hinweis: Wenn die App nicht für das Board vorkonfiguriert wurde, auf dem du sie verwenden möchtest, klicke einfach auf das „+“-Symbol und wähle Git UI aus der Elementansichtszentrale.

Du wirst auf die unten abgebildete GitHub-Seite weitergeleitet, wo du auf Installieren klicken kannst, um fortzufahren. Group 64 (76).png

Du hast dann die Möglichkeit, alle Repositorys zu synchronisieren oder bestimmte Repositorys auszuwählen und dann auf Installieren zu klicken, wenn du den Bedingungen zustimmst.

Hinweis: Es ist wichtig zu beachten, dass die hier aufgeführten Berechtigungen von GitHub benötigt werden. Unter keinen Umständen gewährt die Genehmigung dieser Berechtigungen monday.com Zugriff auf vertrauliche Daten in deinem GitHub-Konto.

Group 64 (77).png

Wenn du den folgenden Bildschirm mit den Berechtigungen erreichst, klicke auf Autorisieren, um fortzufahren. Wir möchten noch einmal darauf hinweisen, dass monday.com nur Zugriff auf allgemeine Kontoinformationen und -aktivitäten hat, aber niemals zum Lesen der Daten, die du auf GitHub hochlädst. Group 64 (78).png

Klicke auf das „x“ in der oberen rechten Ecke des Pop-up-Bildschirms, um mit der Verwendung der App direkt in der Artikelkarte zu beginnen, in der du den Flow gestartet hast.

Wie funktioniert es?

Mithilfe des Elements ID-Spalte kannst du die Elemente auf deinem Board mit Problemen und Pull-Requests in GitHub verbinden. Schauen wir uns an, wie das funktioniert.

Tipp: Wenn du Hilfe beim Hinzufügen und Einrichten der Artikel-ID-Spalte benötigst oder mehr darüber erfahren möchtest, lies diesen Artikel.

Die Element-ID-Spalte weist jedem Element oder Unterelement in deinem Board automatisch eine zufällige ID-Nummer zu. Du kannst diese ID in deine Zwischenablage kopieren, indem du einfach auf die Nummer klickst, wie unten gezeigt. download (29).gif

Du kannst die ID-Nummer jetzt entweder in den Namen oder in die Beschreibung eines beliebigen Pull Requests oder Problems einfügen. Durch die Verwendung der von monday.com generierten ID-Nummer wird die Verknüpfung zwischen einem Pull Request oder einem Problem in GitHub und dem entsprechenden monday dev Element erstellt. Group 64 (84).png

Tipp: Du kannst vorhandene Probleme und Pull-Requests verbinden, indem du sie bearbeitest, um die Element-ID hinzuzufügen.

Jetzt kannst du das von dir erstellte Problem unter dem Tab Probleme in der entsprechenden Elementkarte sehen. Group 64 (80).png

Welche Informationen werden angezeigt?

Die Daten, die in der App GitHub UI angezeigt werden, sind in Tabs kategorisiert, die Pull Requests, Probleme, Zweige und Commits enthalten.

Pull Requests

Der Tab Pull Requests listet alle Pull Requests im Stile eines monday dev Elements auf. Obwohl du nicht mit den Spalten interagieren kannst, sind alle wichtigen Informationen sichtbar. Die Anfragen werden vertikal und die relevanten Informationen horizontal unter den folgenden Spalten aufgelistet:

Zeige mir die Spalten!

Titel – der Name des Pull-Requests, der auch ein direkter Link zur Datei in GitHub ist
Repository - aus welchem Repository die Änderungen stammen
Status - der Arbeitsstatus der Anfrage
Autor - der Anfrager
Prüfer – die Personen oder Teams, die Änderungen prüfen sollen
Labels - das mit dem Pull Request assoziierte Label
Änderungen - eine Live-Zählung der Anzahl der vorgenommenen Änderungen
Zuletzt aktualisiert – eine Live-Anzeige, wie lange es her ist, dass die letzten Änderungen vorgenommen wurden

Group 64 (83).png

Hinweis: Wenn ein Teammitglied dieselbe E-Mail-Adresse bei GitHub und bei monday dev verwendet, übernimmt die App GitHub UI das Profilbild des Benutzers bei monday dev in den Spalten Autor und Prüfer.

Probleme

Der Tab Probleme listet alle Probleme auf, die mit derselben Element-ID gekennzeichnet sind. Sie sind genau wie die Pull Requests wie Elemente strukturiert und in den folgenden Spalten organisiert:

Zeige mir die Spalten!

Titel – der Name des Problems, der auch ein direkter Link zur Datei in GitHub ist
Repository – aus welchem Repository das Problem stammt
Anzahl – wie viele Probleme sind vorhanden
Status – der Arbeitsstatus des Problems
Autor - der Ersteller des Problems
Beauftragte – die Personen oder Teams, die mit der Lösung des Problems beauftragt sind
Labels – das dem Problem zugeordnete Label
Erstellt am – die Uhrzeit oder das Datum, an dem das Problem erstellt wurde
Zuletzt aktualisiert – eine Live-Anzeige, wie lange es her ist, dass das Problem erstellt wurde

Group 64 (85).png

Niederlassungen

Der Tab Zweige zeigt alle Zweige, die sich auf ein bestimmtes Element in deinem Board beziehen. Sie sind in den folgenden Spalten organisiert:

Zeige mir die Spalten!

Name – der Dateiname des Zweigs, der direkt mit dem Zweig in GitHub verknüpft ist
Repository - aus welchem Repository dieser Zweig stammt
Autor - der Ersteller des Zweigs
Basiszweig - der Ursprungszweig
Commits – Wie viele Commits gab es für diesen Zweig
Zuletzt aktualisiert – eine Live-Anzeige, wie lange es her ist, dass die letzten Änderungen vorgenommen wurden
Pull-Request – ein Link, um entweder einen neuen Pull-Request zu erstellen, oder ein Link zu dem vorhandenen Pull-Request in GitHub

Group 64 (81).png

Wir haben ein Skript integriert, das automatisch einen Zweig erstellt, der mit deinem Element verbunden ist, sodass du deine Element-ID nicht manuell eingeben musst, um die beiden zu verbinden.

Tipp: Du kannst einen neuen Pull Request erstellen, indem du auf den Button PR erstellen unter der Spalte „Pull Request“ im Tab Zweige klickst. Er wird sofort in GitHub sowie im Tab „Pull Requests“ angezeigt!

Commits

Der Tab Commits zeigt alle Zweige, die sich auf ein bestimmtes Element in deinem Board beziehen. Sie sind in den folgenden Spalten organisiert:

Zeige mir die Spalten!

Nachricht – die Nachricht zu diesem Commit
Repository – aus welchem Repository dieser Commit stammt
Zweig – in welchem Zweig sich dieser Commit befindet
Autor - der Ersteller des Zweigs
Erstellt am – der Zeitpunkt der Erstellung

Group 64 (82).png

Fasse deine Daten zusammen

Während die detaillierte Liste all deiner Probleme, Pull Requests und Zweige dir spezifische Details liefert, zeigt dir die Zusammenfassung eine visuelle Aufschlüsselung der aggregierten Daten in deiner GitHub-App!

Um die Zusammenfassung deiner App anzuzeigen, klicke auf das Drei-Punkte-Menü in der oberen rechten Ecke deiner App und dann auf Einstellungen, wie unten gezeigt. Group 64 (87).png

Klicke auf das Drop-down-Menü unter Git UI-Ansicht auswählen und wähle Zusammenfassung. Jetzt kannst du alle deine Daten in einer Übersicht sehen:

Pull-Requests – die Anzahl der Requests und eine batterieartige Darstellung ihres Status
Probleme – die Anzahl der Probleme und eine batterieartige Darstellung ihres Status
Stakeholder – die Anzahl der Stakeholder und ihre monday.com Profilbilder
Dauer – die Gesamtzeit, in der alle diese Daten geöffnet waren

Group 64 (88).png

Tipp: Du kannst den Mauszeiger über eines der Batteriediagramme bewegen, um zu sehen, welchen Status jede Farbe darstellt und wie viele Elemente mit jedem Status gekennzeichnet sind. Wenn du mit der Maus über ein Profilbild fährst, wird der Name des Stakeholders angezeigt, und wenn du mit der Maus über die Dauer fährst, siehst du das Start- und Enddatum für diesen Zeitraum.

Wenn du Fragen hast, wende dich einfach hier an unser Team. Wir sind rund um die Uhr erreichbar und helfen gerne!