Office365

מחבר Office365 מאפשר לכם להתחבר למופע של Office365 ולבצע את הפעולות הנתמכות.

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

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

• בפרויקט שלכם ב-Google Cloud:
  • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
  • מפעילים את השירותים הבאים:
    • ‫secretmanager.googleapis.com (Secret Manager API)
    • ‫connectors.googleapis.com (Connectors API)

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

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

הגדרת המחבר

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

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

   כניסה לדף Connections

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

      אזורים נתמכים למחברים:

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

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

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

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

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

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

   הערה: אפשר להתאים אישית את הערכים של צומת החיבור רק אם אתם לקוחות עם תשלום לפי שימוש.
   8. דייר Azure: הדייר ב-Microsoft Online שמשמש לגישה לנתונים. אם לא תציינו דייר, המערכת תשתמש בדייר שמוגדר כברירת מחדל.
   9. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
   10. לוחצים על הבא.
5. בקטע אימות, מזינים את פרטי האימות.
   1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      החיבור ל-Office365 תומך בסוגי האימות הבאים:

      • הרשאת קוד אימות OAuth 2.0

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

   2. לוחצים על הבא.
6. בדיקה: בודקים את פרטי החיבור והאימות.
7. לוחצים על יצירה.

הגדרת אימות

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

1. רושמים את האפליקציה ומקבלים את מזהה הלקוח ואת סוד הלקוח.
2. מציינים את פרטי הכניסה ב Google Cloud.
3. מאשרים את החיבור ב Google Cloud.
4. מוסיפים את כתובת ה-URL של ההפניה לאפליקציה.

רישום האפליקציה וקבלת מזהה הלקוח וסוד הלקוח

1. מתחברים לפורטל Azure.
2. בקטע Azure Services (שירותי Azure), בוחרים באפשרות App Registrations (רישומי אפליקציות) ואז באפשרות New registration (רישום חדש).
3. מזינים שם לאפליקציה.
4. מגדירים מי יכול להשתמש באפליקציה או לגשת ל-API.
5. מגדירים את כתובת ה-URL להפניה http://localhost:33333 או מציינים יציאה אחרת ומגדירים את CallbackURL לכתובת ה-URL לתשובה שהגדרתם.
6. לוחצים על הרשמה.
7. שומרים את מזהה האפליקציה (הלקוח) ואת מזהה הספרייה (הדייר) לשימוש מאוחר יותר.
8. עוברים לקטע Certificates & Secrets (אישורים וסודות) ומגדירים את סוג האימות של האפליקציה.
   • כדי לאמת באמצעות אישור, בוחרים באפשרות העלאת אישור ומעלים את האישור מהמחשב המקומי.
   • כדי להשתמש באימות באמצעות סוד לקוח, בוחרים באפשרות New Client Secret ומציינים את משך הזמן שלו. אחרי ששומרים את הסוד של הלקוח, מעתיקים את ערך המפתח, שבו תשתמשו כסוד של הלקוח.
9. בהרשאות API, בוחרים באפשרות Microsoft Graph API ואז בוחרים את הרשאות האפליקציה וההרשאות המוקצות הנדרשות.

10. לוחצים על Save.

הענקת גישת בעלים לאפליקציה

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

1. מתחברים לפורטל Azure.
2. ב-Azure Active Directory, בוחרים באפשרות App registrations.
3. לוחצים על שם האפליקציה.
4. עוברים לקטע בעלים.
5. לוחצים על הוספת בעלים ובוחרים את הבעלים שרוצים להוסיף.

מציינים את פרטי הכניסה ב Google Cloud

כשיוצרים את החיבור ב-Integration Connectors , צריך לציין את הפרטים הבאים:

בקטע אימות, מזינים את הפרטים הבאים:

• ‫Client ID (מזהה לקוח): מזינים את מזהה הלקוח שמשמש לבקשת אסימוני גישה.
• היקפים: מזינים רשימה מופרדת בפסיקים של ההיקפים הרצויים.
• סוד לקוח: מזינים את הסוד שמכיל את סוד הלקוח של האפליקציה המקושרת שיצרתם.
• ‫Secret version (גרסה של סוד): גרסת הסוד שנבחרה.
• כתובת 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.

