GitHub koppelen aan Notion

Een beheerde GitHub-synchronisatie brengt het GitHub-werk dat je kiest naar Notion: pull requests, issues of beide. Notion importeert je bestaande records en controleert op de achtergrond of er updates zijn in GitHub.

Deze handleiding gaat over Databasesynchronisatie in de instellingen van je GitHub-verbinding. Gesynchroniseerde eigenschappen kun je alleen bekijken. Wijzig pull requests en issues in GitHub.

Kies wat je vanuit de repositories die beschikbaar zijn via een GitHub App-installatie naar Notion wilt halen: pull requests, issues of beide. De repositories die je selecteert, leveren de gegevens voor Notion.

De Auteur (GitHub)-eigenschap bevat de GitHub-gebruikersnaam. Auteur is een Notion-persoonseigenschap wanneer het beschikbare openbare e-mailadres van de auteur overeenkomt met een werkruimtelid.

De Beschrijving-eigenschap synchroniseert de beschrijving van de Pull Request als tekst, exact gekopieerd zoals geschreven in GitHub. Deze wordt niet gerenderd als Markdown.

Je kunt GitHub-issues afzonderlijk of naast pull requests synchroniseren. Deze synchronisatie bevat geen opmerkingen bij pull requests of details van reviews.

Je hebt het volgende nodig:

• Lidmaatschap van de Notion workspace.

• Een GitHub-account met toegang tot de repositories die je wilt synchroniseren.

• Een GitHub App-installatie met toegang tot die repositories.

• Een Business-abonnement (Mobile Business komt ook in aanmerking). GitHub-synchronisatie is niet beschikbaar in andere abonnementen.

Zowel je GitHub-account als de app-installatie hebben toegang nodig. Je GitHub-organisatie vereist mogelijk dat een eigenaar de app goedkeurt of installeert.

1. Ga in Notion naar Settings → koppelingen → GitHub.

2. Open Database sync en koppel je GitHub-account als je dat nog niet hebt gedaan.

3. Voltooi de autorisatie- en installatiestappen van GitHub.

4. Kies de organisatie of het account waarvan je de repositories wilt synchroniseren. Gebruik Add organization… als je een andere installatie wilt toevoegen.

5. Selecteer de repositories die je wilt opnemen.

6. Geef je synchronisatie een naam en kies wat je naar Notion wilt halen: pull requests, issues of beide.

7. Kies alle beschikbare geschiedenis of een geschiedenisvenster.

8. Selecteer Synchronisatie maken.

Notion maakt de gesynchroniseerde database aan in je sectie Privé in de zijbalk en begint met het importeren van overeenkomende records.

Tijdens de eerste import leest Notion de pull requests en issues die je hebt gekozen uit elke geselecteerde repository. Notion begint met de meest recent bijgewerkte records en doorloopt vervolgens de geselecteerde geschiedenis.

Na de import controleert Notion regelmatig elke repository op nieuwe en bijgewerkte records. Wijzigingen zoals een nieuw label, een gesloten pull request of een heropend issue werken de bijbehorende eigenschappen in Notion bij.

De synchronisatie loopt door, zelfs als je Notion afsluit. Grote repositories, GitHub-verzoeklimieten en tijdelijke serviceproblemen kunnen updates vertragen. Controleer de status van de synchronisatie voor voortgang of fouten.

Kies All history, Last 30 days, Last 90 days of Last 365 days. Wanneer synchronisatie van alle geschiedenis als schakelaar wordt aangeboden, laat Sync all available history dan aanstaan om alle beschikbare pull requests op te nemen.

Het venster gebruikt de Updated At-tijd van de pull request. Het is niet afhankelijk van wanneer de pull request is aangemaakt of of deze open, gesloten of Gemerged is.

Een open pull request of issue dat bijvoorbeeld al meer dan 90 dagen niet is gewijzigd, kan buiten een venster van 90 dagen vallen.

Open de synchronisatie in Settings → koppelingen → GitHub → Database sync.

• Issues of pull requests toevoegen of verwijderen: Wijzig wat de synchronisatie ophaalt en selecteer Wijzigingen opslaan. Het toevoegen van een type importeert de bijbehorende records. Het verwijderen van een type verwijdert die pagina's. De records die je al hebt geïmporteerd voor de types die je behoudt, blijven staan.

• Add repositories: Bewerk de selectie en selecteer Save changes. Notion importeert overeenkomende pull requests uit de toegevoegde repositories.

• Remove repositories: Deselecteer ze en sla op. Hun gesynchroniseerde pull request-pagina's worden uit Notion verwijderd.

• Wijzigingsgeschiedenis: Een langer venster importeert extra records. Een korter venster verwijdert records buiten het nieuwe venster.

• Updates pauze: Selecteer Pauze synchronisatie. De bestaande gegevens en instellingen blijven behouden.

• Updates hervatten: Selecteer Synchronisatie hervatten om door te gaan met synchroniseren.

Voordat je repositories verwijdert of de geschiedenis verkort, moet je alle informatie die alleen in Notion staat en die je nodig hebt, veiligstellen vanaf de betreffende pagina's.

Maak weergaven op basis van repository, status, auteur of label. Voeg zelf eigenschappen toe om bij te houden of een release klaar is of om pull requests en issues te koppelen aan de planning van je team. De waarden die je zelf aan eigenschappen toevoegt, blijven in Notion.

Om een GitHub-eigenschap te wijzigen, open je het record via GitHub URL en voer je de wijziging door in GitHub.

De database begint als Privé. Als je deze deelt, bepalen de instellingen voor delen van Notion wie de geïmporteerde gegevens kan zien. Kijkers hebben niet elk toegang nodig tot de bron-repository, dus controleer de machtigingen van de database voordat je informatie over een Privé-repository deelt.

Controleer of je het juiste GitHub-account en de juiste app-installatie hebt geselecteerd. Bevestig dat zowel je account als de app toegang hebben tot de repository. Als een organisatie app-installaties beperkt, vraag dan een eigenaar om toegang goed te keuren.

Open de repository-instellingen van de synchronisatie, controleer de repository-selectie en sla deze opnieuw op. Als deze naar een andere organisatie is verplaatst, bevestig dan dat de verbinding toegang heeft op de nieuwe locatie.

Een GitHub-gebruikersnaam heeft niet altijd een beschikbaar openbaar e-mailadres dat overeenkomt met een lid van de Notion workspace. Gebruik Auteur (GitHub) om de auteur te identificeren wanneer de eigenschap persoon leeg is. Wijzigingen in het e-mailadres of het lidmaatschap van de workspace van een auteur worden mogelijk niet automatisch bijgewerkt voor oudere gesynchroniseerde Pull Requests.

Controleer of het type is opgenomen in de synchronisatie, of de repository is geselecteerd, of de laatste update binnen het geschiedenisvenster valt en of je Notion-weergave het record niet uitfiltert. De eerste import is mogelijk nog bezig.

Open de statusdetails van de synchronisatie. Verbind je GitHub-account opnieuw of herstel de toegang tot de repository als daarom wordt gevraagd. GitHub-verzoeklimieten en tijdelijke storingen kunnen updates vertragen terwijl Notion het opnieuw probeert.

Voor een vergelijking met Workers en gedeelde richtlijnen voor probleemoplossing, zie Gegevens synchroniseren van andere tools naar Notion →