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 som skal hentes inn i Notion fra repositoryene som er tilgjengelige via en GitHub-appinstallasjon: Pull Requests, issues eller begge deler. Repositoryene du velger, overføres til 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 vurderingsdetaljer for 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 din og begynner å importere samsvarende poster.

Under den første importen leser Notion Pull Requests og issues du har valgt fra hvert av de valgte repositoryene. Notion starter med de sist oppdaterte postene og går deretter gjennom den valgte historikken.

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 vindu på 90 dager.

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

• Legg til eller fjern issues eller Pull Requests: Endre hva synkroniseringen henter inn og velg Lagre endringer. Hvis du legger til en type, importeres tilhørende poster. Hvis du fjerner en type, fjernes disse sidene. Postene du allerede har importert for typene du beholder, forblir på plass.

• 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 noe er klart for utgivelse, eller for å koble Pull Requests og issues til teamets planlegging. Verdiene du legger inn i disse egenskapene, 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.

Bekreft at typen er inkludert i synkroniseringen, at riktig repository er valgt, at den sist ble oppdatert innenfor historikkvinduet, og at Notion-visningen din ikke filtrerer den ut. 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 →