אישור החיבור ב- Google Cloud

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

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

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

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

3. מעתיקים את הערך של Redirect URI (ה-URI של ההפניה האוטומטית) לאפליקציה החיצונית. מידע נוסף זמין במאמר הוספת כתובת ה-URL להפניה אוטומטית לאפליקציה.
4. מאמתים את פרטי ההרשאה.
5. לוחצים על Authorize.

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

הוספת כתובת ה-URL להפניה אוטומטית לאפליקציה

1. בפורטל Azure, לוחצים על Azure services > App registrations.
2. לוחצים על שם האפליקציה.
3. לוחצים על 'הוספת URI של הפניה אוטומטית'.
4. לוחצים על הוספת פלטפורמה.
5. בתיבת הדו-שיח Web, מדביקים את ה-URI של ההפניה שהעתקתם כשאישרתם את החיבור ב- Google Cloud.

כשמגדירים את אפליקציית ה-OAuth של צד שלישי, צריך להשתמש בכתובת ה-URI המורשית להפניה אוטומטית (כתובת ה-URL של הקריאה החוזרת):

https://console.cloud.google.com//connectors/oauth?project=PROJECT_ID

מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

דוגמה לחיבור

בטבלה הבאה מפורטים ערכי ההגדרה לדוגמה של החיבור ל-Office365:

שם השדה	פרטים
אזור	us-central1
מחבר	Office 365
גרסת המחבר	1
שם החיבור	office365-google-cloud-con
חשבון השירות	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
AzureTenant	AZURE_TENANTID
מספר הצמתים המינימלי	2
מספר הצמתים המקסימלי	2
מזהה לקוח	CLIENT_ID
היקפים	offline_access Group.Read.All Group.ReadWrite.All user.read user.readwrite.all calendars.readwrite contacts.readwrite mail.readwrite Files.ReadWrite.All
סוד לקוח	CLIENT_SECRET
גרסת הסוד	1
כתובת אתר להרשאה	https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize

ישויות, פעולות ופעולות

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

הערה: אפשר לראות את הישויות, הפעולות והפעולות של מחבר במשימת המחברים.

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

  עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

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

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

• פעולה: פעולה היא פונקציה מסוג first class שזמינה לשילוב דרך ממשק המחבר. פעולה מאפשרת לבצע שינויים בישות אחת או בכמה ישויות, והיא משתנה ממתחם למתחם. בדרך כלל, לפעולה יהיו כמה פרמטרים של קלט ופרמטר של פלט. עם זאת, יכול להיות שמחבר לא תומך באף פעולה, ובמקרה כזה הרשימה Actions תהיה ריקה.

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

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

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

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

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

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

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

פעולות

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

הערה: התוצאות של כל הפעולות יהיו זמינות כתשובת JSON בפרמטר התשובה connectorOutputPayload של המשימה Connectors אחרי שתפעילו את השילוב.

הפעולה CancelEvent

הפעולה הזו מאפשרת לבטל אירוע.

פרמטרים של קלט לפעולה CancelEvent

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

דוגמאות להגדרת הפעולה CancelEvent מופיעות במאמר דוגמאות לפעולות.

פעולת MoveMail

הפעולה הזו מאפשרת להעביר אימייל.

פרמטרים של קלט לפעולה MoveMail

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

דוגמה להגדרת הפעולה MoveMail מופיעה במאמר דוגמאות לפעולות.

הפעולה AssignLicense

הפעולה הזו מאפשרת להקצות רישיון.

פרמטרים של קלט בפעולה AssignLicense

שם הפרמטר	סוג נתונים	חובה	תיאור
UserId	String	לא	המזהה של המשתמש שצריך להקצות לו רישיון.
UserPrincipalName	String	לא	שם המשתמש שצריך להקצות לו רישיון.
AddLicenseSkuId	String	לא	המזהה הייחודי של המק"ט.
DisabledPlans	String	לא	אוסף של מזהים ייחודיים של תוכניות שהושבתו, מופרדים באמצעות פסיקים.
RemoveLicenses	String	לא	אוסף של מזהים מופרדים בפסיקים שמזהים את הרישיונות להסרה.

