סקירה כללית

מאגר הנתונים של Microsoft SharePoint ל-Gemini Enterprise מאפשר לכם לחפש ולבצע פעולות בנתונים שלכם ב-Microsoft SharePoint Online, כולל מסמכים, רשימות ואתרים.

גרסאות נתמכות של Microsoft SharePoint

מאגר הנתונים של Microsoft SharePoint תומך בגרסה העדכנית של Microsoft SharePoint Online בענן.

פעולות נתמכות

כמאגר הנתונים של Microsoft SharePoint מופעל, משתמשי הקצה יכולים להשתמש בפקודות בשפה טבעית ב-Gemini Enterprise כדי לבצע את הפעולות הבאות.

פעולה תיאור
יצירת תיקייה יוצר תיקייה חדשה בנתיב שצוין.
הוספת רשימה יצירת רשימה חדשה של נתונים מובְנים (למשל, משימות, אנשי קשר) באתר Microsoft SharePoint.
העלאת מסמך העלאת מסמך לאתר או לספרייה של Microsoft SharePoint.
הורדת המסמך הורדה של מסמך מאתר או מספרייה של Microsoft SharePoint.
הוספת דף יצירת דף חדש באתר Microsoft SharePoint.
הוצאת מסמך הוצאת מסמך מספריית Microsoft SharePoint.
בדיקה במסמך הכנסת מסמך לספרייה ב-Microsoft SharePoint.
שינוי השם של קובץ מצורף או מסמך שינוי השם של קובץ מצורף או מסמך בספרייה של Microsoft SharePoint.
העברת קובץ מצורף או מסמך העברה של מסמך מספרייה ב-Microsoft SharePoint לספריית יעד, לתיקייה או לאתר אחר ב-SharePoint.

ההרשאות הנדרשות

כדי לאפשר ל-Gemini Enterprise לבצע חיפוש ולהטמיע נתונים באמצעות מאגר הנתונים של Microsoft SharePoint, אתם צריכים את ההרשאות הבאות:

הרשאות של Microsoft Graph API

בטבלה הבאה מפורטות ההרשאות הנדרשות לכל מצב חיבור.

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

מצב החיבור היקף מטרה
חיפוש מאוחד לא רלוונטי לא נדרשות הרשאות Graph API.
הטמעת נתונים GroupMember.Read.All (פרטי כניסה מאוחדים ואסימון רענון של OAuth 2.0) מאפשרת למאגר הנתונים לקרוא את החברויות ואת מאפייני הקבוצה הבסיסיים של כל הקבוצות ללא משתמש מחובר.
User.Read (פרטי כניסה מאוחדים ואסימון רענון של OAuth 2.0) מאפשרים למאגר הנתונים לקרוא את הפרופיל של משתמשים שמחוברים לחשבון. היא גם מאפשרת למאגר הנתונים לקרוא פרטים בסיסיים על החברה של משתמשים שמחוברים לחשבון שלהם.
User.Read.All (טוקן רענון של OAuth 2.0 בלבד) מאפשר למאגר הנתונים לקרוא פרופילים של משתמשים.
‫Sites.FullControl.All (אפשרות 1)
Sites.Selected (אפשרות 2)		 (פרטי כניסה מאוחדים ואסימון רענון של OAuth 2.0) אפשרות 1 מאפשרת למאגר הנתונים שליטה מלאה בכל אוספי האתרים. אפשרות 2 מאפשרת למאגר הנתונים לגשת לקבוצת משנה של אוספי אתרים. אפשר להגדיר ב-SharePoint Online את אוספי האתרים הספציפיים ואת ההרשאות שניתנו.
‫User.Read.All (אפשרות 1)
User.ReadBasic.All (אפשרות 2)		 (רק לפרטי כניסה מאוחדים) אפשרות 1 מאפשרת למאגר הנתונים לקרוא פרופילי משתמשים. אפשרות 2 מאפשרת למאגר הנתונים לקרוא קבוצה בסיסית של מאפייני פרופיל של משתמשים אחרים בארגון.
פעולות Sites.ReadWrite.All (חיפוש מאוחד והעברת נתונים) מאפשרת למאגר הנתונים לערוך או למחוק מסמכים ופריטים ברשימה בכל אוספי האתרים בשם המשתמש המחובר.
Files.ReadWrite מאפשרת למאגר הנתונים לקרוא, ליצור, לעדכן ולמחוק את הקבצים של המשתמש שמחובר לחשבון.
Files.ReadWrite.All מאפשר למאגר הנתונים לקרוא, ליצור, לעדכן, למחוק, להעלות ולהוריד את כל הקבצים שהמשתמש המחובר יכול לגשת אליהם.
Sites.Manage.All מאפשר למאגר הנתונים ליצור או למחוק ספריות מסמכים ורשימות בכל אוספי האתרים בשם המשתמש.

