SharePoint

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

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

המחבר הזה תומך ב-Windows SharePoint Services 3.0, ב-Microsoft Office SharePoint Server 2007 ומעלה וב-SharePoint Online.

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

בפרויקט Google Cloud, מבצעים את המשימות הבאות:

  • מוודאים שהגדרתם חיבור לרשת. מידע נוסף זמין במאמר קישוריות לרשת.
  • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
  • מקצים את התפקידים roles/secretmanager.viewer ו-roles/secretmanager.secretAccessor ב-IAM לחשבון השירות שבו רוצים להשתמש עבור המחבר:
  • מפעילים את secretmanager.googleapis.com (Secret Manager API) ואת connectors.googleapis.com (Connectors API). מידע נוסף זמין במאמר בנושא הפעלת שירותים.

יצירת חיבור ל-SharePoint

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

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

    כניסה לדף Connections

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

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

  4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
    1. בוחרים באפשרות SharePoint מרשימת המחברים.
    2. בוחרים גרסה של מחבר מהרשימה Connector version (גרסת המחבר). למחבר SharePoint יש שתי גרסאות: V1 ו-V2.
    3. בשדה Connection name, מזינים שם למופע החיבור. שם החיבור יכול להכיל אותיות קטנות, מספרים או מקפים. השם צריך להתחיל באות ולהסתיים באות או במספר, והוא לא יכול להכיל יותר מ-49 תווים.
    4. אופציונלי: מזינים תיאור למופע החיבור.
    5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
    6. בשדה Service account, בוחרים חשבון עם התפקידים הנדרשים.
    7. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

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

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

    8. (אופציונלי) בקטע הגדרות מתקדמות, מסמנים את התיבה שימוש ב-proxy כדי להגדיר שרת proxy לחיבור, ומגדירים את הערכים הבאים:
      • סכימת אימות של שרת proxy: בוחרים את סוג האימות לאימות מול שרת ה-proxy. אלה סוגי האימות שנתמכים:
        • בסיסי: אימות HTTP בסיסי.
        • ‫Digest: אימות HTTP מסוג Digest.
      • משתמש proxy: שם משתמש שישמש לאימות בשרת ה-proxy.
      • סיסמת ה-Proxy: הסוד במנהל הסודות של סיסמת המשתמש.
      • סוג ה-SSL של ה-Proxy: סוג ה-SSL שבו יש להשתמש כשמתחברים לשרת ה-Proxy. אלה סוגי האימות שנתמכים:
        • אוטומטי: הגדרת ברירת המחדל. אם כתובת ה-URL היא כתובת HTTPS, נעשה שימוש באפשרות Tunnel. אם כתובת ה-URL היא כתובת HTTP, נעשה שימוש באפשרות NEVER.
        • תמיד: החיבור תמיד מופעל באמצעות SSL.
        • לעולם לא: החיבור לא מופעל באמצעות SSL.
        • מנהור: החיבור הוא דרך שרת proxy למנהור. שרת ה-proxy פותח חיבור למארח המרוחק, והתנועה זורמת הלוך ושוב דרך ה-proxy.
      • בקטע שרת Proxy, מזינים את פרטי שרת ה-Proxy.
        1. לוחצים על + הוספת יעד.
        2. בוחרים סוג יעד.
          • כתובת המארח: מציינים את שם המארח או את כתובת ה-IP של היעד.

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

    9. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    10. לוחצים על הבא.
  5. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר ולוחצים על הבא.

    6. בשדה סוג היעד, בוחרים סוג יעד. לדוגמה, כתובת המארח היא https://<SITE_NAME>.sharepoint.com.

    • כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
    • כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.

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

    כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.

  6. בקטע אימות, מזינים את פרטי האימות.
    1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

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

      • פרטי הכניסה ל-Windows. בוחרים באפשרות הזו אם משתמשים במהדורה מקומית של SharePoint.
      • ‫AzureAD. בוחרים באפשרות הזו אם משתמשים במהדורה אונליין של SharePoint.
      • פרטי כניסה של לקוח OAuth 2.0 עם JWT bearer. בוחרים באפשרות הזו אם משתמשים בפרטי כניסה של לקוח OAuth 2.0 עם JWT bearer לאימות.
      • פרטי כניסה של לקוח OAuth 2.0 עם סוד לקוח. בוחרים באפשרות הזו אם משתמשים בפרטי כניסה של לקוח OAuth 2.0 עם סוד לקוח לצורך אימות.

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

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

הגדרת אימות

מחבר SharePoint תומך בסוגי האימות הבאים:

סוג האימות של פרטי הכניסה ב-Windows

כדי להפעיל את סוג האימות של פרטי הכניסה ל-Windows, צריך לבצע את השלבים הבאים:

  1. מגדירים PSC ויוצרים קובץ מצורף של נקודת קצה.
  2. מציינים את פרטי הכניסה ב Google Cloud.

