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

การซิงค์ GitHub ที่ Notion จัดการให้จะนำงานที่คุณเลือกจาก 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

คุณสามารถซิงค์ GitHub Issue แยกต่างหากหรือซิงค์พร้อมกับ 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 จะสร้างฐานข้อมูลที่ซิงค์ไว้ในส่วน Private ของแถบด้านข้างของคุณและเริ่มนำเข้าบันทึกที่ตรงกัน

ระหว่างการนำเข้าครั้งแรก 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 ให้เปิดบันทึกโดยใช้ URL ของ GitHub และทำการเปลี่ยนแปลงใน GitHub

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

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

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

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

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

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

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