סנכרון נתונים מכלים אחרים ל-Notion

במסמך העזרה הזה

הבאת נתונים מכלים כמו GitHub, Jira ו-Salesforce למאגרי ידע ב-Notion שמתעדכנים באופן אוטומטי.


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

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

חיבור

נתונים שניתן לסנכרן למאגרי ידע

מאגרי ידע שנוצרו

GitHub

בקשות משיכה (Pull requests) ממאגרים נבחרים

בקשות משיכה

Jira

מרחבים ופריטי עבודה ממרחבי Jira Cloud נבחרים

מרחבי Jira ופריטי עבודה של Jira

Salesforce

חשבונות, אנשי קשר והזדמנויות

חשבונות, אנשי קשר ו/או הזדמנויות, בהתאם לבחירה

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

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

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

הערה: צריך לחבר כלי אחר? אם הכלי שברצונך לחבר אינו נתמך, השתמש ב-Notion Workers כדי לבנות סנכרון מותאם אישית, או עקוב אחר מדריכי ה-Workers המוכנים שלנו עבור Asana ו-GitLab.

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

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

סנכרון GitHub וסנכרון Jira דורשים תוכנית Business (או תוסף Mobile Business). סנכרון Salesforce דורש תוכנית Enterprise.

  1. פתחו את הגדרות → חיבורים בסביבת העבודה שלכם ב-Notion.

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

  3. חברו חשבון והשלימו את שלבי האימות עבור אותו כלי.

  4. בחרו את המאגרים, המרחבים או סוגי האובייקטים שברצונכם לסנכרן.

  5. בחרו כמה היסטוריה לכלול. עבור מקורות המציעים מאפיינים מותאמים אישית, כגון Jira ו-Salesforce, באפשרותכם גם לבחור אילו מאפיינים מותאמים אישית לכלול בסנכרון שלכם.

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

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

הייבוא הראשון

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

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

עדכונים שוטפים

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

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

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

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

טווחי היסטוריה

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

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

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

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

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

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

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

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

שינוי בהרשאות בכלי המקור עלול לעצור עדכונים עתידיים מבלי להסיר נתונים שכבר נמצאים ב-Notion. בדקו את הגדרות השיתוף של מאגר הידע ב-Notion כאשר הגישה למקור משתנה.

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

סטטוס

מה לעשות

אתחול או מילוי חוזר (Backfilling)

הסנכרון מוגדר או מייבא רשומות קיימות. אפשר לייבוא להמשיך.

תקין

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

מצב ירוד או נכשל

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

נדרשת פעולה

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

מושבת

הסנכרון מושהה. באפשרותך לבטל את ההשהיה בהגדרות הסנכרון.

לא זמין

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

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

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

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

מה דרוש לכם

סנכרון מאגר ידע מנוהל

Worker

הגדירו חיבור נתמך ללא קוד

בחרו חשבון, נתונים והגדרות ב-Notion.

דורשים קוד ופריסה.

בחרו את מבנה הנתונים

השתמשו ברשומות ובמאפיינים הנתמכים של החיבור.

הגדירו סכימה מותאמת אישית וטרנספורמציות.

התאימו אישית את אופן הבאת הנתונים

השתמשו בהתנהגות הסנכרון המובנית.

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

תחזוקת הסנכרון

Notion מתחזקת את לוגיקת החיבור המובנית.

הצוות שלכם מתחזק את קוד ה-Worker; Notion מריצה את ה-Worker.

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

רשומות חסרות

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

יחסים חסרים

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

העדכונים נעצרו

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

הסנכרון הגיע למגבלת שורות

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

עבור סנכרון קיים של Asana או GitLab, השתמש במדריכי ההחלפה של Worker:


מתן משוב

האם המשאב הזה היה שימושי?


Powered by Fruition