הגדרת PSC ויצירת חיבור לנקודת קצה

  1. יוצרים קבוצת מופעים עם כתובת ה-IP שבה מתארח SharePoint.
  2. יוצרים מאזן עומסי רשת פנימי להעברת סיגנל ללא שינוי ומשתמשים בקבוצת המופעים שיצרתם בתור בק-אנד. צריך להפעיל את הגישה הגלובלית במאזן העומסים הפנימי מסוג TCP.
  3. מפרסמים את מאזן העומסים ב-Private Service Connect. אחרי שמפרסמים את מאזן העומסים, Private Service Connect יוצר קובץ מצורף עם השירות.
  4. מפרסמים את השירות ומציינים את מאזן העומסים שיצרתם.
  5. משתמשים בקובץ המצורף של השירות כדי ליצור קובץ מצורף של נקודת קצה.
  6. אחרי שיוצרים את קובץ המצורף של נקודת הקצה, יוצרים חיבור ל-SharePoint עם כתובת ה-IP של קובץ המצורף של נקודת הקצה.

    7. מידע נוסף על יצירת קובץ מצורף של נקודת קצה זמין במאמר יצירת קובץ מצורף של נקודת קצה.

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

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

בקטע Authentication (אימות), בוחרים באפשרות Windows credentials (פרטי כניסה של Windows) כסוג האימות ומזינים את הפרטים הבאים:

  • שם משתמש: מזינים את שם המשתמש.
  • סיסמה: בוחרים את הסיסמה.
  • Secret version (גרסת סוד): מזינים את גרסת הסוד.

סוג החיבור של פרטי הכניסה ל-Windows

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

שם השדה פרטים
אזור us-central1
מחבר SharePoint
גרסת המחבר 1
שם החיבור sharepoint-staging-psc
חשבון השירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
סוג היעד כתובת המארח
מארח 1 http://192.0.2.0
port 1 24
אימות פרטי כניסה ל-Windows
שם משתמש USER_NAME
סיסמה PASSWORD
גרסה של סוד 1

סוג האימות של Azure AD

כדי להפעיל את סוג האימות Azure AD, צריך לבצע את השלבים הבאים:

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

רישום האפליקציה וקבלת OAuthClientId ו-OAuthClientSecret

כדי לרשום את האפליקציה ולקבל את OAuthClientId ואת OAuthClientSecret בשבילה, מבצעים את הפעולות הבאות:

  1. מתחברים אל Azure Portal.
  2. בקטע Azure services (שירותי Azure), בוחרים באפשרות App registrations (רישום אפליקציות) ואז באפשרות New registration (רישום חדש).
  3. מזינים שם לאפליקציה ובוחרים באפשרות חשבונות רק בספרייה הארגונית הזו (דייר יחיד). כברירת מחדל, האפשרות 'ריבוי דיירים' נבחרת.
  4. לוחצים על הרשמה.
  5. אחרי שיוצרים את האפליקציה, עוברים לדף Certificates & secrets (אישורים וסודות).
  6. יוצרים סוד לקוח לאפליקציה ושומרים את הערך של סוד הלקוח.
  7. עוברים לדף הרשאות API.
  8. לוחצים על הוספת הרשאה.
  9. בתיבת הדו-שיח בקשת הרשאות ל-API, בוחרים את ה-API, הסוג וההרשאות מהטבלה הבאה כדי לבצע פעולות באפליקציה.

    10. כדי שהחיבור יהיה פעיל, צריך לתת Sites.Read.All הרשאה ל-API של Microsoft Graph.

    ברוב הפעולות של מחבר SharePoint, צריך להעניק רק את הרשאות האפליקציה הבאות של Microsoft Graph:

    הרשאה חובה עבור
    Sites.Read.All קריאת אתרי SharePoint ומטא-נתונים של אתרים
    Files.Read.All קריאת מסמכים וקבצים שמאוחסנים ב-SharePoint
    User.Read.All פתרון בעיות שקשורות למטא נתונים של משתמשים ולפרטי בעלות

    הרשאות אופציונליות ומתקדמות

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

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

    API שם ההרשאה סוג מתי משתמשים
    Microsoft Graph ConsentRequest.Read.All Application/ Delegated כדי לראות בקשות להסכמה אדמיניסטרטיבית.
    Microsoft Graph ConsentRequest.ReadWrite.All Application/ Delegated כדי לנהל בקשות להסכמה אדמיניסטרטיבית.
    Microsoft Graph DelegatedAdminRelationship.Read.All Application/ Delegated כדי לראות את הקשרים של אדמינים שהוקצתה להם הרשאה.
    Microsoft Graph DelegatedAdminRelationship.ReadWrite.All Application/ Delegated כדי לנהל קשרים של אדמינים שהוענקה להם הרשאה.
    Microsoft Graph DelegatedPermissionGrant.Read.All Application/ Delegated כדי לראות את ההרשאות שהוענקו בהקצאת הרשאות.
    Microsoft Graph DelegatedPermissionGrant.ReadWrite.All Application/ Delegated כדי לנהל את ההרשאות שהוקצו.
    Microsoft Graph Files.ReadWrite.All Application/ Delegated להעלות, לערוך או למחוק קבצים.
    Microsoft Graph Sites.FullControl.All Application/ Delegated כדי להעניק שליטה ניהולית מלאה בכל האתרים.
    Microsoft Graph Sites.Manage.All Application/ Delegated כדי לנהל רשימות, ספריות והגדרות אתר.
    Microsoft Graph Sites.ReadWrite.All Application/ Delegated ליצור, לעדכן או למחוק תוכן באתר.
    Microsoft Graph Sites.Selected Application/ Delegated כדי להגביל את הגישה רק לאוספים ספציפיים של אתרים.
    Microsoft Graph TermStore.Read.All Application/ Delegated כדי לקרוא טקסונומיות ומטא-נתונים מנוהלים.
    Microsoft Graph TermStore.ReadWrite.All Application/ Delegated כדי לנהל טקסונומיות ומטא-נתונים מנוהלים.
    Microsoft Graph User.Export.All Application/ Delegated לייצא נתוני משתמשים לצורך תאימות או גיבוי.
    Microsoft Graph User.Read Delegated כדי להיכנס לחשבון ולקרוא את הפרופיל של המשתמש שמחובר לחשבון.
    Microsoft Graph User.ReadWrite.All Application/ Delegated כדי לעדכן את פרופילי המשתמשים או את המידע במאגר.
    SharePoint EnterpriseResource.Read Delegated כדי לקרוא משאבים ארגוניים של Project Server.
    SharePoint EnterpriseResource.Write Delegated לנהל משאבים ארגוניים ב-Project Server.
    SharePoint Project.Read Delegated כדי לקרוא נתוני פרויקט של SharePoint.
    SharePoint Project.Write Delegated כדי ליצור או לעדכן נתונים של פרויקט ב-SharePoint.
    SharePoint ProjectWebApp.FullControl Delegated כדי להעניק גישת אדמין מלאה ל-Project Web App.
    SharePoint ProjectWebAppReporting.Read Delegated כדי לקרוא נתוני דיווח של Project Web App.
    SharePoint TaskStatus.Submit Delegated כדי לשלוח עדכונים לגבי הסטטוס של משימות בפרויקט.
  10. שומרים את השינויים.
  11. אם בחרתם להשתמש בהרשאות שדורשות הסכמה של אדמין, אתם יכולים להעניק אותן מהדייר הנוכחי בדף API Permissions.
  12. כדי להוסיף את ההיקף, עוברים לקטע Expose an API (חשיפת API) ומוסיפים היקפים של AllSites.Manage, Sites.FullControl.All ובוחרים מי יכול לשלוט (אדמינים ומשתמשים).
  13. לוחצים על Save.

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

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

