לחבר את GitHub ל-Notion

סנכרון מנוהל עם GitHub מעביר ל-Notion את הפריטים שתבחרו: בקשות משיכה, בעיות או שניהם. 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, יש לפתוח את הרשומה באמצעות GitHub URL ולבצע את השינוי ב-GitHub.

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

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

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

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

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

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

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