Koble GitHub til Notion

En administrert GitHub-synkronisering oppretter en GitHub Pull Requests-database fra repository du velger. Notion importerer eksisterende Pull Requests og ser etter Oppdateringer i GitHub i bakgrunnen.

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

Du kan synkronisere Pull Requests fra flere repository som er tilgjengelige gjennom en GitHub App-installasjon. De valgte repository feedes inn i én Notion-database.

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.

Denne synkroniseringen inkluderer ikke GitHub-saker, kommentarer, tildelte personer eller vurderingsdetaljer.

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. Velg all tilgjengelig historikk eller et historikkvindu.

7. Velg Opprett synkronisering.

Notion oppretter GitHub Pull Requests i Privat-delen av sidestolpen og begynner å importere samsvarende pull requests.

Under den første importen leser Notion Pull Requests fra hvert valgt repository, med start fra de sist oppdaterte postene og videre gjennom den valgte historikken.

Etter importen sjekker Notion jevnlig hvert repository for nye og oppdaterte Pull Requests. Endringer, som en ny merkelapp, en lukket Pull Request eller en flettet oppdatering, 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 som ikke har endret seg på mer enn 90 dager, falle utenfor et 90-dagersvindu.

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

• 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 dine egne egenskaper for å spore utgivelsesberedskap eller koble Pull Requests til teamets planleggingsprosess. Dine egne egenskapsverdier forblir i Notion.

For å endre en GitHub-egenskap, åpne Pull Requesten ved hjelp av GitHub-URL og gjør endringen i GitHub.

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 repository er valgt, at den siste oppdateringen er innenfor historikkvinduet, og at Notion-visningen din ikke filtrerer den ut. Den første importen kan fortsatt være under kjøring.

Å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 →