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-forbindelsene dine. Synkroniserte egenskaper er skrivebeskyttede. Gjør endringer i Pull Requests og issues i GitHub.

Velg hva som skal hentes inn i Notion fra de tilgjengelige repository via en GitHub App-installasjon: Pull Requests, issues eller begge deler. Repositoryene du velger, feed 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 Synkronisert database i din Privat sidestolpe og begynner å importere samsvarende poster.

Under den første importen leser Notion Pull Requests og issues du valgte 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 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 90-dagersvindu.

Å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 de tilhørende postene. 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 dine egne egenskaper for å spore utgivelsesberedskap eller koble Pull Requests og issues til teamets planleggingsprosess. Dine egne egenskapsverdier forblir i Notion.

For å endre en GitHub-egenskap, åpne posten 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 typen er inkludert i synkroniseringen, at repository er valgt, at den siste oppdateringen er innenfor historikkvinduet, og at din Notion-visning 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 →