לחבר את GitHub ל-Notion

סנכרון מנוהל של GitHub מעביר ל-Notion את הפריטים שתבחרו: בקשות משיכה (pull requests), בעיות (issues) או את שניהם. Notion מייבאת את הרשומות הקיימות שלכם ובודקת ברקע אם יש עדכונים ב-GitHub.

המדריך הזה עוסק ב-סנכרון מאגר ידע בהגדרות החיבור שלכם ל-GitHub. מאפיינים מסונכרנים הם לקריאה בלבד. כדי לשנות בקשות משיכה ובעיות, יש לבצע את השינויים ב-GitHub.

אפשר לבחור מה להעביר ל-Notion מהמאגרים הזמינים דרך התקנה של GitHub App: בקשות משיכה, בעיות או את שניהם. המאגרים שנבחרו יסונכרנו עם Notion.

המאפיין מחבר (GitHub) מכיל את שם המשתמש ב-GitHub. מחבר הוא מאפיין אדם ב-Notion כאשר האימייל הציבורי הזמין של המחבר תואם לחבר בסביבת העבודה.

המאפיין תיאור מסנכרן את תיאור בקשת ה-Pull כטקסט פשוט, שמועתק בדיוק כפי שנכתב ב-GitHub. הוא אינו מוצג כ-Markdown.

אפשר לסנכרן בעיות מ-GitHub בנפרד או לצד בקשות משיכה. הסנכרון הזה לא כולל תגובות על בקשות משיכה או פרטי סקירה.

תצטרכו:

• חברות בסביבת העבודה של Notion.

• חשבון GitHub עם גישה למאגרים שברצונך לסנכרן.

• התקנת אפליקציית GitHub עם גישה למאגרים אלו.

• תוכנית Business (גם Mobile Business מתאימה). סנכרון GitHub אינו זמין בתוכניות אחרות.

גם חשבון ה-GitHub שלך וגם התקנת האפליקציה זקוקים לגישה. ייתכן שארגון ה-GitHub שלך ידרוש מבעלים לאשר או להתקין את האפליקציה.

1. ב-Notion, עבור אל Settings → Connections → GitHub.

2. יש לפתוח את Database sync ולחבר את חשבון ה-GitHub שלך אם עדיין לא נעשה זאת.

3. יש להשלים את שלבי האישור וההתקנה של GitHub.

4. יש לבחור את הארגון או החשבון שמאגריו ברצונך לסנכרן. במקרה שיש צורך בהוספת התקנה נוספת, יש להשתמש ב-Add organization….

5. יש לבחור את מאגרי הידע שייכללו.

6. נותנים שם לסנכרון ובוחרים מה להעביר ל-Notion: בקשות משיכה, בעיות או את שניהם.

7. יש לבחור את כל ההיסטוריה הזמינה או חלון היסטוריה.

8. בחרו ב-יצירת סנכרון.

Notion יוצרת את מאגר הידע המסונכרן במקטע 'פרטי' בסרגל הצד שלכם ומתחילה לייבא רשומות תואמות.

במהלך הייבוא הראשון, Notion קוראת בקשות משיכה ובעיות שבחרתם מכל מאגר שנבחר, החל מהרשומות שעודכנו לאחרונה ולאורך ההיסטוריה שנבחרה.

לאחר הייבוא, Notion בודקת באופן קבוע כל מאגר עבור רשומות חדשות ומעודכנות. שינויים כגון תווית חדשה, בקשת משיכה סגורה או בעיה שנפתחה מחדש יעדכנו את המאפיינים התואמים ב-Notion.

הסנכרון פועל גם כשסוגרים את Notion. מאגרים גדולים, מגבלות בקשות של GitHub ובעיות שירות זמניות עלולים לעכב עדכונים. יש לבדוק את סטטוס הסנכרון עבור התקדמות או שגיאות.

יש לבחור All history, Last 30 days, Last 90 days או Last 365 days. כאשר מוצע סנכרון כל ההיסטוריה כרשימה נפתחת, יש להשאיר את Sync all available history מופעל כדי לכלול את כל בקשות המשיכה הזמינות.

החלון משתמש בזמן Updated At של בקשת המשיכה. הוא לא תלוי מתי בקשת המשיכה נוצרה או אם היא פתוחה, סגורה או ממוזגת.

לדוגמה, בקשת משיכה או בעיה פתוחה שלא השתנתה במשך יותר מ-90 יום עשויה להימצא מחוץ לחלון של 90 יום.

יש לפתוח את הסנכרון ב-Settings → Connections → GitHub → Database sync.

• הוספה או הסרה של בעיות או בקשות משיכה: משנים את מה שהסנכרון מייבא ובוחרים באפשרות 'שמירת שינויים'. הוספת סוג מייבאת את הרשומות התואמות לו. הסרת סוג מסירה את הדפים שלו. הרשומות שכבר יובאו עבור הסוגים שנשארו נשארות במקומן.

• 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 →.