GitHub mit Notion verbinden

Eine verwaltete GitHub-Synchronisierung erstellt eine GitHub Pull Requests-Datenbank aus Repositories deiner Wahl. Notion importiert bestehende Pull-Requests und prüft im Hintergrund auf Alle Updates in GitHub.

Dieser Leitfaden behandelt die Datenbanksynchronisierung in deinen GitHub-Verbindungseinstellungen. Synchronisierte Eigenschaften sind schreibgeschützt. Nimm Änderungen an Pull-Requests in GitHub vor.

Du kannst Pull-Requests aus mehreren Repositories synchronisieren, die über eine GitHub-App-Installation verfügbar sind. Die ausgewählten Repositories fließen in eine Notion-Datenbank ein.

Die Eigenschaft Autor/-in (GitHub) enthält den GitHub-Benutzernamen. Autor/-in ist eine Notion-Personeneigenschaft, wenn die verfügbare öffentliche E-Mail-Adresse des Autors mit einem Workspace-Mitglied übereinstimmt.

Die Eigenschaft Beschreibung synchronisiert die Beschreibung des Pull-Requests als reinen Text, der exakt so kopiert wird, wie er in GitHub geschrieben wurde. Er wird nicht als Markdown gerendert.

Diese Synchronisierung umfasst keine GitHub-Issues, Kommentare, Zuweisungen / zuständige Personen oder Rezensionsdetails.

Du benötigst:

• Eine Mitgliedschaft im Notion-Workspace.

• Ein GitHub-Konto mit Zugriff auf die Repositories, die du synchronisieren möchtest.

• Eine GitHub-App-Installation mit Zugriff auf diese Repositories.

• Einen Business Plan (Mobile Business ist ebenfalls qualifiziert). Die GitHub-Synchronisierung ist in anderen Plänen nicht verfügbar.

Sowohl dein GitHub-Konto als auch die App-Installation benötigen Zugriff. Deine GitHub-Organisation kann verlangen, dass ein Inhaber die App genehmigt oder installiert.

1. Gehe in Notion zu Einstellungen → Integrationen und Konnektoren → GitHub.

2. Öffne Datenbanksynchronisierung und verbinde dein GitHub-Konto, falls du das noch nicht getan hast.

3. Schließe die Autorisierungs- und Installationsschritte von GitHub ab.

4. Wähle die Organisation oder das Konto aus, deren Repositories du synchronisieren möchtest. Verwende Organisation hinzufügen…, wenn du eine weitere Installation hinzufügen musst.

5. Wähle die Repositories aus, die einbezogen werden sollen.

6. Wähle den gesamten verfügbaren Verlauf oder ein Zeitfenster für den Verlauf.

7. Wähle Synchronisierung erstellen.

Notion erstellt GitHub Pull Requests in deiner Privat-Seitenleiste und beginnt mit dem Importieren passender Pull Requests.

Während des ersten Imports liest Notion Pull Requests aus jedem ausgewählten Repository, beginnend mit den zuletzt aktualisierten Datensätzen und arbeitet sich durch den ausgewählten Verlauf.

Nach dem Import prüft Notion regelmäßig jedes Repository auf neue und aktualisierte Pull Requests. Änderungen wie ein neues Label, ein geschlossener Pull Request oder eine Zusammenführung aktualisieren die entsprechenden Eigenschaften in Notion.

Die Synchronisierung läuft auch dann weiter, wenn du Notion schließt. Große Repositories, GitHub-Anfragebeschränkungen und vorübergehende Dienstprobleme können Updates verzögern. Überprüfe den Status der Synchronisierung auf Fortschritt oder Fehler.

Wähle Gesamter Verlauf, Letzte 30 Tage, Letzte 90 Tage oder Letzte 365 Tage. Wenn die Synchronisierung des gesamten Verlaufs als Umschalter angeboten wird, lass Gesamten verfügbaren Verlauf synchronisieren aktiviert, um alle verfügbaren Pull Requests einzubeziehen.

