GitHub mit Notion verbinden

Eine verwaltete GitHub-Synchronisierung bringt die von dir ausgewählte GitHub-Arbeit in Notion: Pull-Requests, Issues oder beides. Notion importiert deine bestehenden Datensätze und prüft im Hintergrund auf Alle Updates in GitHub.

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

Wähle aus, was aus den über eine GitHub-App-Installation verfügbaren Repositories in Notion importiert werden soll: Pull Requests, Issues oder beides. Die von dir ausgewählten Repositories fließen in Notion 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.

Du kannst GitHub-Issues eigenständig oder zusammen mit Pull Requests synchronisieren. Diese Synchronisierung umfasst keine Kommentare oder Rezensiondetails zu Pull Requests.

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. Benenne deine Synchronisierung und wähle aus, was in Notion importiert werden soll: Pull Requests, Issues oder beides.

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

8. Wähle Synchronisierung erstellen.

Notion erstellt die Synchronisierte Datenbank in deiner Privat-Seitenleiste und beginnt mit dem Import der entsprechenden Datensätze.

Während des ersten Imports liest Notion die von dir ausgewählten Pull-Requests und Issues 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 Datensätze. Änderungen wie ein neues Label, ein geschlossener Pull-Request oder ein wiedereröffnetes Issue 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 oder ein offenes Issue, das 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.

• Issues oder Pull-Requests hinzufügen oder entfernen: Ändere, was die Synchronisierung importiert, und wähle „Änderungen speichern“. Das Hinzufügen eines Typs importiert die entsprechenden Datensätze. Das Entfernen eines Typs entfernt diese Seiten. Die Datensätze, die du bereits für die beibehaltenen Typen importiert hast, bleiben erhalten.

• 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/-in oder Label. Füge deine eigenen Eigenschaften hinzu, um die Release-Bereitschaft zu verfolgen oder Pull-Requests und Issues mit dem Planungsprozess deines Teams zu verknüpfen. Deine eigenen Eigenschaftswerte bleiben in Notion.

Um eine GitHub-Eigenschaft zu ändern, öffne den Datensatz ü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 sein Typ in der Sync enthalten ist, dass sein Repository ausgewählt ist, dass seine 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 →.