בקטע אימות, בוחרים באפשרות AzureAD כסוג האימות ומזינים את הפרטים הבאים:

  • ‫Client ID (מזהה לקוח): מזינים את מזהה הלקוח שמשמש לבקשת אסימוני גישה.
  • היקפים: מזינים רשימה מופרדת בפסיקים של ההיקפים הרצויים. לדוגמה, Sites.FullControl.All.
  • סוד לקוח: מזינים את הסוד שמכיל את סוד הלקוח של האפליקציה המקושרת שיצרתם.
  • גרסה של סוד: גרסת הסוד שנבחרה למעלה.
  • כתובת URL לאישור: כתובת ה-URL לאישור שנוצרת כשיוצרים לקוח OAuth. מזינים את כתובת ה-URL בפורמט הבא: https://login.microsoftonline.com/TENANT_IDENTIFIER/oauth2/v2.0/authorize?prompt=consent. לדוגמה, https://login.microsoftonline.com/9byyyyyyyyy8112/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.

סוג החיבור ל-Azure AD

בטבלה הבאה מפורטים ערכי ההגדרה לדוגמה של סוג החיבור Azure AD:

שם השדה פרטים
אזור us-central1
מחבר SharePoint
גרסת המחבר 1
שם החיבור sharepoint-google-cloud-con
חשבון השירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
סוג היעד כתובת המארח
מארח 1 http://z8**.sharepoint.com
אימות AzureAD
מספר לקוח CLIENT_ID
היקפים Sites.FullControl.All
סוד לקוח CLIENT_SECRET
Secret Version 1
כתובת אתר להרשאה https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize?prompt=consent

‫OAuth 2.0 – פרטי כניסה של לקוח עם סוג אימות JWT bearer

כדי להפעיל OAuth 2.0 – פרטי כניסה של לקוח עם סוג אימות של JWT bearer, צריך לבצע את השלבים הבאים:

  1. יצירת אישור
  2. מעלים את האישור לפורטל Azure.
  3. קבלת מפתח פרטי
  4. משלימים את ההגדרה.
  5. מציינים את פרטי הכניסה של JWT bearer ב-OAuth 2.0 ב- Google Cloud.

