לחבר את GitHub ל-Notion
להשאיר בקשות Pull לצד תוכניות הפרויקט של הצוות שלך ב-Notion.
סנכרון מנוהל של GitHub מעביר ל-Notion את מה שנבחר מתוך העבודה ב-GitHub: בקשות משיכה, בעיות או שניהם. Notion מייבאת את הרשומות הקיימות ובודקת ברקע אם יש עדכונים ב-GitHub.
המדריך עוסק ב-סנכרון מאגר ידע בהגדרות החיבור ל-GitHub. מאפיינים מסונכרנים הם לקריאה בלבד. כדי לשנות בקשות משיכה ובעיות, יש לבצע את השינויים ב-GitHub.
הערה: אינטגרציית GitHub זו מחליפה את הגרסה הישנה שלנו. כדי לשמור על הנתונים החיצוניים שלך מעודכנים, יש להגדיר את הסנכרונים החדשים שלך עד ה-30 באוקטובר 2026. מאגרי הידע המסונכרנים הקיימים שלך יישארו ב-Notion, אך הם יפסיקו להתעדכן לאחר תאריך זה.
כשמגדירים סנכרון מאגר ידע, Notion יוצרת עבורו דף חדש באזור Private. הדף לא מחליף את הסנכרון הישן, כך ששניהם נשארים במקומם בזמן שמעבירים את העבודה לסנכרון החדש.
טיפ: אפשר לתת ל-Notion AI להעביר את ההגדרות עבורכם. למשל, אפשר לנסות את ההנחיה הזאת: "בדוק את המסננים במאגר הידע הישן שלי ב-GitHub (@mention את הסנכרון הישן שלי) והגדר את אותם מסננים במאגר הידע החדש שלי ב-GitHub (@mention את סנכרון מאגר הידע החדש שלי)."
בוחרים מה להעביר ל-Notion מתוך המאגרים הזמינים דרך התקנה של GitHub App: בקשות משיכה, בעיות או שניהם. המאגרים שנבחרו יסונכרנו עם Notion.
מידע | מאפיינים |
|---|---|
בקשת Pull | כותרת, מספר PR, כתובת URL של GitHub, מאגר |
מדינה | מצב: פתוח, טיוטה, אוחד, או סגור |
מחבר/ת | מחבר (GitHub), ומחבר כאשר ניתן למצוא חבר Notion תואם |
ארגון | תוויות, ענף בסיס, ענף ראש |
תאריכים | נוצר ב-, עודכן ב-, נסגר ב-, אוחד ב- |
המאפיין מחבר (GitHub) מכיל את שם המשתמש ב-GitHub. מחבר הוא מאפיין אדם ב-Notion כאשר האימייל הציבורי הזמין של המחבר תואם לחבר בסביבת העבודה.
המאפיין תיאור מסנכרן את תיאור בקשת ה-Pull כטקסט פשוט, שמועתק בדיוק כפי שנכתב ב-GitHub. הוא אינו מוצג כ-Markdown.
אפשר לסנכרן בעיות מ-GitHub בנפרד או לצד בקשות משיכה. הסנכרון הזה לא כולל תגובות על בקשות משיכה או פרטי סקירה.
תצטרכו:
חברות בסביבת העבודה של Notion.
חשבון GitHub עם גישה למאגרים שברצונך לסנכרן.
התקנת אפליקציית GitHub עם גישה למאגרים אלו.
תוכנית Business (גם Mobile Business מתאימה). סנכרון GitHub אינו זמין בתוכניות אחרות.
גם חשבון ה-GitHub שלך וגם התקנת האפליקציה זקוקים לגישה. ייתכן שארגון ה-GitHub שלך ידרוש מבעלים לאשר או להתקין את האפליקציה.
ב-Notion, עבור אל Settings → Connections → GitHub.
יש לפתוח את Database sync ולחבר את חשבון ה-GitHub שלך אם עדיין לא נעשה זאת.
יש להשלים את שלבי האישור וההתקנה של GitHub.
יש לבחור את הארגון או החשבון שמאגריו ברצונך לסנכרן. במקרה שיש צורך בהוספת התקנה נוספת, יש להשתמש ב-Add organization….
יש לבחור את מאגרי הידע שייכללו.
מתן שם לסנכרון ובחירה מה להעביר ל-Notion: בקשות משיכה, בעיות או שניהם.
יש לבחור את כל ההיסטוריה הזמינה או חלון היסטוריה.
בחרו ב-יצירת סנכרון.
Notion יוצרת את מאגר הידע המסונכרן באזור Private שבסרגל הצד ומתחילה לייבא רשומות תואמות.
טיפ: מאגר חסר? יש להשתמש ב-Manage access ב-GitHub כדי לבדוק לאילו מאגרים האפליקציה יכולה לגשת. אם ההתקנה דורשת אישור, יש לבקש מבעל ארגון GitHub לאשר אותה.
במהלך הייבוא הראשון, Notion קוראת בקשות משיכה ובעיות שבחרת מכל מאגר נבחר, החל מהרשומות שעודכנו לאחרונה ובהמשך לאורך ההיסטוריה שנבחרה.
לאחר הייבוא, Notion בודקת באופן קבוע כל מאגר עבור רשומות חדשות ומעודכנות. שינויים כגון תווית חדשה, בקשת משיכה סגורה או בעיה שנפתחה מחדש יעדכנו את המאפיינים התואמים ב-Notion.
הסנכרון פועל גם כשסוגרים את Notion. מאגרים גדולים, מגבלות בקשות של GitHub ובעיות שירות זמניות עלולים לעכב עדכונים. יש לבדוק את סטטוס הסנכרון עבור התקדמות או שגיאות.
יש לבחור All history, Last 30 days, Last 90 days או Last 365 days. כאשר מוצע סנכרון כל ההיסטוריה כרשימה נפתחת, יש להשאיר את Sync all available history מופעל כדי לכלול את כל בקשות המשיכה הזמינות.
החלון משתמש בזמן Updated At של בקשת המשיכה. הוא לא תלוי מתי בקשת המשיכה נוצרה או אם היא פתוחה, סגורה או ממוזגת.
לדוגמה, בקשת משיכה או בעיה פתוחה שלא השתנתה במשך יותר מ-90 יום עשויה להימצא מחוץ לחלון של 90 יום.
טיפ: ניתן להסיר דפים ישנים. כאשר בקשת משיכה או בעיה חורגת מהחלון שנבחר, הדף שלה מוסר ממאגר הידע המסונכרן, כולל ערכים במאפייני ה-Notion שלך. יש להשתמש בכל ההיסטוריה הזמינה אם נדרש לשמור בקשות משיכה ללא שינוי.
יש לפתוח את הסנכרון ב-Settings → Connections → GitHub → Database sync.
הוספה או הסרה של בעיות או בקשות משיכה: משנים את סוגי הרשומות שהסנכרון מעביר, ואז נבחרת האפשרות 'Save changes'. הוספת סוג מייבאת את הרשומות התואמות לו. הסרת סוג מסירה את הדפים האלה. הרשומות שכבר יובאו מהסוגים שנשארו לא משתנות.
Add repositories: יש לערוך את הבחירה ולבחור ב-Save changes. Notion מייבאת בקשות משיכה תואמות ממאגרי הידע שנוספו.
Remove repositories: יש לבטל את בחירתם ולשמור. דפי בקשות המשיכה המסונכרנים שלהם יוסרו מ-Notion.
היסטוריית שינויים: חלון ארוך יותר מייבא רשומות נוספות. חלון קצר יותר מסיר רשומות מחוץ לחלון החדש.
Pause updates: יש לבחור ב-השהיה סנכרון. הנתונים וההגדרות הקיימים נשארים.
Resume updates: יש לבחור ב-חדש סנכרון כדי להמשיך בסנכרון.
לפני הסרת מאגרים או קיצור היסטוריה, יש לשמור כל מידע שקיים ב-Notion בלבד שאתה צריך מהדפים המושפעים.
יוצרים תצוגות לפי מאגר, מצב, יוצר או תווית. מוסיפים מאפיינים משלכם כדי לעקוב אחר המוכנות להפצה או לשלב בקשות משיכה ובעיות בתהליך התכנון של הצוות. הערכים במאפיינים שהוספתם נשארים ב-Notion.
כדי לשנות מאפיין GitHub, יש לפתוח את הרשומה באמצעות כתובת URL של GitHub ולבצע את השינוי ב-GitHub.
מסד הנתונים מתחיל כפרטי. אם תשתף אותו, הגדרות השיתוף של Notion יקבעו מי יכול לראות את הנתונים המיובאים. צופים לא צריכים לקבל גישה למאגר המקור, ולכן יש לעיין בהרשאות מסד הנתונים לפני שיתוף מידע על מאגר פרטי.
יש לבדוק שהחשבון של GitHub והתקנת האפליקציה הנכונים נבחרו. יש לוודא שלחשבון שלך וגם לאפליקציה יש גישה למאגר. אם ארגון מגביל התקנות אפליקציות, יש לבקש מבעלים לאשר גישה.
יש לפתוח את הגדרות המאגר של הסנכרון, לעיין בבחירת המאגר ולשמור אותו שוב. אם הוא הועבר לארגון אחר, יש לוודא שלחיבור יש גישה במיקום החדש.
לשם משתמש ב-GitHub לא תמיד יש אימייל ציבורי זמין שתואם לחבר בסביבת העבודה ב-Notion. יש להשתמש ב-מחבר (GitHub) כדי לזהות את המחבר כאשר מאפיין האדם ריק. שינויים באימייל של המחבר או בחברות בסביבת העבודה עשויים שלא לרענן אוטומטית בקשות משיכה מסונכרנות ישנות.
יש לוודא שסוג הרשומה כלול בסנכרון, שהמאגר שלה נבחר, שהעדכון האחרון שלה נמצא בטווח ההיסטוריה שנבחר ושאף מסנן בתצוגה ב-Notion לא מסתיר אותה. ייתכן שהייבוא הראשון עדיין בהרצה.
יש לפתוח את פרטי הסטטוס של הסנכרון. יש לחבר מחדש את חשבון ה-GitHub שלך או לשחזר את הגישה למאגר אם תתבקש. מגבלות בקשות של GitHub והפסקות זמניות עלולות לעכב עדכונים בזמן ש-Notion מנסה שוב.
להשוואה עם Workers והנחיות לפתרון בעיות משותפות, יש לראות את סנכרון נתונים מכלי עבודה אחרים ל-Notion →.