דוגמאות להגדרת הפעולה AssignLicense מופיעות במאמר דוגמאות לפעולות.

פעולת ForwardEvent

הפעולה הזו מאפשרת להעביר אירוע.

פרמטרים של קלט של הפעולה ForwardEvent

שם הפרמטר	סוג נתונים	חובה	תיאור
EventId	String	כן	המזהה של האירוע.
UserId	String	לא	מזהה המשתמש.
UserPrincipalName	String	לא	שם המשתמש שצריך להקצות לו רישיון.
תגובה	String	לא	תגובה שרוצים לכלול.
ToRecipients	String	כן	רשימה של כתובות אימייל של נמענים שמופרדות באמצעות נקודה-פסיק.

דוגמאות להגדרת הפעולה ForwardEvent מופיעות במאמר דוגמאות לפעולות.

הפעולה UploadFile

הפעולה הזו מאפשרת להעלות קובץ.

פרמטרים של קלט לפעולה UploadFile

שם הפרמטר	סוג נתונים	חובה	תיאור
FileName	String	לא	השם של הקובץ שאליו צריך להעלות תוכן.
LocalFile	String	לא	קובץ מקומי שמכיל את התוכן שרוצים להעלות.
ContentStream	String	לא	התוכן כזרם קלט להעלאה אם לא מצוין localpath או folderpath.
ParentId	String	כן	מזהה התיקייה שבה נמצא הפריט הנוכחי.
תוכן	String	לא	תוכן הקובץ שרוצים להעלות.

דוגמאות להגדרת הפעולה UploadFile מופיעות במאמר דוגמאות לפעולות.

הפעולה DownloadFile

הפעולה הזו מאפשרת להוריד קובץ.

פרמטרים של קלט של הפעולה DownloadFile

שם הפרמטר	סוג נתונים	חובה	תיאור
FileId	String	כן	המזהה של הקובץ שרוצים להוריד.
DownloadTo	String	לא	איפה לאחסן את הקובץ.
קידוד	String	לא	סוג הקידוד של קלט FileData. הערכים המותרים הם NONE ו-BASE64, וערך ברירת המחדל הוא BASE64.
FileStream	String	לא	מופע של זרם פלט שבו נכתבים נתונים של קובץ. בשימוש רק אם לא צוין DownloadTo.

דוגמאות להגדרת הפעולה DownloadFile מופיעות במאמר דוגמאות לפעולות.

פעולת CreateFolder

הפעולה הזו מאפשרת ליצור תיקייה.

פרמטרים של קלט לפעולה CreateFolder

שם הפרמטר	סוג נתונים	חובה	תיאור
ParentId	String	לא	המזהה של התיקייה שבה נמצא הפריט הנוכחי.
FolderName	String	כן	שם התיקייה שרוצים ליצור.

דוגמה להגדרת הפעולה CreateFolder מופיעה במאמר דוגמאות לפעולות.

פעולת SendMail

הפעולה הזו מאפשרת לשלוח אימייל.

פרמטרים של קלט לפעולה SendMail

שם הפרמטר	סוג נתונים	חובה	תיאור
ToRecipients	String	לא	הנמענים שאליהם צריך לשלוח את האימייל.
תוכן	String	לא	תוכן האימייל.
נושא	String	לא	נושא האימייל.
מזהה	String	לא	המזהה של ההודעה שרוצים לשלוח (אופציונלי). המשתמש יכול להשתמש במזהה אימייל קיים או לשלוח אימייל חדש על ידי מילוי השדות האחרים (אופציונלי).
קבצים מצורפים	String	לא	הקבצים המצורפים. מציינים קבצים מצורפים בפורמט הבא: filename1,filecontent1;filename2,filecontent2. התוכן של כל קובץ יכול להיות נתונים בפורמט BASE64, או הנתיב של קובץ מקומי עם התו @ לפניו.
FileName	String	לא	הנמענים מציינים את הנמענים בסדר הבא.
LocalFile	String	לא	הקובץ שמכיל את התוכן של הקובץ המצורף.
ContentBytes	String	לא	תוכן הקובץ המצורף בקידוד BASE64.
CCRecipients	String	לא	ערכים של הנמענים בהעתק, מופרדים באמצעות נקודה ופסיק.
SenderEmail	String	לא	כתובת האימייל שצריך לשלוח בשמה. מגדירים את ההגדרה הזו אם רוצים לשלוח אימייל בשם חשבון של משתמש אחר.
FromEmail	String	לא	כתובת האימייל של המשתמש שממנה צריך לשלוח את האימייל. צריך להגדיר את זה אם רוצים לשלוח אימייל מחשבון של משתמש אחר.
ContentType	String	לא	סוג התוכן של גוף האימייל.הערכים המותרים הם text ו-html. ערך ברירת המחדל הוא text.