יצירת אישור

  1. יוצרים תיקייה ריקה במחשב.
  2. יוצרים קובץ טקסט בתיקייה.
  3. מעתיקים את סקריפט PowerShell מהדף Granting access via Azure AD App-Only ומדביקים אותו בקובץ הטקסט.
  4. משנים את השם של קובץ הטקסט לשם הבא: Create-SelfSignedCertificate.ps1.
  5. מריצים את Windows PowerShell בתיקייה.
  6. עוברים לספרייה שמכילה את קובץ הטקסט.
  7. מעתיקים את הפקודה הבאה: .\Create-SelfSignedCertificate.ps1 -CommonName "CERTIFICATE_NAME" -StartDate 2022-09-25 -EndDate 2023-10-25

    מזינים שם ייחודי ל-CERTIFICATE_NAME. משנים את StartDate לתאריך הנוכחי ואת EndDate לתאריך הרצוי.

  8. מדביקים את הפקודה שהעתקתם עם השינויים שלכם ב-Windows PowerShell ואז מקישים על Enter.

    ב-Windows PowerShell מוצגת בקשה להזין את הסיסמה להגנה על המפתח הפרטי. חשוב לשמור את הסיסמה לשימוש בהמשך.

    ‫Windows PowerShell יוצר שני קבצים: MyCertificate.pfx ו-MyCertificate.cer.

העלאת האישור לפורטל Azure

  1. נכנסים ל-Azure Portal ורושמים אפליקציה חדשה על ידי ציון הפרטים הבאים:
    • שם: מזינים שם לאפליקציה.
    • Supported account types (סוגי חשבונות נתמכים): בוחרים באפשרות Accounts in this organizational directory only (Account name only - Single tenant) (חשבונות רק בספרייה הארגונית הזו (שם החשבון בלבד – דייר יחיד)).
  2. עוברים אל הרשאות API > הוספת הרשאה > בקשת הרשאות API > SharePoint.
  3. בוחרים באפשרות הרשאות לאפליקציה ואז מוסיפים את ההרשאות הנדרשות.
  4. לוחצים על Grant admin consent (מתן הסכמת אדמין) ואז על Yes (כן).
  5. אחרי שיוצרים את האפליקציה, עוברים לקטע Certificates & Secrets (אישורים וסודות).
  6. בוחרים באפשרות העלאת אישור ומעלים את אישור ה-CER מהמחשב. אחרי שההעלאה מסתיימת, לוחצים על הוספה.

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

  7. עוברים אל Manifest, מוצאים את KeyCredentials ומעתיקים את customKeyIdentifier בתור Thumbprint. תשתמשו בזה בהמשך. האפליקציה רשומה עכשיו והאישור מקושר אליה.

קבלת מפתח פרטי

אפשר להשיג מפתח פרטי על ידי המרת קובץ PFX לקובץ PEM באמצעות OpenSSL.

  1. בשורת הפקודה, עוברים לתיקייה עם קובץ ה-PFX ומריצים את הפקודה הבאה: openssl pkcs12 -in MyCertificate.pfx -out MyCertificate.pem -nodes
  2. מזינים את סיסמת ה-PFX שבה השתמשתם בתהליך יצירת האישור.
  3. פותחים את קובץ ה-PEM בכלי לעריכת טקסט ומעתיקים את הטקסט כולו, שהוא המפתח הפרטי.

השלמת ההגדרה

  1. מעתיקים את מזהה הלקוח ואת מזהה הדייר (tenant) מהאפליקציה החדשה שנרשמה בפורטל Azure.
  2. נכנסים באמצעות אימות של חשבון משתמש בשירות SharePoint List עם פרטי הכניסה הבאים:
    • מזהה לקוח
    • מזהה דייר (tenant)
    • מפתח פרטי
    • טביעת אצבע (סיסמה של מפתח פרטי)

מציינים את פרטי הכניסה של JWT bearer ב-OAuth 2.0 ב- Google Cloud

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

בקטע אימות, בוחרים באפשרות פרטי כניסה של לקוח OAuth 2.0 עם JWT bearer כסוג האימות, ואז מזינים את הפרטים הבאים:

  • בשדה מזהה לקוח, מזינים את מזהה הלקוח שמשמש לבקשת טוקנים לגישה. זהו טוקן הצרכן שנוצר ב-Azure כשרושמים את האפליקציה בפורטל Azure.
  • בשדה Private key (מפתח פרטי), בוחרים את הסוד ב-Secret Manager שמכיל את התוכן של קובץ המפתח הפרטי בפורמט PEM. המפתח הפרטי צריך להיות תואם למפתח הציבורי או לאישור שסופקו ל-Connector.
  • בשדה Secret version (גרסת הסוד), בוחרים את הגרסה של הסוד שנבחר למעלה.
  • בשדה סיסמת המפתח הפרטי, בוחרים את הסוד במנהל הסודות שמכיל את הסיסמה (פרפראזה) של קובץ המפתח הפרטי. משתמשים באותה סיסמה שהגדרתם להגנה על המפתח הפרטי כשיצרתם את האישור.
  • בשדה Secret version (גרסת הסוד), בוחרים את הגרסה של הסוד שנבחר למעלה.
  • בשדה Azure Tenant, מזינים את הדייר (tenant) של מיקרוסופט אונליין שמשמש לגישה לנתונים.
  • ברישום של Azure AD בדייר יחיד, צריך לציין את מזהה הדייר ב-Azure בשדה Azure Tenant של החיבור. אם השדה הזה חסר או שגוי, החיבור נכשל עם שגיאה java.sql.SQLException: Invalid connection string syntax.. כדי לפתור את השגיאה הזו, צריך לוודא שהשדה Azure Tenant מכיל את מזהה Azure Tenant הנכון של האפליקציה שלכם עם דייר יחיד.

