Koble GitHub til Notion

En administrert GitHub-synkronisering henter GitHub-arbeidet du velger inn i Notion: Pull Requests, issues eller begge deler. Notion importerer eksisterende poster og sjekker GitHub for oppdateringer i bakgrunnen.

Denne veiledningen dekker Databasesynkronisering i innstillingene for GitHub-forbindelsen din. Synkroniserte egenskaper er skrivebeskyttede. Gjør endringer i Pull Requests og issues i GitHub.

Velg hva du vil hente inn i Notion fra repositoryene du har tilgang til via en installert GitHub-app: Pull Requests, issues eller begge deler. Innhold fra repositoryene du velger, hentes inn i Notion.

Egenskapen Forfatter (GitHub) inneholder GitHub-brukernavnet. Forfatter er en Notion-person-egenskap når forfatterens tilgjengelige offentlige e-post samsvarer med et arbeidsområdemedlem.

Egenskapen Beskrivelse synkroniserer Pull Request-beskrivelsen som ren tekst, kopiert nøyaktig slik den er skrevet i GitHub. Den gjengis ikke som Markdown.

Du kan synkronisere GitHub-issues for seg selv eller sammen med Pull Requests. Denne synkroniseringen inkluderer ikke kommentarer eller detaljer om vurderinger av Pull Requests.

Du trenger:

• Medlemskap i Notion-arbeidsområde.

• En GitHub-konto med tilgang til repository du vil synkronisere.

• En GitHub App-installasjon med tilgang til disse repository.

• Et Business-abonnement (Mobile Business kvalifiserer også). GitHub-synkronisering er ikke tilgjengelig på andre abonnement.

Både GitHub-kontoen din og appinstallasjonen trenger tilgang. GitHub-organisasjonen din kan kreve at en Eier(e) godkjenner eller installerer appen.

1. I Notion, gå til Innstillinger → Tilkoblinger → GitHub.

2. Åpne Databasesynkronisering og koble til GitHub-kontoen din hvis du ikke allerede har gjort det.

3. Fullfør GitHubs autorisasjons- og installasjonstrinn.

4. Velg organisasjonen eller kontoen hvis repository du vil synkronisere. Bruk Legg til organisasjon… hvis du trenger å legge til en installasjon til.

5. Velg repositoryene som skal inkluderes.

6. Gi synkroniseringen et navn og velg hva som skal hentes inn i Notion: Pull Requests, issues eller begge deler.

7. Velg all tilgjengelig historikk eller et historikkvindu.

8. Velg Opprett synkronisering.

Notion oppretter den synkroniserte databasen i Privat-delen av sidestolpen og starter importen av samsvarende poster.

Under den første importen leser Notion Pull Requests og issues du har valgt, fra hvert repository du har valgt. Den starter med de sist oppdaterte postene og går videre gjennom historikken du har valgt.

Etter importen sjekker Notion jevnlig hvert repository for nye og oppdaterte poster. Endringer, som en ny merkelapp, en lukket Pull Request eller en gjenåpnet issue, oppdaterer de tilsvarende egenskapene i Notion.

Synkroniseringen kjører selv når du lukker Notion. Store repository, GitHub-forespørselsbegrensninger og midlertidige tjenesteproblemer kan forsinke Oppdateringer. Sjekk synkroniseringsstatusen for fremdrift eller feil.

Velg All historikk, Siste 30 dager, Siste 90 dager eller Siste 365 dager. Når synkronisering av all historikk tilbys som en bryter, la Synkroniser all tilgjengelig historikk være på for å inkludere alle tilgjengelige Pull Requests.

Vinduet bruker Pull Requestens Oppdatert-tidspunkt. Det avhenger ikke av når Pull Requesten ble opprettet, eller om den er åpen, lukket eller flettet.

For eksempel kan en åpen Pull Request eller issue som ikke har endret seg på mer enn 90 dager, falle utenfor et tidsvindu på 90 dager.

Åpne synkroniseringen i Innstillinger → Tilkoblinger → GitHub → Databasesynkronisering.

• Legge til eller fjerne issues eller Pull Requests: Endre hva synkroniseringen henter inn, og velg Lagre endringer. Når du legger til en type, importeres tilhørende poster. Når du fjerner en type, fjernes sidene for den typen. Postene for typene du beholder, blir værende.

• Legg til repositories: Rediger utvalget og velg Lagre endringer. Notion importerer samsvarende Pull Requests fra de tillagte repositories.

• Fjern repositories: Fjern merkingen av dem og lagre. De synkroniserte Pull Request-sidene deres fjernes fra Notion.

• Endringshistorikk: Et lengre tidsvindu importerer flere oppføringer. Et kortere tidsvindu fjerner oppføringer utenfor det nye tidsvinduet.

• Sette oppdateringer på pause: Velg Sett synkronisering på pause. De eksisterende dataene og innstillingene forblir uendret.

• Gjenoppta oppdateringer: Velg Gjenoppta synkronisering for å fortsette synkroniseringen.

Før du fjerner repositories eller forkorter historikken, må du ta vare på all informasjon som kun finnes i Notion, som du trenger fra de berørte sidene.

Opprett visninger etter repository, status, forfatter eller merkelapp. Legg til egne egenskaper for å spore om en utgivelse er klar eller knytte Pull Requests og issues til teamets planlegging. Verdiene i dine egne egenskaper blir værende i Notion.

Åpne posten via GitHub-URL og gjør endringen i GitHub hvis du vil endre en GitHub-egenskap.

Databasen starter som Privat. Hvis du deler den, bestemmer Notions delingsinnstillinger hvem som kan se de importerte dataene. Visninger trenger ikke hver for seg tilgang til kilde-repositoryet, så vurder databasens Tilganger før du deler informasjon om Privat repository.

Kontroller at du har valgt riktig GitHub-konto og appinstallasjon. Bekreft at både kontoen din og appen har tilgang til repository. Hvis en organisasjon begrenser appinstallasjoner, må du be en Eier(e) om å godkjenne tilgang.

Åpne repository-innstillingene for synkroniseringen, gå gjennom valg av repository og lagre det på nytt. Hvis det ble flyttet til en annen organisasjon, må du bekrefte at tilkoblingen har tilgang på det nye stedet.

Et GitHub-brukernavn har ikke alltid en tilgjengelig offentlig e-postadresse som samsvarer med et arbeidsområdemedlem. Bruk Forfatter (GitHub) for å identifisere forfatteren når personegenskapen er tom. Endringer i en forfatters e-postadresse eller medlemskap i arbeidsområdet oppdaterer kanskje ikke eldre synkroniserte Pull Requests automatisk.

Sjekk at typen er med i synkroniseringen, at riktig repository er valgt, at den siste oppdateringen er innenfor det valgte tidsvinduet, og at visningen din i Notion ikke filtrerer den bort. Den første importen kan fortsatt pågå.

Åpne Statusdetaljene for synkroniseringen. Koble til GitHub-kontoen din på nytt eller gjenopprett tilgang til repositoryet hvis du blir bedt om det. Begrensninger for GitHub-forespørsler og midlertidige avbrudd kan forsinke Oppdateringer mens Notion prøver på nytt.

For en sammenligning med Workers og delt feilsøkingsveiledning, se Synkroniser data fra andre verktøy til Notion →