เชื่อมต่อ GitHub กับ Notion

การซิงค์ GitHub แบบมีการจัดการจะสร้างฐานข้อมูล GitHub Pull Requests จาก Repo ที่คุณเลือก. Notion จะนำเข้า Pull Request ที่มีอยู่และตรวจสอบการอัปเดตจาก GitHub ในเบื้องหลัง

คู่มือนี้ครอบคลุม การซิงค์ฐานข้อมูล ในการตั้งค่าการเชื่อมต่อ GitHub ของคุณ คุณสมบัติที่ซิงค์จะเป็นแบบอ่านอย่างเดียว โปรดทำการเปลี่ยนแปลง Pull Request ใน GitHub

คุณสามารถซิงค์ Pull Request จาก Repo หลายแห่งที่มีอยู่ผ่านการติดตั้ง GitHub App. Repo ที่เลือกจะถูกรวมเข้ากับฐานข้อมูล Notion เดียวกัน

คุณสมบัติ ผู้เขียน (GitHub) จะมีชื่อผู้ใช้ GitHub ส่วน ผู้เขียน จะเป็นคุณสมบัติบุคคลใน Notion เมื่ออีเมลสาธารณะของผู้เขียนตรงกับสมาชิกในพื้นที่ทำงาน

คุณสมบัติ คำอธิบาย จะซิงค์คำอธิบายของ Pull Request เป็นข้อความธรรมดา โดยคัดลอกมาตามที่เขียนไว้ใน GitHub ทุกประการ ไม่ได้แสดงผลเป็น Markdown

การซิงค์นี้ไม่รวมถึง GitHub issues, ความคิดเห็น, ผู้รับมอบหมาย หรือรายละเอียดการตรวจสอบ

สิ่งที่คุณต้องมี:

• การเป็นสมาชิกในพื้นที่ทำงาน Notion

• บัญชี GitHub ที่สามารถเข้าถึง Repo ที่คุณต้องการซิงค์

• การติดตั้ง GitHub App ที่สามารถเข้าถึง Repo เหล่านั้น

• แพ็คเกจ Business (Mobile Business ก็มีสิทธิ์) – การซิงค์ GitHub ไม่สามารถใช้งานได้ในแพ็คเกจอื่น

ทั้งบัญชี GitHub และการติดตั้งแอปของคุณจำเป็นต้องได้รับสิทธิ์การเข้าถึง องค์กร GitHub ของคุณอาจกำหนดให้เจ้าของเป็นผู้รับรองหรือติดตั้งแอปดังกล่าว

1. ใน Notion ให้ไปที่ การตั้งค่า → การเชื่อมต่อ → GitHub

2. เปิด การซิงค์ฐานข้อมูล และเชื่อมต่อบัญชี GitHub ของคุณหากคุณยังไม่ได้ดำเนินการ

3. ดำเนินการตามขั้นตอนการอนุญาตและการติดตั้งของ GitHub ให้เสร็จสิ้น

4. เลือกองค์กรหรือบัญชีที่มี Repo ที่คุณต้องการซิงค์. ใช้ เพิ่มองค์กร… หากคุณต้องการเพิ่มการติดตั้งอื่น

5. เลือก Repo ที่จะรวมไว้

6. เลือกประวัติที่มีอยู่ทั้งหมดหรือช่วงเวลาของประวัติ

7. เลือก สร้างการซิงค์

Notion จะสร้าง GitHub Pull Requests ในส่วนแถบด้านข้าง ส่วนตัว ของคุณ และเริ่มนำเข้า Pull Request ที่ตรงกัน

ในระหว่างการนำเข้าครั้งแรก Notion จะอ่าน Pull Request จากแต่ละ Repo ที่เลือก โดยเริ่มจากบันทึกที่อัปเดตล่าสุดและดำเนินการตามประวัติที่เลือกไว้

หลังจากการนำเข้า Notion จะตรวจสอบ Pull Request ใหม่และที่อัปเดตในแต่ละ Repo เป็นประจำ. การเปลี่ยนแปลงต่างๆ เช่น ป้ายกำกับใหม่, Pull Request ที่ปิดแล้ว หรือการรวม จะอัปเดตคุณสมบัติที่เกี่ยวข้องใน Notion

การซิงค์จะทำงานแม้ในขณะที่คุณปิด Notion. Repo ขนาดใหญ่, ขีดจำกัดคำขอของ GitHub และปัญหาบริการชั่วคราวอาจทำให้การอัปเดตล่าช้า. ตรวจสอบสถานะการซิงค์เพื่อดูความคืบหน้าหรือข้อผิดพลาด

เลือก ประวัติทั้งหมด, 30 วันล่าสุด, 90 วันล่าสุด หรือ 365 วันล่าสุด เมื่อมีการเสนอการซิงค์ประวัติทั้งหมดเป็นสวิตช์ ให้เปิด ซิงค์ประวัติที่มีอยู่ทั้งหมด ไว้เพื่อรวม Pull Request ที่มีอยู่ทั้งหมด

หน้าต่างนี้จะใช้เวลา อัปเดตเมื่อ ของ Pull Request โดยไม่ขึ้นอยู่กับเวลาที่สร้าง Pull Request หรือสถานะว่าเปิด ปิด หรือรวมอยู่หรือไม่