דוגמה להגדרת הפעולה SendMail מופיעה במאמר דוגמאות לפעולות.

פעולת ForwardMail

הפעולה הזו מאפשרת להעביר אימייל.

פרמטרים של קלט לפעולה ForwardMail

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

דוגמה להגדרת הפעולה ForwardMail מופיעה במאמר דוגמאות לפעולות.

הפעולה DownloadEmail

הפעולה הזו מאפשרת להוריד אימייל.

פרמטרים של קלט לפעולה DownloadEmail

שם הפרמטר	סוג נתונים	חובה	תיאור
MessageId	String	כן	מזהה ההודעה שרוצים להוריד.
קידוד	String	לא	סוג הקידוד של נתוני הקלט בקובץ.
DownloadTo	String	לא	איפה לאחסן את הקובץ.
FileStream	String	לא	מופע של זרם פלט שאליו צריך לכתוב את נתוני הקובץ. הערך הזה משמש רק אם לא צוין ערך DownloadTo.

דוגמה להגדרת הפעולה DownloadMail מופיעה במאמר דוגמאות לפעולות.

הפעולה DownloadAttachments

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

פרמטרים של קלט לפעולה DownloadAttachments

שם הפרמטר	סוג נתונים	חובה	תיאור
MessageId	String	כן	מזהה האימייל שממנו רוצים לקבל את הקבצים המצורפים.
קידוד	String	לא	סוג הקידוד של קלט FileData. הערכים המותרים הם NONE ו-BASE64.
DownloadTo	String	לא	איפה לאחסן את הקבצים המצורפים. אם לא מציינים ערך, הפונקציה מחזירה את בייטים התוכן של הקובץ המצורף. חובה לציין את הערך הזה אם מציינים את MessageId.
AttachmentId	String	לא	מזהה הקובץ המצורף שרוצים להוריד. אם לא מציינים קבצים מצורפים, הפונקציה מחזירה את כל הקבצים המצורפים של האימייל.
UserId	String	לא	המזהה של המשתמש. הפעולה הזו תפעל רק אם למשתמש המאומת יש הרשאות אדמין.
FileStream	String	לא	מופע של זרם פלט שבו נכתבים נתונים של קובץ. בשימוש רק אם לא צוין DownloadTo.

דוגמה להגדרת הפעולה DownloadAttachments מופיעה במאמר דוגמאות לפעולות.

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

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

דוגמה – ביטול אירוע

בדוגמה הזו, אירוע עם המזהה שצוין מבוטל.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה CancelEvent ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-GAAA=",   
   "Comment": "Canceled due to rain"
   }

אם הפעולה מצליחה, לפרמטר התגובה CancelEvent של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

[{
"Status": "Success"
}]

דוגמה – הקצאה והסרה של רישיון

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה AssignLicense ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "UserID": "ee58217f-b22e-4300-a876-53db3c71a87b",   
   "AddLicenseSkuId": "c42b9cae-ea4f-4ab7-9717-81576235ccac",   
   "RemoveLicenses": "c42b9cae-ea4f-4ab7-9717-81576235ccac"
   }

אם הפעולה מצליחה, לפרמטר התגובה AssignLicense של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

[{
"Status": "Success"
}]

דוגמה – העברת אירוע

בדוגמה הזו מועבר אירוע.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה ForwardEvent ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAENAAAhfASdetQfTZ3pESzwWnAbAAA_CxGjAAA=",   
   "Comment": "forwarded due to rain",   
   "ToRecipients": "[e-mail]"
   }

