Zum Inhalt springen
AnmeldenKostenlos starten
Alle Hilfeartikel

GitHub

Verknüpfen Sie einen Launch mit einem GitHub-Projekt oder -Meilenstein, und er folgt ihm: Status, Fortschritt und die Status-Updates eines Projekts, täglich und auf Wunsch synchronisiert.

Was GitHub in Taktoria tut

In LaunchCal kann ein Launch seiner Arbeit in GitHub folgen: einem Projekt einer Organisation oder einem Meilenstein eines Repositorys. Sein Status ändert sich, wenn sich der des Projekts oder Meilensteins ändert, er zeigt dessen Fortschritt, und die Status-Updates eines Projekts erscheinen am Launch.

Taktoria liest aus GitHub nur: Es legt dort nie etwas an, ändert nichts und kommentiert nichts. Es ist als App verbunden, die in Ihrer Organisation installiert ist, nicht als Person; deshalb sieht es nur die Repositorys, die die Organisation gewählt hat, und funktioniert weiter, egal wer es verbunden hat.

GitHub verbinden

Nur eine Inhaberin, ein Inhaber oder ein Admin des Workspace kann GitHub verbinden.

  1. Öffnen Sie Einstellungen → Integrationen.
  2. Wählen Sie unter Ticketsysteme die Option GitHub verbinden.
  3. Installieren Sie auf GitHub die Taktoria-App in der Organisation, wählen Sie, welche ihrer Repositorys sie lesen darf, und bestätigen Sie.

Die App bittet darum, die Projekte der Organisation sowie Issues, Pull Requests und Metadaten ihrer Repositorys zu lesen. Muss jemand mit Inhaberrechten in der Organisation sie zuerst genehmigen, sagt Taktoria das: Wählen Sie danach erneut GitHub verbinden. Die Karte zeigt dann, mit welcher Organisation sie verbunden ist. Jeder Taktoria-Workspace verbindet eine.

Was synchronisiert wird, und wann

Ein verknüpfter Launch wird einmal täglich synchronisiert, bis er gelauncht ist, und immer dann, wenn jemand Jetzt synchronisieren wählt.

Bei einem Projekt:

  • Status: Das neueste Status-Update des Projekts bestimmt ihn. Auf Kurs, gefährdet oder nicht auf Kurs wird In Entwicklung (ein Launch, der schon in Design oder Test ist, bleibt dort), inaktiv wird Pausiert, und abgeschlossen ist erledigt. Gibt es noch kein Status-Update, bleibt der Launch auf Zuschnitt, bis einer der Einträge des Projekts erledigt ist. Ein geschlossenes Projekt ist erledigt, es sei denn, es war inaktiv.
  • Fortschritt: der Anteil seiner Einträge, die geschlossen, gemergt oder in einer Erledigt-Spalte sind.
  • Status-Updates: Jedes wird zu einem Update des Launches in seinem Tab Aktivität, gekennzeichnet mit Aus GitHub und einem Link dorthin, und der Zustand des Launches folgt dem neuesten.

Bei einem Meilenstein: offen ohne geschlossene Issues ist Zuschnitt, offen mit einigen geschlossenen ist In Entwicklung, und geschlossen ist erledigt. Sein Fortschritt ist der Anteil seiner geschlossenen Issues. Ein Meilenstein hat keine Updates.

Ist das Projekt oder der Meilenstein erledigt, meldet der Launch, dass er bereit ist, und seine Verantwortlichen werden benachrichtigt. Ein Status, den Sie in LaunchCal wählen, gilt, bis sich der von GitHub wieder ändert. Was eine Synchronisierung ändert, erscheint als Änderung von GitHub, im Verlauf des Launches, in dem, was seine Verantwortlichen erhalten, und im Audit-Log.

Was es nie tut

  • Es launcht nie etwas. Ein erledigtes Projekt oder ein geschlossener Meilenstein macht den Launch bereit; jemand wählt trotzdem selbst Zum Launchen drücken!, sobald seine erforderlichen Prüfungen entschieden sind.
  • Es ändert nie einen Launch, der gelauncht ist.
  • Es schreibt nie in GitHub.
  • Es liest nie ein Repository, das die Organisation ihm nicht gegeben hat.

Verknüpfung lösen und trennen

Verknüpfung lösen im Tab Details des Launches beendet die Synchronisierung dieses Launches; was übernommen wurde, bleibt.

Trennen unter Einstellungen → Integrationen beendet die Synchronisierung aller Launches mit GitHub und beendet den Zugriff von Taktoria sofort. Launches behalten, was sie verknüpfen, und alles bisher Synchronisierte und machen weiter, sobald GitHub wieder verbunden ist. Die App bleibt in der Organisation installiert, bis jemand mit Inhaberrechten sie in den Einstellungen der Organisation auf GitHub deinstalliert.

Fehlerbehebung

  • Das Projekt wurde nicht gefunden: Es wurde gelöscht oder liegt dort, wo die App es nicht sehen kann, etwa in einem Repository, das die Organisation ihr nicht gegeben hat. Jemand mit Inhaberrechten in der Organisation kann das Repository in deren Einstellungen auf GitHub zum Zugriff der App hinzufügen; oder verknüpfen Sie die aktuelle Adresse.
  • GitHub hat die Verbindung abgelehnt: Die App wurde deinstalliert oder gesperrt. Eine Inhaberin, ein Inhaber oder ein Admin des Workspace verbindet GitHub erneut unter Einstellungen → Integrationen.
  • Die App wartet auf Genehmigung: Jemand mit Inhaberrechten in der Organisation genehmigt sie auf GitHub; wählen Sie dann erneut GitHub verbinden.
  • GitHub hat auf die letzte Synchronisierung nicht geantwortet: Die nächste Synchronisierung versucht es erneut, oder wählen Sie später Jetzt synchronisieren.
  • Es bleibt ein einfacher Link: GitHub ist noch nicht verbunden, oder die Adresse ist weder ein Projekt einer Organisation noch ein Meilenstein.
Weiter: Asana