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

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

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

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

ในระหว่างการนำเข้าครั้งแรก 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 →