סוג החיבור JWT Bearer Certificate

בטבלה הבאה מפורטים ערכי ההגדרה לדוגמה של סוג החיבור OAuth 2.0 JWT Bearer Certificate.

שם השדה פרטים
אזור europe-west1
מחבר SharePoint
גרסת המחבר 1
שם החיבור sharepoint-jwt-certificate
חשבון שירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
סוג היעד כתובת המארח
מארח 1 http://z8**.sharepoint.com
port 1 ****
אימות פרטי כניסה של לקוח ב-OAuth 2.0 עם JWT bearer
מזהה לקוח ב-OAuth CLIENT_ID
מפתח פרטי מפתח
גרסה של סוד 1
סיסמה של מפתח פרטי PASSWORD
גרסה של סוד 1
דייר Azure AZURE_TENANT_ID

‫OAuth 2.0 – סוג החיבור 'סוד לקוח'

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

  • סוג האימות של Azure AD
  • OAuth 2.0 – פרטי כניסה של לקוח עם JWT bearer

השיטות האלה משתמשות ב-Microsoft Graph, ואנחנו ממליצים עליהן כמנגנוני אימות מאובטחים ל-SharePoint Online.

כדי להפעיל את סוג החיבור 'סוד לקוח ב-OAuth 2.0', צריך לבצע את השלבים הבאים:

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

רישום התוסף

  1. עוברים לדף Register Add-In באמצעות כתובת ה-URL הבאה: https://<SITE_NAME>.SharePoint.com/_layouts/15/appregnew.aspx.
  2. בקטע פרטי האפליקציה, יוצרים את מזהה הלקוח ואת סוד הלקוח.
  3. מציינים ערכים לפרמטרים Title (שם), App domain (דומיין האפליקציה) ו-redirect URI (הפניה אוטומטית לכתובת URI אחרת).
  4. לוחצים על יצירה. לאחר מכן, התוסף נרשם ב-SharePoint, והמידע שנוצר מוצג באפליקציית SharePoint.

מתן הרשאות לתוסף

  1. עוברים לאתר SharePoint באמצעות כתובת ה-URL הבאה: https://<SITE_NAME>-admin.sharepoint.com/_layouts/15/appinv.aspx. המערכת תפנה אתכם לדף Grant Permission (מתן הרשאה).
  2. בשדה מזהה האפליקציה, מזינים את מזהה הלקוח שיצרתם קודם ולוחצים על חיפוש. הערכים של Title (שם), App Domain (דומיין האפליקציה) ו-Redirect URL (כתובת ה-URL להפניה) מאוכלסים.
  3. מזינים את בקשת ההרשאה הבאה בפורמט XML:

    מידע נוסף על רכיבי ה-XML של בקשת ההרשאה זמין במאמר רכיב AppPermissionRequests (AppPermissionManifest).

          <AppPermissionRequests AllowAppOnlyPolicy="true">
      <AppPermissionRequest Scope="http://sharepoint.com/content/tenant" Right="FullControl"/>
      </AppPermissionRequests>

    מידע נוסף על היקפי בקשות ההרשאה זמין במאמר הרשאות של תוספים ב-SharePoint.

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

מציינים את פרטי הכניסה של לקוח OAuth 2.0 ב- Google Cloud

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

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

  • בשדה מזהה לקוח, מזינים את מזהה הלקוח שסופק על ידי כלי החיבור לאפליקציה שיצרתם.
  • בשדה Client Secret (סוד לקוח), בוחרים את הסוד ב-Secret Manager שמכיל את סוד הלקוח של האפליקציה המחוברת שיצרתם.
  • בשדה Secret version, בוחרים את הגרסה של סוד הלקוח.

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

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

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

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

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

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

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

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

סוג החיבור של פרטי הכניסה של הלקוח

בטבלה הבאה מפורטים ערכי ההגדרה לדוגמה של סוג החיבור OAuth 2.0 client credentials.

שם השדה פרטים
אזור europe-west1
מחבר SharePoint
גרסת המחבר 1
שם החיבור sharepoint-client-credentials
חשבון שירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
סוג היעד כתובת המארח
מארח 1 http://z8**.sharepoint.com
port 1 ****
אימות פרטי כניסה של לקוח ב-OAuth 2.0 עם סוד לקוח
מזהה לקוח CLIENT_ID
סוד לקוח CLIENT_SECRET
גרסה של סוד 1

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

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

פעולות

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

גרסה 1

פעולות שנתמכות בגרסה 1