אם הפעולה מצליחה, לפרמטר התגובה ForwardEvent של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

[{
"Status": "Success"
}]

דוגמה – העלאת קובץ

בדוגמה הזו מעלים קובץ.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה UploadFile ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "FileName": "Document1234.docx",   
   "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",   
   "Content": "test"
   }

אם הפעולה מצליחה, לפרמטר התגובה UploadFile של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

 [{
"Id": "01VCU572JX6F3L3NKLQVB2BXETRHLEAUAY",   
"@test.context": "https://example.com/v1.0/$metadata#users('7954f490-5a43-083fc215362a')/drive/items('01VCU5BZO354PWSELRRZ')/test/$entity",   
"@example.downloadurl": "https://example.com/test/admin123/_layouts/15/download.aspx?UniqueId=bd76224r7-4........
"Status": "Success"
}] 

דוגמה – הורדת קובץ

בדוגמה הזו מתבצעת הורדה של קובץ.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה DownloadFile ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "FileId": "01VCU572LDCGQYZOSMHZDZGN5HCXS5P6EP"
   }

אם הפעולה מצליחה, לפרמטר התגובה DownloadFile של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

[{
"Status": "Success",
"FileData": "UEsDBBQAAAAIAEoTdVdSWj6GTAEAABoFAAATAAAAWNdLnhtbLWUTU7DMBCFr2J"
}]

דוגמה – יצירת תיקייה

בדוגמה הזו נוצרת תיקייה.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה CreateFolder ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",   
   "FolderName": "outbox1234"
   }

אם הפעולה מצליחה, לפרמטר התגובה CreateFolder של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

[{
"Status": "Success"
}]

דוגמה – שליחת אימייל

בדוגמה הזו נשלח אימייל לנמענים שצוינו.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה SendMail ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "ToRecipients": "[e-mail]",   
   "Content": "Testing",   
   "Subject": "Test subject",   
   "FileName": "Google"
   }

אם הפעולה מצליחה, לפרמטר התגובה SendMail של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

[{
"Status": "Success"
}]

דוגמה – העברת אימייל

בדוגמה הזו, אימייל מועבר.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה ForwardMail ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "MessageId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTpESzwWnAbAAA0sITVAAA=",   
   "ToRecipients": "[e-mail]",   
   "Comment": "forwarded message"
   }

אם הפעולה מצליחה, לפרמטר התגובה ForwardMail של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

[{
"Status": "Success"
}]

דוגמה – הורדת אימייל

בדוגמה הזו מתבצעת הורדה של אימייל.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה DownloadEmail ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
   "MessageId": "fTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITVAAA="
   }

אם הפעולה מצליחה, לפרמטר התגובה DownloadEmail של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

[{
"Status": "Success",   
"FileData": "RnJvbTogRk5VIExOVSA8YWRtaW4xMjNANzNzY21nLm9ubWljcm9zb2Z0LmNvbT4NClRvOiB0ZXN0IDx0ZXN0.......
}]

דוגמה – הורדת קבצים מצורפים

בדוגמה הזו מתבצעת הורדה של קבצים מצורפים.

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה DownloadAttachments ולוחצים על סיום.
3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
   {"MessageId": "PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITWAAA=",   
   "DownloadTo": "My files/Office355/reports/"}
   }

אם הפעולה מצליחה, לפרמטר התגובה DownloadAttachments של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

[{
"Id": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGTWAAABEgAQAF3EBDrnTc1Cj8akAYrJjdM=",
"Name": "demoattachment.docx",
"ContentBytes": "UEsDBBQAAAAIALskYlcppqeszQEAAHQJAAATAAAAWAAAI3RyYXNoXS8wMDAwLmRhdP........",
"LastmodifiedDatetime": "2023-11-21T10:09:09Z",
"ContentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"FileData": null,
"json:repeatelementorder#": null,
"size": "23575",
"isinline": "false
}]

שימוש בחיבור ל-Office365 בשילוב

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

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

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

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

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

• איך משעים ומחדשים חיבור
• איך עוקבים אחרי השימוש בכלי לחיבור נתונים
• איך צופים ביומני המחברים