ตัวอย่างเช่น Pull Request ที่เปิดอยู่ซึ่งไม่มีการเปลี่ยนแปลงมานานกว่า 90 วันอาจอยู่นอกหน้าต่าง 90 วันได้

เปิดการซิงค์ใน การตั้งค่า → การเชื่อมต่อ → GitHub → การซิงค์ฐานข้อมูล

• เพิ่ม Repo: แก้ไขส่วนที่เลือกแล้วเลือก บันทึกการเปลี่ยนแปลง Notion จะนำเข้าคำขอดึงข้อมูลที่ตรงกันจาก Repo ที่เพิ่มเข้ามา

• ลบ Repo: ยกเลิกการเลือก Repo เหล่านั้นแล้วบันทึก. หน้าของ Pull Request ที่ซิงค์ไว้จะถูกลบออกจาก Notion

• ประวัติการเปลี่ยนแปลง: หน้าต่างที่ยาวขึ้นจะนำเข้าระเบียนเพิ่มเติม หน้าต่างที่สั้นลงจะลบระเบียนที่อยู่นอกหน้าต่างใหม่

• หยุดการอัปเดตชั่วคราว: เลือก หยุดการซิงค์ชั่วคราว ข้อมูลและการตั้งค่าที่มีอยู่จะยังคงอยู่

• ดำเนินการอัปเดตต่อ: เลือก ดำเนินการซิงค์ต่อ เพื่อซิงค์ต่อ

ก่อนที่จะลบ Repo หรือทำให้ประวัติสั้นลง ให้เก็บรักษาข้อมูลเฉพาะใน Notion ที่คุณต้องการจากหน้าที่ได้รับผลกระทบไว้

สร้างมุมมองตาม Repo, สถานะ, ผู้เขียน หรือป้ายกำกับ. เพิ่มพร็อพเพอร์ตี้ของคุณเองเพื่อติดตามความพร้อมในการเผยแพร่หรือเชื่อมต่อ Pull Request กับกระบวนการวางแผนของทีมคุณ. ค่าพร็อพเพอร์ตี้เหล่านี้จะยังคงอยู่ใน Notion

หากต้องการเปลี่ยนพร็อพเพอร์ตี้ GitHub ให้เปิดคำขอดึงข้อมูลโดยใช้ URL ของ GitHub และทำการเปลี่ยนแปลงใน GitHub

ฐานข้อมูลเริ่มต้นเป็นแบบส่วนตัว หากคุณแชร์ฐานข้อมูลนั้น การตั้งค่าการแชร์ของ Notion จะเป็นตัวกำหนดว่าใครสามารถดูข้อมูลที่นำเข้าได้บ้าง ผู้ดูไม่จำเป็นต้องเข้าถึง Repo ต้นทางทุกคน ดังนั้นโปรดตรวจสอบสิทธิ์ของฐานข้อมูลก่อนที่จะแชร์ข้อมูล Repo ส่วนตัว

ตรวจสอบว่าคุณได้เลือกบัญชี GitHub และการติดตั้งแอปที่ถูกต้องแล้ว ยืนยันว่าทั้งบัญชีของคุณและแอปมีการเข้าถึง Repo หากองค์กรจำกัดการติดตั้งแอป ให้ขอให้เจ้าของอนุมัติการเข้าถึง

เปิดการตั้งค่า Repo ของการซิงค์ ตรวจสอบการเลือก Repo แล้วบันทึกอีกครั้ง หากย้ายไปยังองค์กรอื่น ให้ยืนยันว่าการเชื่อมต่อมีการเข้าถึงในตำแหน่งใหม่

ชื่อผู้ใช้ GitHub ไม่ได้มีอีเมลสาธารณะที่ตรงกับสมาชิกพื้นที่ทำงาน Notion เสมอไป ใช้ ผู้เขียน (GitHub) เพื่อระบุตัวผู้เขียนเมื่อพร็อพเพอร์ตี้บุคคลว่างเปล่า การเปลี่ยนแปลงอีเมลหรือการเป็นสมาชิกพื้นที่ทำงานของผู้เขียนอาจไม่รีเฟรช Pull Request ที่ซิงค์ไว้ก่อนหน้านี้โดยอัตโนมัติ

ยืนยันว่า Repo นั้นถูกเลือกไว้แล้ว การอัปเดตล่าสุดอยู่ในหน้าต่างประวัติ และมุมมอง Notion ของคุณไม่ได้กรองข้อมูลนั้นออก การนำเข้าครั้งแรกอาจยังคงอยู่ในรอบการทำงาน

เปิดรายละเอียดสถานะของการซิงค์ เชื่อมต่อบัญชี GitHub ของคุณใหม่หรือกู้คืนการเข้าถึง Repo หากได้รับแจ้ง ขีดจำกัดคำขอของ GitHub และการหยุดชะงักชั่วคราวอาจทำให้การอัปเดตล่าช้าในขณะที่ Notion พยายามลองใหม่

สำหรับการเปรียบเทียบกับ Workers และคำแนะนำในการแก้ไขปัญหาที่ใช้ร่วมกัน โปรดดู ซิงค์ข้อมูลจากเครื่องมืออื่นไปยัง Notion →