מחבר Microsoft Exchange

מחבר Microsoft Exchange מאפשר לבצע פעולות של הוספה, מחיקה, עדכון וקריאה בטבלאות בסכימה של Exchange Web Services ‏ (EWS) ושל Microsoft Graph.

גרסאות נתמכות

המחבר הזה תומך ב-Exchange Online.

לפני שמתחילים

לפני שמשתמשים במחבר Microsoft Exchange, צריך לבצע את המשימות הבאות:

  • בפרויקט שלכם ב-Google Cloud:
    • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
    • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
    • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

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

    • מפעילים את השירותים הבאים:
      • ‫secretmanager.googleapis.com (Secret Manager API)
      • ‫connectors.googleapis.com (Connectors API)

      במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

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

הגדרת המחבר

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

  1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

    כניסה לדף Connections

  2. לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
  3. בקטע מיקום, בוחרים את המיקום של החיבור.
    1. אזור: בוחרים מיקום מהרשימה הנפתחת.

      רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.

    2. לוחצים על הבא.
  4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
    1. מחבר: בוחרים באפשרות Microsoft Exchange מהרשימה הנפתחת של המחברים הזמינים.
    2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
    3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

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

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
    4. אופציונלי: מזינים תיאור למופע החיבור.
    5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
    6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
    7. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

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

    8. דייר ב-Azure: הדייר ב-Microsoft Online שממנו מתבצעת הגישה לנתונים. אם לא מציינים דייר, המערכת משתמשת בדייר שמוגדר כברירת מחדל.
    9. סכימה: בוחרים בסכימת EWS או MSGraph. סכימת ברירת המחדל היא EWS.
    10. אפשר גם להשבית את הסינון בצד השרת על ידי בחירה באפשרות השבתת הסינון בצד השרת.
    11. לוחצים על הבא.
  5. בקטע יעדים, בוחרים את סוג היעד ככתובת המארח ומציינים את הכתובת של שרת Exchange שאליו המחבר מתחבר, כמו https://outlook.office365.com/EWS/Exchange.asmx.
  6. לוחצים על הבא.
  7. בקטע אימות, מזינים את פרטי האימות. כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

  8. לוחצים על הבא.
  9. בדיקה: בודקים את פרטי החיבור והאימות.
  10. לוחצים על יצירה.

הגדרת אימות

מזינים את הפרטים בהתאם לאימות באמצעות שם משתמש וסיסמה

  • שם משתמש: שם המשתמש של המחבר.
  • סיסמה: סוד ב-Secret Manager שמכיל את הסיסמה שמשויכת למחבר.

מזינים את הפרטים על סמך אימות קוד ההרשאה של OAuth 2.0

  • Client ID: מזהה הלקוח שמשמש לבקשת אסימוני גישה.
  • היקף: רשימה מופרדת בפסיקים של ההיקפים הרצויים.
  • סוד לקוח: סוד הלקוח שמשמש לבקשת טוקנים של גישה.
  • כתובת URL לאישור: כתובת ה-URL לאישור שנוצרת כשיוצרים לקוח OAuth. מזינים את כתובת ה-URL בפורמט הבא: https://login.microsoftonline.com/TENANT_IDENTIFIER;/oauth2/v2.0/authorize?prompt=consent. לדוגמה, https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize?prompt=consent.

שלבים נוספים אחרי יצירת החיבור

אם בחרתם באפשרות OAuth 2.0 - Authorization code לאימות, אתם צריכים לבצע את השלבים הנוספים הבאים אחרי יצירת החיבור:

  1. בדף החיבורים, מאתרים את החיבור החדש.

    שימו לב שהסטטוס של המחבר החדש יהיה נדרשת הרשאה.

  2. לוחצים על דרושה הרשאה.

    יוצג לוח עריכת הרשאה.

  3. מעתיקים את הערך של Redirect URI (ה-URI של ההפניה האוטומטית) לאפליקציה החיצונית.
  4. מאמתים את פרטי ההרשאה.
  5. לוחצים על Authorize.

    אם ההרשאה מתבצעת בהצלחה, סטטוס החיבור יהיה פעיל בדף החיבורים.

אישור מחדש של קוד הרשאה

אם אתם משתמשים בסוג האימות Authorization code וביצעתם שינויים בהגדרות של אפליקציית Azure Synapse, אתם צריכים לאשר מחדש את החיבור ל-Azure Synapse. כדי לאשר מחדש חיבור, מבצעים את השלבים הבאים:

  1. לוחצים על החיבור הרצוי בדף החיבורים.

    ייפתח הדף עם פרטי החיבור.

  2. לוחצים על עריכה כדי לערוך את פרטי החיבור.
  3. בודקים את הפרטים של OAuth 2.0 – קוד הרשאה בקטע אימות.

    אם צריך, מבצעים את השינויים הנדרשים.

  4. לוחצים על Save. הלחיצה תעביר אתכם לדף פרטי החיבור.
  5. בקטע אימות, לוחצים על עריכת הרשאה. מוצגת החלונית Authorize (אישור).
  6. לוחצים על Authorize.

    אם ההרשאה מתבצעת בהצלחה, סטטוס החיבור יהיה פעיל בדף החיבורים.

מגבלות המערכת

מחבר Microsoft Exchange יכול לעבד 4 עסקאות בשנייה, לכל צומת, ומגביל עסקאות שחורגות מהמגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

שימוש בחיבור ל-Microsoft Exchange בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors.

  • כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
  • מידע על יצירה ושימוש במשימת מחברים ב-Application Integration זמין במאמר משימת מחברים.

פעולות

מחבר Microsoft Exchange מספק פעולות כמו MoveItem ו-SendItem. כדי להבין איך להגדיר את הפעולות, אפשר לעיין בדוגמאות לפעולות.

דוגמאות לפעולות

בקטע הזה מוסבר איך לבצע חלק מהפעולות במחבר הזה.

דוגמה – MoveItem

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה MoveItem ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
     {
  "ItemId":"The unique ItemId of the item to be sent"
  "ItemChangekey":"The unique ItemChangeKey of the item to be sent"
  "FolderDisplayName":"The display name of the new folder"
  }

דוגמאות לפעולות על ישויות

דוגמה – רשימה של כל הפריטים בתיקייה SentItems

בדוגמה הזו מוצגת רשימה של כל הרשומות בישות SentItems.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות SentItems מהרשימה Entity.
  3. בוחרים את הפעולה LIST ולוחצים על סיום.

דוגמה – קבלת רשומה ספציפית מהישות Sentitems

בדוגמה הזו מאחזרים רשומה עם המזהה 568ea947-e03d-ef11-8409-7c1e5217e912 מהישות SentItems.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות SentItems מהרשימה Entity.
  3. בוחרים את הפעולה GET ולוחצים על סיום.
  4. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על entityId ואז מזינים 568ea947-e03d-ef11-8409-7c1e5217e912 בשדה Default Value (ערך ברירת מחדל).

    כאן, Id הוא ערך המפתח הראשי של הישות SentItems.

  5. לוחצים על סיום.

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

המאמרים הבאים