Yhdistä GitHub Notioniin.

Hallittu GitHub-synkronointi luo GitHub Pull Requests -tietokannan valitsemistasi arkistoista. Notion tuo olemassa olevat pull-pyynnöt ja tarkistaa GitHubin päivitysten varalta taustalla.

Tämä opas kattaa Database sync -toiminnon GitHub-yhteysasetuksissasi. Synkronoidut ominaisuudet ovat vain lukutilassa. Tee muutokset pull-pyyntöihin GitHubissa.

Voit synkronoida pull-pyyntöjä useista arkistoista, jotka ovat käytettävissä GitHub App -asennuksen kautta. Valitut arkistot syöttävät tietoja yhteen Notion-tietokantaan.

Tekijä (GitHub) -ominaisuus sisältää GitHub-käyttäjänimen. Tekijä on Notion-henkilöominaisuus, kun tekijän julkinen sähköpostiosoite täsmää työtilan jäsenen kanssa.

Kuvaus -ominaisuus synkronoi pull-pyynnön kuvauksen pelkkänä tekstinä, joka kopioidaan täsmälleen sellaisena kuin se on kirjoitettu GitHubissa. Sitä ei renderöidä Markdown-muodossa.

Tämä synkronointi ei sisällä GitHub-ongelmia, kommentteja, vastuuhenkilöitä tai tarkistustietoja.

Tarvitset:

• Jäsenyyden Notion-työtilassa.

• GitHub-tilin, jolla on pääsy synkronoitaviin arkistoihin.

• GitHub App -asennuksen, jolla on pääsy kyseisiin arkistoihin.

• Business-sopimuksen (myös Mobile Business käy). GitHub-synkronointi ei ole käytettävissä muissa sopimuksissa.

Sekä GitHub-tilisi että sovelluksen asennus tarvitsevat käyttöoikeuden. GitHub-organisaatiosi saattaa vaatia, että omistaja hyväksyy tai asentaa sovelluksen.

1. Siirry Notionissa kohtaan Settings → Yhteydet → GitHub.

2. Avaa Database sync ja yhdistä GitHub-tilisi, jos et ole vielä tehnyt niin.

3. Suorita GitHubin valtuutus- ja asennusvaiheet loppuun.

4. Valitse organisaatio tai tili, jonka arkistoja haluat synkronoida. Käytä Add organization… -toimintoa, jos sinun on lisättävä toinen asennus.

5. Valitse sisällytettävät arkistot.

6. Valitse koko saatavilla oleva historia tai historian aikaväli.

7. Valitse Luo synkronointi.

Notion luo GitHub Pull RequestsYksityinen-sivuvalikkoosi ja aloittaa vastaavien pull-pyyntöjen tuomisen.

Ensimmäisen tuonnin aikana Notion lukee pull-pyyntöjä jokaisesta valitusta arkistosta alkaen viimeksi päivitetyistä tietueista ja edeten valitun historian läpi.

Tuonnin jälkeen Notion tarkistaa säännöllisesti jokaisen arkiston uusien ja päivitettyjen pull-pyyntöjen varalta. Muutokset, kuten uusi tunniste, suljettu pull-pyyntö tai yhdistämispäivitys, päivittävät vastaavat ominaisuudet Notionissa.

Synkronointi toimii, vaikka sulkisit Notionin. Suuret arkistot, GitHubin pyyntörajoitukset ja väliaikaiset palveluongelmat voivat viivästyttää päivityksiä. Tarkista synkronoinnin tila edistymisen tai virheiden varalta.

Valitse All history, Last 30 days, Last 90 days tai Last 365 days. Kun koko historian synkronointi on tarjolla valintakytkimenä, jätä Sync all available history päälle, jotta kaikki saatavilla olevat pull-pyyntöjen sisällytetään.

Ikkuna käyttää pull-pyyttöjen Updated At -aikaa. Se ei riipu siitä, milloin pull-pyyntö luotiin tai onko se avoin, suljettu tai yhdistetty.

Esimerkiksi avoin pull-pyyntö, jota ei ole muutettu yli 90 päivään, voi jäädä 90 päivän ikkunan ulkopuolelle.

Avaa synkronointi kohdasta Settings → Yhteydet → GitHub → Database sync.

• Add repositories: Muokkaa valintaa ja valitse Save changes. Notion tuo vastaavat pull-pyynnöt lisätyistä arkistoista.

• Remove repositories: Poista niiden valinta ja tallenna. Niiden synkronoidut pull-pyyntöjen sivut poistetaan Notionista.

• Muutoshistoria: Pidempi ikkuna tuo lisää tietueita. Lyhyempi ikkuna poistaa uuden ikkunan ulkopuolelle jäävät tietueet.

• Päivitysten keskeyttäminen: Valitse Keskeytä synkronointi. Olemassa olevat tiedot ja asetukset säilyvät.

• Päivitysten jatkaminen: Valitse Jatka synkronointia jatkaaksesi synkronointia.

Ennen kuin poistat arkistoja tai lyhennät historiaa, säilytä tarvitsemasi Notion-kohtaiset tiedot kyseisiltä sivuilta.

Luo näkymiä arkiston, tilan, tekijän tai tunnisteen mukaan. Lisää omia ominaisuuksiasi seurataksesi julkaisuvalmiutta tai yhdistääksesi pull-pyyntöjä tiimisi suunnitteluprosessiin. Omat ominaisuusarvosi pysyvät Notionissa.

Muuttaaksesi GitHub-ominaisuutta, avaa pull-pyyntö käyttämällä GitHub URL-osoitetta ja tee muutos GitHubissa.

Tietokanta on aluksi yksityinen. Jos jaat sen, Notionin jakoasetukset määrittävät, kuka näkee tuodut tiedot. Katselijoilla ei tarvitse olla pääsyä lähdearkistoon, joten tarkista tietokannan käyttöoikeudet ennen yksityisen arkiston tietojen jakamista.

Tarkista, että olet valinnut oikean GitHub-tilin ja sovellusasennuksen. Vahvista, että sekä tililläsi että sovelluksella on pääsy arkistoon. Jos organisaatio rajoittaa sovellusasennuksia, pyydä omistajaa hyväksymään pääsy.

Avaa synkronoinnin arkistoasetukset, tarkista arkistovalinta ja tallenna se uudelleen. Jos se siirrettiin toiseen organisaatioon, vahvista, että yhteydellä on pääsy uuteen sijaintiin.

GitHub-käyttäjänimellä ei aina ole julkista sähköpostiosoitetta, joka vastaa Notion-työtilan jäsentä. Käytä Tekijä (GitHub)-ominaisuutta tekijän tunnistamiseen, kun henkilö-ominaisuus on tyhjä. Muutokset tekijän sähköpostiosoitteeseen tai työtilan jäsenyyteen eivät välttämättä päivitä vanhempia synkronoituja pull-pyyntöjä automaattisesti.

Vahvista, että sen repository on valittu, että sen viimeisin päivitys on historiaikkunan puitteissa ja ettei Notion-näkymäsi suodata sitä pois. Ensimmäinen tuonti saattaa vielä olla käynnissä.

Avaa synkronoinnin tilatiedot. Yhdistä GitHub-tilisi uudelleen tai palauta repositoryn käyttöoikeus, jos sitä pyydetään. GitHubin pyyntörajoitukset ja tilapäiset käyttökatkokset voivat viivästyttää päivityksiä, kun Notion yrittää uudelleen.

Vertailua Workersin kanssa ja jaettuja vianmääritysohjeita varten, katso Synkronoi tietoja muista työkaluista Notioniin →