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

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

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

เลือกสิ่งที่จะนำเข้ามาใน Notion จาก Repo ที่มีให้ผ่านการติดตั้ง GitHub App ไม่ว่าจะเป็น Pull Request, Issue หรือทั้งสองอย่าง Repo ที่คุณเลือกจะถูกฟีดเข้าสู่ Notion

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

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

คุณสามารถซิงค์ Issue ของ GitHub แยกต่างหากหรือพร้อมกับ Pull Request ได้ การซิงค์นี้ไม่รวมถึงความคิดเห็นหรือรายละเอียดการตรวจสอบของ Pull Request

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Notion จะสร้างฐานข้อมูลที่ซิงค์ไว้ในส่วนแถบด้านข้างส่วนตัวของคุณและเริ่มนำเข้าข้อมูลที่ตรงกัน

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

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

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

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

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

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

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

• เพิ่มหรือลบ Issue หรือ Pull Request: เปลี่ยนสิ่งที่การซิงค์นำเข้าและเลือกบันทึกการเปลี่ยนแปลง การเพิ่มประเภทจะเป็นการนำเข้าข้อมูลที่ตรงกัน การลบประเภทจะเป็นการลบหน้าเหล่านั้น ข้อมูลที่คุณนำเข้าแล้วสำหรับประเภทที่คุณเก็บไว้จะยังคงอยู่ที่เดิม

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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