‫AddAttachments,‏ CheckInDocument,‏ CheckOutDocument,‏ CopyDocument,‏ CreateFolder,‏ DeleteAttachment,‏ DiscardCheckOutDocument,‏ DownloadAttachments,‏ DownloadDocument,‏ MoveAttachmentOrDocument ו-UploadDocument.

גרסה 2

פעולות שנתמכות בגרסה 2

AddAttachments,‏ AddLists,‏ CheckInDocument,‏ CheckInFile,‏ CheckPermission,‏ CheckOutDocument,‏ CopyDocument,‏ CreateFolder,‏ DeleteAttachment,‏ DeleteDocument,‏ DeleteLists,‏ DiscardCheckOutDocument,‏ DownloadAttachments,‏ DownloadDocument,‏ MoveAttachmentOrDocument ו-UploadDocument.

הפעולה DeleteAttachment

הפעולה הזו מוחקת קובץ מצורף.

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

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

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

פעולת AddLists

הפעולה הזו מוסיפה רשימה לספריית המסמכים.

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

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

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

פעולת DeleteDocument

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

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

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

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

פעולת CheckPermission

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

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

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

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

פעולת DeleteLists

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

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

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

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

פעולת CheckInFile

הפעולה הזו תבצע צ'ק-אין לקובץ או למסמך.

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

שם הפרמטר סוג נתונים חובה תיאור
RelativeURL String כן כתובת ה-URL היחסית של התיקייה.
DocumentName String כן שם הקובץ.
תגובה String כן תגובה לצ'ק-אין.

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

פעולת CheckOutDocument

הפעולה הזו מוציאה את הקובץ או המסמך לבדיקה.

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

שם הפרמטר סוג נתונים חובה תיאור
RelativeURL String כן כתובת ה-URL היחסית של התיקייה.
DocumentName String כן שם הקובץ.

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

פעולת CheckInDocument

הפעולה הזו מאפשרת לכם לבצע צ'ק-אין למסמך.

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

שם הפרמטר סוג נתונים חובה תיאור
RelativeURL String כן כתובת ה-URL היחסית של התיקייה.
DocumentName String כן שם הקובץ.
תגובה String לא תגובה לצ'ק-אין.

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

הפעולה DiscardCheckOutDocument

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

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

שם הפרמטר סוג נתונים חובה תיאור
RelativeURL String כן כתובת ה-URL היחסית של התיקייה.
DocumentName String כן שם הקובץ.

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

פעולת CopyDocument

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

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

שם הפרמטר סוג נתונים חובה תיאור
SourceFileRelativeUrl String כן כתובת ה-URL היחסית של קובץ המקור.
DestFileRelativeUrl String כן כתובת ה-URL היחסית של קובץ היעד.

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

הפעולה UploadDocument

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

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

שם הפרמטר סוג נתונים חובה תיאור
FileName String כן השם של הקובץ שרוצים להעלות.
RelativeUrl String כן כתובת ה-URL היחסית של התיקייה.
תוכן String לא תוכן להעלאה כקובץ.
ContentBytes String לא התוכן של הקובץ בקידוד Base64. משתמשים באפשרות הזו כדי להעלות נתונים בינאריים.
HasBytes בוליאני לא הפרמטר הזה מציין אם התוכן שרוצים להעלות הוא בינארי. ערך ברירת המחדל הוא false.

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

הפעולה DownloadDocument

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

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

שם הפרמטר סוג נתונים חובה תיאור
RemoteFile String כן כתובת ה-URL של המסמך. אפשר להזין כתובת URL מלאה או כתובת URL יחסית.
ספרייה String כן שם הספרייה.
HasBytes בוליאני לא הפרמטר הזה מציין אם התוכן צריך להיות מורד כבייטים. ערך ברירת המחדל הוא false.

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

פעולת MoveAttachmentOrDocument

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

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

שם הפרמטר סוג נתונים חובה תיאור
SourceFileURL String כן כתובת ה-URL של קובץ המקור להעברה.
DestinationFolderURL String כן כתובת ה-URL של תיקיית היעד.

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

פעולה CreateFolder

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

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

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

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

הפעולה AddAttachments

הפעולה הזו מאפשרת לכם להוסיף קובץ מצורף.

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

שם הפרמטר סוג נתונים חובה תיאור
ListTitle String כן השם של רשימת הקבצים המצורפים.
FileName String כן השם של הקובץ המצורף.
ItemId String כן המזהה של הקובץ המצורף שרוצים להוסיף.
תוכן String כן תוכן הקובץ המצורף.
ContentBytes String לא התוכן של הקובץ בקידוד Base64. משתמשים באפשרות הזו כדי להעלות נתונים בינאריים.
HasBytes בוליאני לא הפרמטר הזה מציין אם התוכן שרוצים להעלות הוא בינארי. ערך ברירת המחדל הוא false.

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

הפעולה DownloadAttachments

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

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

שם הפרמטר סוג נתונים חובה תיאור
RemoteFile String כן כתובת ה-URL של הקובץ.
HasBytes בוליאני לא הפרמטר הזה מציין אם התוכן להורדה הוא בינארי. ערך ברירת המחדל הוא false.

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

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

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

