מאמר זה מתאר כיצד לפרוס את Directory Sync ב- Webex עבור Cisco BroadWorks. המאמר מיועד למנהלי ספקי שירות בארגונים שותפים.
סקירה כללית של סנכרון ספריות
סנכרון ספריות מבטיח שמשתמשי Webex עבור Cisco BroadWorks יכולים להשתמש בספריית Webex מאפליקציית Webex כדי להתקשר לכל ישות מתקשרת משרת BroadWorks. תכונה זו מסנכרנת מידע שיחות של BroadWorks שלא היה חלק מהקצאת משתמש לספריית Webex .
הקצאת משתמש של Webex עבור Cisco BroadWorks מעדכנת את ספריית Webex עם פרטי שיחות עבור משתמשי Webex עבור Cisco BroadWorks (מספר טלפון ראשי , מספר מספר טלפון נייד, שלוחה), אך משמיטה רשומות שיחות חיצוניות. עם זאת, כאשר סנכרון Directory מופעל, התכונה מסנכרנת גם את רשומות השיחות הבאות Webex .
משתמשים המתקשרים ל-BroadWorks בלבד (שאינם מחוברים ל- Webex)
ישויות שלא מתקשרות למשתמש (למשל, טלפון בחדר ישיבות, מכשיר פקס, מספר קבוצת גישוש )
ערכי רשימת טלפונים של BroadWorks
הטבלה הבאה מסכמת את רשומות השיחות של BroadWorks ומראה כיצד הם מתווספים לספריית Webex .
BroadWorks Calling Records |
תיאור |
נוסף ל- Webex Directory דרך... |
---|---|---|
Webex עבור משתמשי Cisco BroadWorks |
משתמשים מופעלים עבור Webex עבור Cisco BroadWorks |
הקצאת משתמש (למשל, הקצאה שוטפת) |
משתמשים המתקשרים ל-BroadWorks בלבד |
מתקשר למשתמשים שהם לא הועלה ל- Webex |
סנכרון ספריות |
ישויות מתקשרות שאינן משתמשות |
למשל, טלפון בחדר ישיבות, מכשיר פקס, מספר קבוצת האנט |
סנכרון ספריות |
רשימות טלפונים של BroadWorks |
רשומות ברשימת הטלפונים של BroadWorks:
|
סנכרון ספריות (סנכרון רשימת טלפונים) |
לפרטים נוספים על הקצאת משתמשים, ראה את Webex עבור Cisco BroadWorks מדריך פתרונות .
|
תנאי סנכרון ספריות
מנהלי שותפים חייבים להפעיל את התכונה ברמת השותף. מנהלי שותפים יכולים להפעיל או לכבות את התכונה עבור ארגוני לקוחות מרובים בפעולה אחת.
כברירת מחדל, הסנכרון הראשוני מתרחש שבוע לאחר הפעלת הסנכרון (הזמן שנבחר לתחילת הסנכרון הוא אקראי). עם זאת, ארגוני לקוחות יכולים להשתמש ב- סנכרן עכשיו אפשרות לעקוף את תקופת ההמתנה של שבוע ולהפעיל סנכרון מיידי עבור ארגון לקוח נתון.
כברירת מחדל, directory Sync פועל מדי שבוע עבור כל לקוח. כל סנכרון מתרחש שבוע לאחר הסנכרון האחרון, ללא קשר אם הסנכרון האחרון תוכנן או הופעל באופן ידני עם סנכרן עכשיו .
מספר מקסימלי של סנכרון בו-זמני לכל אשכול BroadWorks הוא שניים: סנכרון אחד מתוזמן וסנכרון אחד לפי דרישה (באמצעות API או Partner Hub GUI). עם זאת, מנהלי מערכת לא יכולים להפעיל שני סנכרון לפי דרישה בו-זמנית מאותו BroadWorks. הגבלה זו קיימת ללא קשר אם הסנכרון הופעל דרך ה- API או דרך ה- סנכרן עכשיו אפשרות ב-Partner Hub. בנוסף, Webex לא יתזמן שני סנכרונים מתוזמנים לרוץ בו-זמנית מאותו BroadWorks.
אם מתרחש כשל בסנכרון, Webex מנסה מחדש את הסנכרון אוטומטית כל 24 שעות עד לסנכרון המתוזמן הבא.
הסנכרון מתעלם ממשתמשים שאין להם מספר טלפון.
ב-Partner Hub, אתה יכול להציג מידע על סטטוס סנכרון עבור לקוח נתון. בנוסף, ניתן לייצא מידע מפורט על הסנכרון האחרון לרשומת CSV . רשומת CSV מספקת יותר פרטים מאשר תצוגת Control Hub ויכולה לסייע בפתרון בעיות, ניתוח וביקורת.
Webex מאחסנת אנשי קשר של משתמשים בפורמט מוצפן. רק למשתמש שבבעלותו איש הקשר יש גישה למפתח הפענוח.
עבור משתמשי BroadWorks המתקשרים בלבד וישויות מתקשרות שאינן משתמשות, תכונה זו מסנכרנת את סוגי מספרי מספר טלפון הבאים מ-BroadWorks:
מספר טלפון ראשי
מספר טלפון נייד
שלוחה
עם זאת, הסנכרון מוציא מהסנכרון משתמשים המתקשרים ל-BroadWorks בלבד וישויות מתקשרות שאינן משתמשות, אם אין מספר טלפון ראשי .
רשימת טלפונים של BroadWorks ומקסימום אנשי קשר
סנכרון ספריות מסנכרן גם רשומות ברשימת הטלפונים של BroadWorks ל- Webex Contacts. ערכים מסונכרנים מתווספים לאחד מסוגי אנשי הקשר הבאים:
אנשי קשר בארגון - Webex מאחסן את אנשי הקשר הללו מול ארגון. כל משתמש יכול לגשת לאנשי הקשר של הארגון עבור הארגון שלו. המקסימום הוא עד 30000 אנשי קשר.
אנשי קשר למשתמש - Webex מאחסן את אנשי הקשר הללו מול משתמש. רק המשתמש שבבעלותו איש הקשר יכול לגשת לרשומת איש הקשר. המקסימום הוא עד 2000 אנשי קשר (1500 אנשי קשר מסונכרנים + 500 אנשי קשר לכניסה ידנית).
רק ערכי רשימת טלפונים מתווספים לאנשי קשר של Webex . משתמשים מתקשרים ל-BroadWorks בלבד וישויות מתקשרות שאינן משתמשות הנכללות בסנכרון Directory לא יתווספו לאנשי קשר אלא אם משתמש Webex יוסיף אותם לאנשי קשר באופן ידני.
|
הטבלה הבאה ממפה סוגי אנשי קשר של Webex מול מקור אנשי הקשר (מסונכרן מרשימת טלפונים של BroadWorks או הוספה ידנית):
סוג איש קשר של Webex |
צור קשר עם מקור |
מקסימום |
מסונכרן מ-BroadWorks... |
API משמש לסנכרון |
---|---|---|---|---|
אנשי קשר בארגון |
סנכרון ספריות |
30000 אנשי קשר |
רשימות טלפונים נפוצות של Enterprise |
|
קבץ רשימות טלפון נפוצות (עבור קבוצת ספק שירות)** |
|
|||
אנשי קשר של משתמשים |
סנכרון ספריות |
1500 אנשי קשר |
רשימות טלפונים אישיות |
/directories/personal |
נוסף ידנית על ידי המשתמש |
500 אנשי קשר |
לא רלוונטי |
לא רלוונטי |
|
אנשי קשר בקבוצה |
סנכרון ספריות |
30000 אנשי קשר לקבוצה |
קבץ רשימות טלפונים נפוצות (עבור קבוצה ארגונית)** |
/directories/groupcommon |
**ערכי רשימות טלפון נפוצות קבוצתיות מסתנכרנות באופן שונה, תלוי אם BroadWorks נמצא במצב Enterprise או במצב ספק שירות. הערך של ה
|
התנאים הבאים חלים על האופן שבו Directory Sync מטפל במקסימום אנשי קשר:
אם ארגון חורג ממספר אנשי הקשר המרבי המותר לסנכרון (30,000 אנשי קשר בארגון או 30,000 אנשי קשר נפוצים לקבוצה בכל קבוצה), סנכרון ספריות לא כולל ערכים מעל הסף המרבי. לא הוחל סדר מסוים על אנשי קשר מסונכרנים או שהושמטו.
אם אחד מהלקוחות שלך חורג מהמספר המרבי המותר של אנשי קשר בכל אחת מהקטגוריות, אנו ממליצים להגיש תביעה מול Cisco כדי שהארגון לא ייכלל מסנכרון ספריות.
אנשי קשר ידניים הם אנשי קשר שמשתמש מוסיף באופן ידני באפליקציית Webex . משתמש יכול להוסיף עד 500 אנשי קשר ידניים. אנשי קשר ידניים נכנסים לקטגוריית אנשי הקשר הגדולה יותר של משתמש ב- Webex, אך אינם כלולים בסנכרון.
המגבלה הכוללת הכוללת עבור אנשי קשר בארגון (30000) ואנשי קשר קבוצתי (30000 לקבוצה) היא 200000.
עדכונים
להלן כיצד ספריית Webex מטפלת בעדכונים:
אם שם איש קשר משתנה ב-BroadWorks, איש הקשר הקיים יימחק מספריית ה- Webex ויוצר איש קשר חדש.
אם מספר איש הקשר משתנה ב-BroadWorks, Webex מעדכנת את איש הקשר הקיים בספריית Webex עם המספר החדש.
לאחר שמנהל מערכת מעדכן איש קשר ב-BroadWorks, התנאים הבאים מתארים מתי העדכון מוצג באפליקציית Webex של משתמש:
אם העדכון מיועד למשתמש המתקשר ל-BroadWorks בלבד או לישות מתקשרת שאינה משתמשת, העדכון מוצג באפליקציית Webex של משתמש מיד לאחר סנכרון הספרייה הבא.
אם העדכון הוא לערך ברשימת טלפונים של BroadWorks:
לאנשי קשר של משתמשים - עדכונים מוצגים באפליקציית Webex של המשתמש מיד לאחר סנכרון הספרייה הבא.
לאנשי קשר קבוצתיים - עדכונים מוצגים באפליקציית Webex של המשתמשים מיד לאחר סנכרון הספרייה הבא.
לאנשי קשר בארגון - ספריית ה- Webex מתעדכנת בסנכרון הספריות הבא, אך המשתמשים לא יראו את השינוי באפליקציית Webex עד שיפעילו מחדש את אפליקציית Webex או עד שיפוג טיימר המטמון המקומי של 72 שעות.
עדכונים ל- Webex עבור פרטי משתמש של Cisco BroadWorks מטופלים כחלק מתהליכי הקצאה.
|
Control Hub מכיל אפשרות להוסיף או לערוך אנשי קשר ברמת הארגון ב-Control Hub באמצעות קובץ CSV. מנהלי שותפים ומנהלי לקוחות עם גישת Control Hub יכולים לגשת לאפשרות זו. עם זאת, עדכון אנשי קשר באמצעות Control Hub אינו נתמך על ידי Webex עבור Cisco BroadWorks. עדכוני אנשי קשר שהוחלו ב-Control Hub אינם מסתנכרנים בחזרה ל-BroadWorks ואינם זמינים לחיפושי ספריות מטלפונים שולחניים.
|
תנאים מוקדמים לסנכרון ספריות
אנו ממליצים להשתמש בהגדרות הבאות:
הדוגמאות שלהלן מניחות שאתה משתמש בשרת XSP. עבור שרתי ADP, החלף (XSP_ CLI) עם (ADP_ CLI).
|
ערכים מגבילי קצב—הגדר את מאפייני מערכת OverloadControl הבאים (XSP_ CLI/Applications/Xsi-Actions/OverloadControl):
userDirectoryTransactionLimit—הגדר לערך null.
globalDirectoryTransactionLimit - הגדר לערך null.
מומלץ להגדיר את userDirectoryTransactionLimit ואת globalDirectoryTransactionLimit לערך null. עם זאת, אם תחליט להקצות ערכים, כל אחד מהם חייב להיות מוגדר לפי חמישה לפחות מהערך של transactionLimitPeriodSeconds (שצריך להיות 1).מגבלות עסקאות—הגדר את הערכים הבאים (XSP_ CLI/System/CommunicationUtility/DefaultSettings):
userTransactionLimit—הגדר ל-100 לפחות.
transactionLimitPeriodSecs—הגדר ל-1.
ערכי החלפה—הגדר את מאפייני מערכת ההחלפה (XSP_ CLI/אפליקציות/Xsi-Actions/Paging):
defaultPageSize—הגדר ל-50
availableUserMaxLimit - מוגדר ל-100
ממשק CTI - הקפד להעלות את אישורי Webex CA לחנות האמון של ממשק CTI וכדי לאפשר אימות לקוח בממשק CTI .
בנוסף, בהתאם למהדורת BroadWorks שלך, אנו ממליצים להחיל את תיקוני המערכת הבאים לפריסת BroadWorks לפני שתפעיל תכונה זו:
עבור R22:
AP.as.22.0.1123.ap368517
עבור R23:
AP.as.23.0.1075.ap368517
עבור R24: לא נדרש תיקון
אפשר סנכרון ספריות (תבנית חדשה)
מנהלי שותפים יכולים להפעיל את Directory Sync עבור תבנית לקוח בזמן יצירת התבנית החדשה. כל ארגוני לקוחות חדשים שיוקצו לתבנית זו יפעילו סנכרון ספריות. לפרטים, ראה "הגדר את תבניות הלקוח שלך" ב הגדר את ארגון השותף שלך ב-Partner Hub בתוך ה מדריך פתרונות עבור Webex עבור Cisco BroadWorks .
מה לעשות הלאה
ודא שהמשתמשים שלך יודעים שהם חייבים ללחוץ על אנשי קשר לשונית באפליקציית Webex לפחות פעם אחת כדי להפעיל את התכונה באפליקציית Webex . זה צריך להסתיים פעם אחת בלבד.
אפשר סנכרון ספריות (תבנית קיימת)
1 | היכנס אל Partner Hub ובחר הגדרות . |
||
2 | גלול אל שיחות BroadWorks ולחץ הצג תבניות . |
||
3 | בחר את תבנית הלקוח המתאימה וגלול אל BroadWorks Directory Sync . |
||
4 | כדי לאפשר סנכרון ספריות כברירת מחדל עבור ארגוני לקוחות חדשים המשתמשים בתבנית זו:
|
||
5 | כדי לאפשר סנכרון ספריות עבור ארגוני לקוחות קיימים המשתמשים בתבנית זו:
|
מה הלאה?
ודא שהמשתמשים שלך יודעים שהם חייבים ללחוץ על אנשי קשר לשונית באפליקציית Webex לפחות פעם אחת כדי להפעיל את התכונה באפליקציית Webex . זה צריך להסתיים פעם אחת בלבד.
הפעל סנכרון מיידי
1 | היכנס למרכז השותפים (http://admin.webex.com ) ובחר הגדרות . |
2 | גלול אל שיחות BroadWorks ולחץ הצג תבניות . |
3 | בחר את תבנית הלקוח המתאימה וגלול אל BroadWorks Directory Sync . |
4 | לחץ הצג רשימה של סטטוס סנכרון לקוחות . |
5 | עבור ארגון הלקוחות שברצונך לסנכרן, לחץ על שלוש הנקודות בקצה השמאלי ובחר סנכרן עכשיו . |
6 | לחץ רענן כדי לראות את תוצאות הסנכרון. |
ייצא רשומות סנכרון ל- CSV
1 | היכנס למרכז השותפים (http://admin.webex.com ) ובחר הגדרות . |
2 | גלול אל שיחות BroadWorks ולחץ הצג תבניות . |
3 | בחר את תבנית הלקוח המתאימה וגלול אל BroadWorks Directory Sync . |
4 | לחץ הצג רשימה של סטטוס סנכרון לקוחות . |
5 | סמן את תיבות הסימון הסמוכות עבור כל ארגון שברצונך לכלול בייצוא. |
6 | לחץ ייצוא תוצאות . |
ממשקי API ציבוריים עבור Directory Sync
ממשקי API ציבוריים זמינים ב developer.webex.com המאפשרים למנהלי שותפים לעדכן את הגדרות Directory Sync עבור ארגוני הלקוחות שהם מנהלים, להפעיל סנכרון מיידי או לקבל מידע על סטטוס הסנכרון. שיטות סנכרון הספריות מקובצות תחת BroadWorks Enterprises :
רשימת חברות BroadWorks - השתמש בשיטת API זו כדי לקבל רשימה של ארגונים תחת ספק שירות נתון ושל כל ארגון
id
. עליך להזין אתspEnterpriseId
כפי שהוקצה בהקצאה.עדכון Directory Sync עבור BroadWorks Enterprise -היכנס למפעל
id
כדי לעדכן את סטטוס מדריך הכתובות עבור אותו ארגון, הפעלה או השבתה של סינכרון ספריות.הפעל סנכרון ספריות עבור ארגון - השתמש בשיטת API זו אם אתה רוצה להפעיל סנכרון מיידי עבור ארגון נתון
id
. עבור הsyncStatus
, הזן אתSYNC_NOW
פקודה.קבל סטטוס סנכרון ספריות עבור ארגון -היכנס למפעל
id
ולרוץ על מנת לקבל סטטוס וtrackingId
של הסנכרון האחרון. אתה יכול להשתמש בtrackingID
להפעיל ניתוחים נוספים באמצעות כלים כגון Kibana ו-Grafana.
בנוסף, מנהלי מערכת יכולים להשתמש ב- הפעל סנכרון ספריות עבור משתמש יחיד API להפעלת סנכרון ספריות לפי דרישה עבור משתמש בודד.
לתיעוד API מפורט, ראהhttps://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide .
עליך להיכנס כדי לקרוא את מפרט API בכתובתhttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
סנכרן ארגונים מרובים עם API
|
1 | הפעל את רשימת חברות BroadWorks API ליצירת רשימה של ארגונים שברצונך לסנכרן.
|
2 | הפעל את הפעל סנכרון ספריות עבור ארגון API בארגון הראשון ברשימה. |
3 | המתן מספר שניות ולאחר מכן הפעל את קבל סטטוס סנכרון ספריות API כדי לקבל סטטוס סנכרון.
|
4 | לאחר סיום הסנכרון, השלם את שלבים 2 עד 4 בארגון הבא ברשימה. חזור על שלבים אלה עד שתסנכרן את כל הרשימה. |
קודי שגיאה עבור סנכרון ספריות
קודי השגיאה הבאים חלים על Directory Sync.
קוד שגיאה |
הודעת שגיאה |
---|---|
600000 |
שגיאה לא צפויה בסנכרון של משתמשי ספר טלפונים חיצוני של Broadworks. |
600001 |
הסנכרון של משתמשי ספר טלפונים חיצוני של Broadworks נכשל. |
600002 |
היה צורך לסיים את הסנכרון של משתמשי ספר טלפונים חיצוני של Broadworks לפני שהוא הושלם. |
600003 |
הסנכרון של משתמשי ספר טלפונים חיצוני של Broadworks הצליח חלקית בלבד. הסנכרון של כמה ארגוני לקוח נכשל. |
600004 |
הסנכרון של משתמשי ספר טלפונים חיצוני של Broadworks לא מופעל עבור ConfigSet. |
600005 |
הסנכרון של משתמשי ספר טלפונים חיצוני של Broadworks מתבצע עבור ConfigSet. |
600006 |
הליכי המשנה של הסנכרון של משתמשי ספר טלפונים חיצוני של Broadworks עמוסים או שהם נסגרים, ולכן לא יקבלו עוד בקשות סנכרון. נסה שוב מאוחר יותר. |
600007 |
ארגון הזהויות של CustomerConfig לא נמצא. |
600008 |
CustomerConfig לא נמצא בארגון השותף. |
600009 |
Broadworks External Directory User Sync לא ניתן להפעיל מכיוון שאשכול Broadworks המשויך ל-CustomerConfig תפוס |
600010 |
לא ניתן לבצע את הסנכרון של משתמשי ספר טלפונים חיצוני של Broadworks משום שאין אשכול BroadWorks משויך ל-CustomerConfig. |
600011 |
הסנכרון של משתמשי ספר טלפונים חיצוני של Broadworks לא מופעל עבור CustomerConfig. |
600012 |
לא ניתן לבצע את הסנכרון של משתמשי ספר טלפונים חיצוני של Broadworks משום שסנכרון ספר טלפונים היברידי כבר הופעל עבור CustomerConfig. |
600013 |
הסנכרון של משתמשי ספר טלפונים חיצוני של Broadworks נכשל בהוספת משתמשים וחשבונות מכונה למאגר הזהויות. |
600014 |
הסנכרון של משתמשי ספר טלפונים חיצוני של Broadworks נכשל בניסיון להתחבר לאשכול BroadWorks. שגיאה מ-Broadworks - %s. |
600015 |
הסנכרון של משתמשי ספר טלפונים חיצוני של Broadworks לא מצא משתמש תואם במאגר הזהויות. |
600017 |
BroadWorks Phone List Sync לא הצליח לסנכרן את כל אנשי הקשר של המשתמש ושל הארגון/הארגון. |
600018 |
סנכרון רשימת הטלפונים של BroadWorks נכשל עבור משתמשים בארגון/ארגון. |
600019 |
סנכרון רשימת הטלפונים של BroadWorks נכשל בסנכרון אנשי הקשר של ארגון/ארגון. |
600020 |
BroadWorks External Directory User Sync לא ניתן להשבית מכיוון שסנכרון CustomerConfig מתבצע. |
600022 |
סינכרון משתמש יחיד של BroadWorks External Directory אינו אפשרי מכיוון שלארגון אין משתמש שהוקצה לו. |
600023 |
סינכרון משתמש יחיד של BroadWorks External Directory אינו אפשרי מכיוון שהמשתמש כבר קיים בארגון זה. |
600024 |
סינכרון משתמש יחיד של BroadWorks External Directory אינו אפשרי מכיוון שלא נמצא משתמש תואם ב-BroadWorks. |
600025 |
BroadWorks External Directory User Sync לא הצליח לעדכן את חשבון משתמש ב-CI. |
600026 |
BroadWorks External Directory User Sync לא הצליח לעדכן את חשבון המכונה ב-CI. |
600027 |
BroadWorks External Directory Single User Sync אינו אפשרי מכיוון שנמצאו משתמשים מרובים ב-BroadWorks. |
600028 |
BroadWorks External Directory Single User Sync אינו אפשרי מכיוון שהיה צריך להשלים לפחות סנכרון ספר טלפונים ארגוני אחת. |
600029 |
סנכרון משתמשי מדריך הכתובות החיצוני של BroadWorks נכשל מכיוון שלארגון אין משתמש שהוקצה לו. |
היסטוריה של שינוי
הטבלה הבאה מסכמת עדכונים למאמר זה.
תאריך |
מהדורה |
---|---|
14 בפברואר 2023 |
עודכן מקסימום ומקור סנכרון ספריות סעיף. |
10 בדצמבר 2022 |
עדכן את המונח סנכרון מיידי מלא ל הפעל סנכרון ספריות |
19 ביולי 2022 |
הבהרות ותיקונים למידע כללי:
|
9 במאי 2022 |
|
7 באפריל, 2022 |
|
28 במרץ 2022 |
|
24 במרץ 2022 |
נוספה רשימה של סוגי מספרי מספר טלפון מסונכרנים ל תנאי סנכרון ספריות . הסנכרון כולל כעת מספרי טלפון נייד . |
16 במרץ 2022 |
|
17 בדצמבר 2021 |
|
16 בדצמבר 2021 |
|
8 בדצמבר 2021 |
|