OneDrive

מחבר Onedrive מאפשר לכם לבצע פעולות של הוספה, מחיקה, עדכון וקריאה ב-OneDrive.

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

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

• בפרויקט שלכם ב-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. מחבר: בוחרים באפשרות Onedrive מהרשימה הנפתחת של המחברים הזמינים.
   2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
   3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

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

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים להכיל יותר מ-63 תווים.
   4. אפשר גם להזין תיאור למופע החיבור.
   5. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
   6. רמת הפירוט: רמת הפירוט של החיבור, משתנה מ-1 עד 5. רמת פירוט גבוהה יותר תתעד את כל פרטי התקשורת (בקשה,תגובה ואישורי SSL).
   7. דייר Azure: הדייר ב-Microsoft Online שמשמש לגישה לנתונים. אם לא מציינים דייר, המערכת משתמשת בדייר ברירת המחדל.
   8. מזהה Drive: המזהה של ה-Drive שבו רוצים להשתמש.
   9. List Group Drives (הצגת כונני קבוצות): אפשר לבחור להציג את כונני הקבוצות כשמבצעים שאילתה בכוננים.
   10. אופציונלי: מגדירים את ההגדרות של צומת החיבור:
       • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
       • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

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

   הערה: אפשר להתאים אישית את הערכים של צומת החיבור רק אם אתם לקוחות עם תשלום לפי שימוש.
   11. לוחצים על הבא.
   12. בקטע הרשאה, מזינים את הפרטים של מזהה הלקוח וסוד הלקוח.
       • Client ID: מזהה הלקוח שמשמש לבקשת אסימוני גישה.
       • היקף: רשימה מופרדת בפסיקים של ההיקפים הרצויים מ-Microsoft Azure Portal.
       • סוד הלקוח: סוד ב-Secret Manager שמכיל את סוד הלקוח של האפליקציה המקושרת שיצרתם.
       • גרסה של סוד: גרסת הסוד שנבחרה למעלה.
       • כתובת 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.
   13. לוחצים על הבא.
   14. בדיקה: בודקים את פרטי החיבור והאימות.
   15. לוחצים על יצירה.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   מחבר OneDrive יכול לעבד עד 15 עסקאות לכל דקה, לכל צומת, ומגביל את כל העסקאות מעבר למגבלה הזו:

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

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

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

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

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

   שימוש בחיבור Onedrive בשילוב

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

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

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

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

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

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

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

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

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

   פעולות

   החיבור ל-OneDrive תומך בפעולות הבאות:

   פעולת CopyResource

   בטבלה הבאה מפורטים פרמטרי הקלט של הפעולה CopyResource.

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

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

   פעולת CreateFolder

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

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

   שם הפרמטר	חובה	סוג נתונים	תיאור
   FolderName	כן	String	שם התיקייה שרוצים ליצור.
   queueName	לא	String	ההודעה שתישלח לתור של TIBCO EMS. הגודל המקסימלי של הודעה שנתמך הוא 10MB.

   הפעולה DeleteResource

   בטבלה הבאה מתוארים פרמטרי הקלט של הפעולה DeleteResource.

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

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

   פעולת MoveResource

   בטבלה הבאה מפורטים פרמטרי הקלט של הפעולה MoveResource.

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

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

   פעולת RenameResource

   בטבלה הבאה מתוארים פרמטרי הקלט של הפעולה RenameResource.

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

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

   הפעולה UploadFile

   בטבלה הבאה מתוארים פרמטרי הקלט של הפעולה UploadFile.

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

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