דוגמה – מחיקת קובץ מצורף

בדוגמה הזו נמחק הקובץ שצוין.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DeleteAttachment ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"ListTitle": "My lists",
"ItemId": "1",
"FileName": "sitepages.txt"
}

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

    [{
"Status": "Success"
}]

דוגמה – הכנסת קובץ למערכת בקרת הגרסאות

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CheckInFile ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "RelativeURL": "/Shared Documents/TestFolder",
  "DocumentName": "Document.docx",
  "Comment": "Comment test with more than 1 word"
}

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

    [{
"Status": "Success"
}]

דוגמה – הוספת רשימה לספרייה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה AddLists ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "Template": "DocumentLibrary",
  "Description": "testdata_from_gcpcloud",
  "Name": "TestList1757601118898"
}

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

    [{
"Status": "Success"
}]

דוגמה – מחיקת מסמך

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DeleteDocument ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "Library": "Shared Documents",
  "Path": "/Shared Documents/TestFolder/Document.docx"
}

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

    [{
"Status": "Success"
}]

דוגמה – בדיקת הרשאות ברשימה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CheckPermission ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "ListName": "TestList",
  "ItemId": "1",
  "Principal": "ACLSITE1 Owners"
}

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

    [{
"Status": "Success"
}]

דוגמה – מחיקת רשימה

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

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

    [{
"Status": "Success"
}]

דוגמה – ביצוע צ'ק-אין למסמך

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CheckInDocument ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.txt",
"Comment": "Comment test"
}

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

    [{
"Status": "Success"
}]

דוגמה – הוצאת קובץ

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CheckOutDocument ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.txt"
}

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

    [{
"Status": "Success"
}]

דוגמה – ביטול תשלום

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DiscardCheckOutDocument ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"RelativeURL": "/Shared Documents/TestFolder",
"DocumentName": "Document.docx"
}

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

    [{
"Status": "Success"
}]

דוגמה – העתקת קובץ למיקום אחר

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CopyDocument ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"SourceFileRelativeUrl": "/Shared Documents/Document.docx",
"DestFileRelativeUrl": "/Shared Documents/TestFolder/Document123.docx"
}

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

    [{
"Status": "Success"
}]

דוגמה – העלאת קובץ טקסט למיקום שצוין

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה UploadDocument ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"FileName": "test.txt",
"RelativeUrl": "/Shared Documents/TestFolder",
"Content": "abcd"
}

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

    [{
"Status": "Success"
}]

דוגמה – העלאת קובץ בינארי למיקום שצוין

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה UploadDocument ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"FileName": "test.txt",
"RelativeUrl": "/Shared Documents/TestFolder",
"ContentBytes": "SGVsbG8gd29ybGQK",
"HasBytes": "true"
}

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

    [{
"Status": "Success"
}]

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DownloadDocument ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"RemoteFile": "/TestFolder/test.txt",
"Library": "Shared Documents"
}

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

    [{
"Success": "True",
"Content": "Test File",
}]

דוגמה – הורדה של קובץ בינארי

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DownloadDocument ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"RemoteFile": "/TestFolder/test1.png",
"Library": "Shared Documents"
"HasBytes": "true"  
}

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

    [{
"Success": "True",
"ContentBytes": "VGVzdCBGaWxl",
}]

דוגמה – הורדת קובץ מאתר ספציפי

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DownloadDocument ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "RemoteFile": "	http://z8**.sharepoint.com/sites/SharepointGCS/Docs/SharpointGCS.docx",
  "Library": "Docs",
  "HasBytes": true
}

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

    [
  {
    "Success": "True",
    "ContentBytes": "UEsDBAoAAAAAAAAAIQD/////TwEAAE8BAAAQAAAAW3RyYXNoXS8wMDAwLmRhdP////nFmjQeC1QbGmk9o7n0xjiLgudAMOrYQBpOZdZp5/OrWkWbudVPccasL5uVSKun3URrHAxow7iMUm2WSi7nlGy2Mr+sjJxQSrYFcFtDQyo/QSutWhbNcAODEWh14mklzxCS9C5CW3Fmwme/gMKGjGoXlSVyvtDoB+u0A6XtA8bkWTnPNHSvxcepoAKIdsR96imCvxe4MxOWqHWnQkLDyjNMOMrrQeMDF7nOMCCvPlVn5Vd6KlDYnHlW1zLOcQf6WmKl2xN4Z8WBXZfkrJZqPv6yNdWyp8ADRmgTdRSqDkPpQqzvqWj3qpdiRZqSwyBRtfr2kHBumkTNjSi6drBMFMxZEgrktw6ZxuEXcx3v16cXd6k5JVO3kOXMg/HFnH"
  }
]

    כדי להוריד קובץ מאתר ספציפי, צריך לספק את הכתובת המלאה של הקובץ המרוחק.

