เชื่อมต่อ GitHub

ในเอกสารช่วยเหลือนี้

เชื่อมต่อ Notion กับ GitHub เพื่อให้เวิร์คโฟลว์ของคุณซิงค์กันได้ 🧮

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

ตั้งค่าการเชื่อมต่อ GitHub

Note: You can only connect one Notion workspace to a GitHub organization. If you’d like to connect a different Notion workspace to your GitHub organization, you’ll first have to disconnect your current Notion workspace.

คุณจะต้องเป็นทั้งเจ้าของพื้นที่ทำงาน Notion และผู้ดูแลองค์กร GitHub เพื่อเชื่อมต่อ Notion กับแอพพื้นที่ทำงาน GitHub

  1. ไปที่ Settings ในแถบด้านข้าง → Connections.

  2. ค้นหา GitHub (Workspace)

  3. คลิก Connect และดำเนินการตามขั้นตอนการยืนยันตัวตน

สร้างตัวอย่างโค้ด GitHub

ลิงค์ไปยังไฟล์หรือบรรทัดเฉพาะจากไฟล์โดยตรงใน Notion คุณยังสามารถลิงค์จากคอมมิตหรือสาขาเฉพาะได้หากต้องการให้โค้ดที่คุณอ้างอิงเป็นเวอร์ชันล่าสุด

  1. คัดลอก permalink สำหรับบรรทัดที่คุณต้องการจาก GitHub

  2. วางลงในหน้า Notion แล้วเลือก Paste as preview เพื่อฝังโค้ดลงในหน้าของคุณ

สร้างฐานข้อมูลที่ซิงค์กัน

คุณสามารถซิงค์ที่เก็บ GitHub ของคุณ (รวมถึง Pull Request และปัญหา) เข้ากับ Notion ในรูปแบบฐานข้อมูลได้ โดยทำดังนี้:

  1. ใน GitHub ให้คัดลอกลิงค์ไปยัง PR หรือปัญหา

  2. วางลิงค์ลงใน Notion แล้วเลือก Paste as database

    • หากคุณยังไม่ได้ดำเนินการ คุณจะได้รับแจ้งให้ลงชื่อเข้าใช้และเชื่อมต่อ Notion กับบัญชี GitHub ของคุณ

  3. ฐานข้อมูลที่ซิงค์จะถูกสร้างขึ้นใน table view โดยมีคุณสมบัติทั้งหมดของ GitHub เพิ่มเข้ามาโดยอัตโนมัติ

  4. ฐานข้อมูลจะเริ่มเติมข้อมูลโดยอัตโนมัติและจะซิงค์ต่อไปแม้ว่าคุณจะออกจากหน้านั้นไปแล้วก็ตาม

คุณสมบัติของ GitHub ที่รองรับ

นี่คือรายการคุณสมบัติของ GitHub ที่เรารองรับ:

ชื่อ

ผู้รับมอบหมาย

คำอธิบาย

รัฐ

หมายเลข PR หรือ Issue

ครีเอเตอร์

เวลาที่สร้าง

เวลาที่รวม อัปเดต และปิด

ผู้ตรวจสอบ

ขณะนี้ยังไม่รองรับป้ายกำกับและแท็ก

พร็อพเพอร์ตี้บุคคล