Das Zeitfenster verwendet den Aktualisiert am-Zeitpunkt des Pull Requests. Es hängt nicht davon ab, wann der Pull Request erstellt wurde oder ob er offen, geschlossen oder zusammengeführt ist.

Zum Beispiel kann ein offener Pull Request, der sich seit mehr als 90 Tagen nicht geändert hat, außerhalb eines 90-Tage-Fensters liegen.

Öffne die Synchronisierung unter Einstellungen → Integrationen und Konnektoren → GitHub → Datenbanksynchronisierung.

• Repositories hinzufügen: Bearbeite die Auswahl und wähle Änderungen speichern. Notion importiert passende Pull Requests aus den hinzugefügten Repositories.

• Repositories entfernen: Hebe die Auswahl auf und speichere. Ihre synchronisierten Pull-Request-Seiten werden aus Notion entfernt.

• Änderungsverlauf: Ein längeres Zeitfenster importiert zusätzliche Datensätze. Ein kürzeres Zeitfenster entfernt Datensätze außerhalb des neuen Zeitfensters.

• Updates pausieren: Wähle Synchronisierung pausieren. Die vorhandenen Daten und Einstellungen bleiben erhalten.

• Updates fortsetzen: Wähle Synchronisierung fortsetzen, um die Synchronisierung fortzusetzen.

Bevor du Repositories entfernst oder den Verlauf verkürzst, sichere alle Notion-spezifischen Informationen, die du von den betroffenen Seiten benötigst.

Erstelle Ansichten nach Repository, Status, Autor oder Label. Füge deine eigenen Eigenschaften hinzu, um die Release-Bereitschaft zu verfolgen oder Pull-Requests mit dem Planungsprozess deines Teams zu verknüpfen. Deine eigenen Eigenschaftswerte bleiben in Notion.

Um eine GitHub-Eigenschaft zu ändern, öffne den Pull Request über die GitHub-URL und nimm die Änderung in GitHub vor.

Die Datenbank ist anfangs privat. Wenn du sie freigibst, bestimmen die Freigabeeinstellungen von Notion, wer die importierten Daten sehen kann. Betrachter brauchen nicht jeweils Zugriff auf das Quell-Repository. Überprüfe daher die Berechtigungen der Datenbank, bevor du Informationen zu privaten Repositories freigibst.

Überprüfe, ob du das richtige GitHub-Konto und die richtige App-Installation ausgewählt hast. Bestätige, dass sowohl dein Konto als auch die App Zugriff auf das Repository haben. Falls eine Organisation App-Installationen einschränkt, bitte einen Inhaber, den Zugriff zu genehmigen.

Öffne die Repository-Einstellungen der Synchronisierung, überprüfe die Repository-Auswahl und speichere sie erneut. Wenn sie in eine andere Organisation verschoben wurde, bestätige, dass die Verbindung am neuen Speicherort Zugriff hat.

Ein GitHub-Benutzername verfügt nicht immer über eine verfügbare öffentliche E-Mail-Adresse, die mit einem Mitglied des Notion-Arbeitsbereichs übereinstimmt. Verwenden Sie Autor (GitHub), um den Autor zu identifizieren, wenn die Person-Eigenschaft leer ist. Änderungen an der E-Mail-Adresse oder der Mitgliedschaft im Arbeitsbereich eines Autors werden möglicherweise nicht automatisch auf ältere synchronisierte Pull-Requests angewendet.

Bestätige, dass das zugehörige Repository ausgewählt ist, dass die letzte Aktualisierung innerhalb des Verlaufsfensters liegt und dass deine Notion-Ansicht es nicht herausfiltert. Der erste Import läuft möglicherweise noch.

Öffne die Statusdetails der Synchronisierung. Verbinde dein GitHub-Konto erneut oder stelle den Repository-Zugriff wieder her, falls du dazu aufgefordert wirst. GitHub-Anfragebeschränkungen und vorübergehende Ausfälle können Aktualisierungen verzögern, während Notion es erneut versucht.

Vergleiche mit Workers und gemeinsame Anleitungen zur Fehlerbehebung findest du unter Daten aus anderen Tools mit Notion synchronisieren →.