דוגמה – העברת קובץ מצורף למיקום אחר

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה MoveAttachmentOrDocument ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"SourceFileURL": "/Shared Documents/test.txt",
"DestinationFolderURL": "/Shared Documents/TestFolder"
}

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

    [{
"Result": "Success"
}]

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

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

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

    [{
"Id": "110842b7-2393-4f11-9391-3d75214e9fb8",
"Status": "Success"
}]

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה AddAttachments ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"ListTitle": "My Lists",
"FileName": "TestAttachment2",
"Content": "abcd text",
"ItemId": "1"
}

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

    [{
"RelativeUrl": "/Lists/My lists/Attachments/1/TestAttachment2",
"Status": "Success"
}]

דוגמה – הוספת קובץ מצורף בינארי לרשימה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה AddAttachments ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"ListTitle": "My Lists",
"FileName": "TestAttachment3",
"ContentBytes": "VGVzdCBGaWxl",
"HasBytes": "true",  
"ItemId": "1"
}

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

    [{
"RelativeUrl": "/Lists/My lists/Attachments/1/TestAttachment3",
"Status": "Success"
}]

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

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

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

    [{
"Success": "True",
"Content": "Test File",
}]

דוגמה – הורדה של קובץ מצורף בינארי

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DownloadAttachments ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"RemoteFile": "/Shared Documents/Document.docx",
"HasBytes": "true"
}

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

    [{
"Success": "True",
"ContentBytes": "VGVzdCBGaWxl",
}]

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

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

גרסה 1

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

קבצים ו'הרשימות שלי'.

גרסה 2

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

קבצים, ListItem, My Lists, RoleAssignments, Sharing Links, SitePages, Subsites ו-Users.

דוגמה – הצגת רשימה של כל הקבצים

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Files מהרשימה Entity.
  3. בוחרים את הפעולה List ולוחצים על סיום.
  4. אופציונלי: בקטע Task Input (קלט משימה) במשימה Connectors (מחברים), אפשר לסנן את קבוצת התוצאות על ידי ציון filter clause (סעיף סינון). אפשר גם לציין כמה תנאי סינון באמצעות אופרטורים לוגיים.

דוגמה – הצגת רשימה של כל קישורי השיתוף של קבצים

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

דוגמה – רשימה של כל קישורי השיתוף של תיקיות

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

דוגמה – רשימה של כל דפי האתר

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

דוגמה – רשימה של כל אתרי המשנה

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

דוגמה – הצגת כל הרשימות שלי

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

דוגמה – הצגת רשימה של כל המשתמשים

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

דוגמה – הצגת כל הפריטים

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

דוגמה – הצגת רשימה של כל הקצאות התפקידים

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

דוגמה – קבלת קישור לשיתוף של קובץ

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Sharing Links מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. מגדירים את entityId ל-Sharing Links. כדי להגדיר את entityId, בקטע מיפוי נתונים של מיפוי הנתונים, לוחצים על פתיחת הכלי לעריכת מיפוי נתונים, מזינים 1.0 בשדה ערך קלט ובוחרים את entityId כמשתנה מקומי.

דוגמה – קבלת פרטי קובץ

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Files מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. מגדירים את entityId לערך Files. כדי להגדיר את entityId, בקטע מיפוי נתונים של מיפוי הנתונים, לוחצים על פתיחת הכלי לעריכת מיפוי נתונים, מזינים ZETdEU1T_UOBEzbgDmsvcubxvUaXbcJNrrNPM4LqoklbdDZx3Eo0SIWPCsc_L6yI בשדה ערך קלט ובוחרים את entityId כמשתנה מקומי.

דוגמה – קבלת קישור לשיתוף של תיקייה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Sharing Links מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. מגדירים את entityId ל-Sharing Links. כדי להגדיר את entityId, בקטע מיפוי נתונים של מיפוי הנתונים, לוחצים על פתיחת הכלי לעריכת מיפוי נתונים, מזינים 3.0 בשדה ערך קלט ובוחרים את entityId כמשתנה מקומי.

דוגמה – קבלת רשימה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות My Lists מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על entityId ואז מזינים 3 בשדה Default Value (ערך ברירת מחדל).

    כאן, 3 הוא ערך של מפתח ראשי בישות My Lists.

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות My Lists מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"AuthorId": 11.0,
"BaseName": "3_",
"Attachments": false,
"Title": "Created List New"
}

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

    [{
"ID": 3.0
}]

דוגמה – מחיקת רשימה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות My Lists מהרשימה Entity.
  3. בוחרים את הפעולה Delete ולוחצים על סיום.
  4. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על entityId ואז מזינים 2 בשדה Default Value (ערך ברירת מחדל).
  • כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
  • מידע על יצירה ושימוש במשימת מחברים ב-Application Integration זמין במאמר משימת מחברים.

מגבלות

אלה המגבלות של מחבר SharePoint:
  • פעולת העדכון של הישויות SitePages ו-Events לא פועלת.
  • פעולת הרשימה של הישויות AllFiles,‏ AllPages,‏ AllEvents,‏ AllLists ו-Sites לא פועלת.

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

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

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