คุณสามารถใช้การจับคู่ตัวตนเพื่อเชื่อมต่อตัวตนบน GitHub เข้ากับโปรไฟล์ Notion ของทีมคุณได้ โดยทำดังนี้:

  1. ไปที่ GitHub email settings ของคุณ และตรวจสอบให้แน่ใจว่าการตั้งค่า Keep my email addresses privateไม่ได้ ถูกเลือกไว้

  2. ในโพรไฟล์ GitHub ของคุณ (https://github.com/{YOUR_USERNAME_HERE}) ให้แก้ไขโพรไฟล์ของคุณเพื่อเพิ่มที่อยู่อีเมล Notion ของคุณ

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

เชื่อมโยง GitHub PR เข้ากับ Notion

To link PRs from GitHub to a Notion, you'll need a prefixed unique ID property in your database.

Learn more about unique IDs here!

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

  1. ในฐานข้อมูล Notion ให้คลิก + เพื่อเพิ่มพร็อพเพอร์ตี้ใหม่

  2. ค้นหาและคลิก GitHub Pull Requests เพื่อเพิ่มพร็อพเพอร์ตี้นี้ลงในฐานข้อมูลของคุณ

    • หากคุณไม่เห็นรายการพร็อพเพอร์ตี้ GitHub Pull Requests ให้ไปที่ Settings → More Settings → Connections → เพิ่ม GitHub Pull Request

  3. ตรวจสอบให้แน่ใจว่าฐานข้อมูลของคุณมี พร็อพเพอร์ตี้ Unique ID พร็อพเพอร์ตี้นี้จะถูกเพิ่มลงในฐานข้อมูลของคุณหากยังไม่มี

  4. ในการใช้พร็อพเพอร์ตี้ GitHub Pull Request ตรวจสอบให้แน่ใจว่าคุณได้เชื่อมต่อบัญชี GitHub ของคุณกับ Notion แล้ว จากนั้นให้เพิ่ม Unique ID ของงานใน Notion ลงใน Pull Request หรือวาง URL ของ GitHub Pull Request ลงในพร็อพเพอร์ตี้ดังกล่าว

โดยค่าเริ่มต้น Notion จะเปิดใช้งานแบ็คลิงค์บนงานใน Notion ไปยัง GitHub หากคุณต้องการปิดการใช้งานนี้ ให้คลิกที่พร็อพเพอร์ตี้ GitHub Pull Request ในฐานข้อมูลของคุณ → Edit property แล้วปิดปุ่มเปิด/ปิด Linkbacks in GitHub

อัปเดตสถานะงานโดยอัตโนมัติ

คุณสามารถใช้พร็อพเพอร์ตี้ GitHub Pull Requests เพื่ออัปเดตสถานะงานของคุณใน Notion โดยอัตโนมัติได้

  1. เลือกชื่อพร็อพเพอร์ตี้ GitHub Pull Requests ของคุณ แล้วคลิก แก้ไขพร็อพเพอร์ตี้

  2. ค้นหาส่วน อัปเดตอัตโนมัติ และเลือกพร็อพเพอร์ตี้สถานะที่คุณต้องการอัปเดตจากเมนูแบบเลื่อนลง

  3. เลือกสถานะงานที่จะตั้งค่าเมื่อ GitHub PR ถูกเปิด, ขอการตรวจสอบ, อนุมัติ และรวมเข้าด้วยกัน

  4. ตอนนี้เมื่อ PR ดำเนินการใน GitHub สถานะงานของคุณใน Notion จะได้รับการอัปเดตโดยอัตโนมัติตามการตั้งค่าของคุณ

คุณยังสามารถแสดงกิจกรรม GitHub ในงาน Notion ที่เชื่อมโยงได้ โดยคลิกที่พร็อพเพอร์ตี้ GitHub ในฐานข้อมูลของคุณ → แก้ไขพร็อพเพอร์ตี้ เปิด ความคิดเห็นกิจกรรม

GitHub Auto-update status

ใช้คำวิเศษเพื่อเชื่อมโยง GitHub PR เข้ากับงานใน Notion

หากคุณต้องการเชื่อมโยง GitHub PR เข้ากับงานใน Notion หนึ่งงานขึ้นไป เพียงป้อนคำวิเศษและ Unique ID ของงานใน Notion ลงในคำอธิบาย PR ของคุณ

คำวิเศษคือคำสำคัญที่ช่วยสร้างความสัมพันธ์ระหว่างงานใน Notion และ GitHub PR คุณสามารถใช้คำใดก็ได้ต่อไปนี้:

  • close, closes, closed

  • fix, fixes, fixed

  • resolve, resolves, resolved

  • complete, completes, completed, completing

  • ref, references

  • part of

  • related to

  • contributes to

  • towards

ตัวอย่างเช่น PR ของคุณอาจมีคำอธิบายว่า “fixes CTT-13” เมื่อตั้งค่าคำอธิบายนั้นแล้ว งานใน Notion ของคุณที่มี ID CTT-13 จะถูกเชื่อมโยงกับ PR นั้น

หากคำอธิบาย PR ของคุณใช้คำวิเศษที่เกี่ยวข้องกับการปิดหรือทำภารกิจให้เสร็จสิ้น งานใน Notion จะถูกทำเครื่องหมายว่าเสร็จสิ้นเมื่อ PR ถูกรวมเข้าด้วยกัน

หากคำอธิบาย PR ของคุณใช้คำวิเศษที่เกี่ยวข้องกับการอ้างอิงหรือเกี่ยวข้องกับงาน งานใน Notion จะไม่ถูกทำเครื่องหมายว่าเสร็จสิ้นเมื่อ PR ถูกรวมเข้าด้วยกัน

คุณสามารถเชื่อมโยงงานใน Notion แบบอ้างอิงเท่านั้น เพื่อไม่ให้งานเหล่านั้นถูกทำเครื่องหมายว่าเสร็จสิ้น

ยกเลิกการเชื่อมต่อ GitHub จาก Notion

ในการยกเลิกการเชื่อมต่อ GitHub จาก Notion คุณจะต้องเป็นเจ้าของพื้นที่ทำงาน Notion

  1. ไปที่ การตั้งค่า.

  2. เลือก การเชื่อมต่อ.

  3. ถัดจาก GitHub ให้เลือก ••• → เลิกเชื่อมต่อผู้ใช้ทั้งหมด

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

ให้ข้อเสนอแนะ

แหล่งข้อมูลนี้มีประโยชน์หรือไม่?

Powered by Fruition