הרשאות ל-Microsoft SharePoint API

בטבלה הבאה מפורטות ההרשאות הנדרשות לכל מצב חיבור.

מצב החיבור היקף מטרה
חיפוש מאוחד Sites.Search.All (הועברו) מאפשר למאגר הנתונים להריץ שאילתות חיפוש ולקרוא מידע בסיסי על האתר בשם המשתמש הנוכחי שמחובר לחשבון. תוצאות החיפוש מבוססות על הרשאות המשתמש ולא על הרשאות האפליקציה.
AllSites.Read (אפשרות 1, גישה שהוענקה) מאפשר למאגר הנתונים לקרוא מסמכים ופריטים ברשימה בכל אוספי האתרים בשם המשתמש המחובר.
Sites.Selected (אפשרות 2, מואצל) מאפשרת למאגר הנתונים לגשת לקבוצת משנה של אוספי אתרים עם משתמש שמחובר לחשבון. אפשר להגדיר ב-SharePoint Online את אוספי האתרים הספציפיים ואת ההרשאות שניתנו.
העברת נתונים (פרטי כניסה מאוחדים) ‫Sites.FullControl.All (אפשרות 1, אפליקציה) מאפשר למאגר הנתונים שליטה מלאה בכל אוספי האתרים.
‫Sites.Selected (אפשרות 2, אפליקציה) מאפשרת למאגר הנתונים לגשת לקבוצת משנה של אוספי אתרים עם משתמש שמחובר לחשבון. אפשר להגדיר ב-SharePoint Online את אוספי האתרים הספציפיים ואת ההרשאות שניתנו.
העברת נתונים (טוקן רענון של OAuth 2.0) AllSites.FullControl (אפשרות 1, גישה שהוענקה) מאפשר למאגר הנתונים לקבל שליטה מלאה בכל אוספי האתרים בשם המשתמש המחובר.
Sites.Selected (אפשרות 2, מואצל) מאפשרת למאגר הנתונים לגשת לקבוצת משנה של אוספי אתרים עם משתמש שמחובר לחשבון. אפשר להגדיר ב-SharePoint Online את אוספי האתרים הספציפיים ואת ההרשאות שניתנו.
פעולות AllSites.Write (הועברו) מאפשר למאגר הנתונים ליצור, לקרוא, לעדכן, למחוק, להעלות ולהוריד מסמכים ופריטים ברשימה בכל אוספי האתרים בשם המשתמש המחובר.

במאמר הגדרה של Microsoft SharePoint והרשאות נדרשות מוסבר איך להוסיף את ההרשאות ל-Microsoft SharePoint.

מגבלות

בקטע הזה מפורטות בעיות ידועות ומגבלות שעשויות להשפיע על השימוש במאגר הנתונים של Microsoft SharePoint.

  • כשיוצרים אפליקציה חדשה או מוסיפים מאגר נתונים למאגר קיים, מומלץ לשייך רק מאגר נתונים אחד לפעולות ששייכות לסוג מחבר יחיד.
  • אין תמיכה באכיפת היקף של VPC Service Controls במאגרי נתונים קיימים של Microsoft SharePoint. כדי לאכוף את VPC Service Controls, צריך למחוק את מאגרי הנתונים וליצור אותם מחדש. מידע נוסף על VPC Service Controls ועל אופן השימוש בפעולות אחרי הפעלת VPC Service Controls זמין במאמר אבטחת האפליקציה באמצעות VPC Service Controls.
  • מאגר הנתונים של Microsoft SharePoint נתמך רק במיקומים global, us ו-eu.

אלה המגבלות של מאגר הנתונים המאוחד של Microsoft SharePoint:

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

המלצה

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

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