إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ملحوظة
الميزات في هذا المقال مدعومة بالحزام القياسي، الذي يستخدم خيارات الفوترة الموضحة في الترخيص للوكلاء المدعومين بالحزام القياسي. تعلم كيفية الوصول إلى الميزات القياسية في وكلاء Access القياسيين وتدفقات الوكلاء.
Important
هذه ميزة إصدار أولي.
- Microsoft إصدارات ميزات المعاينة قبل إصدار رسمي بحيث يمكن للعملاء الوصول المبكر وتقديم الملاحظات.
- تحتوي ميزات المعاينة على وظائف مقيدة ولا يقصد بها استخدام الإنتاج.
- قد تُجري مايكروسوفت تغييرات على أسماء ومعلمات أدوات المعاينة MCP. تجنب التبعيات المشفرة. يحتفظ Microsoft بدعم السيناريو.
- تخضع ميزات المعاينة لشروط الاستخدام الإضافية Microsoft.
نظرة عامة
| مُعرف خادم | عنوان URL على مستوى المستأجر | اسم العرض | الوصف |
|---|---|---|---|
mcp_SharePointRemoteServer |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_SharePointRemoteServer |
SharePoint | أدوات لعمليات SharePoint. استخدم هذا الخادم لإدارة المواقع والقوائم وعناصر القوائم والأعمدة ومكتبات المستندات والملفات والمجلدات ومشاركة الملفات. تقتصر عمليات الملفات على الملفات التي تبلغ 5 ميغابايت أو أقل. |
الأدوات المتوفرة
findSite
يعثر على مواقع SharePoint التي يمكنك الوصول إليها. إرجاع مواقع معينة تطابق استعلام بحث، أو أفضل 20 موقعا ذا صلة إذا لم توفر استعلاما.
المعلمات الاختيارية:
- searchQuery: استعلام البحث (اسم الموقع بالكامل أو جزئيا). حذف لإرجاع أفضل 20 موقعا يمكن الوصول إليها.
getSiteByPath
حل موقع SharePoint باستخدام اسم المضيف الدقيق والمسار النسبي للخادم. استخدم هذا الأسلوب فقط عندما يكون لديك بنية عنوان URL الكامل للموقع. استخدم findSite عندما تعرف اسم موقع فقط.
المعلمات المطلوبة:
- المضيف: اسم المضيف الدقيق (على سبيل المثال، "contoso.sharepoint.com")
- serverRelativePath: المسار النسبي للخادم (على سبيل المثال، «المواقع/التسويق»). الشرطة المائلة في البداية اختيارية.
قائمة المواقـع الفرعيـة (listSubsites)
يسرد كافة المواقع الفرعية (المواقع التابعة) لموقع SharePoint.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint الأصل (التنسيق: 'hostname,siteCollectionId,webId')
listDocumentLibrariesInSite
يسرد مكتبات المستندات (محركات الأقراص) في موقع SharePoint المحدد.
المعلمات الاختيارية:
- معرف الموقع: معرف موقع SharePoint (الافتراضي: "الجذر")
المكتبة الافتراضية للمستندات في الموقع
الحصول على مكتبة المستندات الافتراضية (محرك الأقراص) في موقع SharePoint.
المعلمات الاختيارية:
- معرف الموقع: معرف موقع SharePoint (الافتراضي: "الجذر")
getFolderChildren
تعداد أفضل 20 ملفا ومجلدات (DriveItems) الموجودة في مجلد أصل محدد في مكتبة مستندات (محرك أقراص).
المعلمات المطلوبة:
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
المعلمات الاختيارية:
- parentFolderId: معرف المجلد الأصلي (الافتراضي: 'root').
ابحث عن ملف أو مجلد
البحث عن ملف أو مجلد (DriveItem) يمكن للمستخدم الوصول إليه بواسطة استعلام البحث. عمليات البحث عبر جميع المواقع ومكتبات المستندات التي يمكن للمستخدم الوصول إليها.
المعلمات المطلوبة:
- searchQuery: استعلام البحث (اسم الملف بالكامل أو جزئيا)
getFileOrFolderMetadata (الحصول على بيانات الملف أو المجلد الوصفية)
الحصول على بيانات التعريف لملف أو مجلد (DriveItem) من مكتبة مستندات محددة (محرك أقراص) في SharePoint.
المعلمات المطلوبة:
- fileOrFolderId: معرف الملف أو المجلد (DriveItem)
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
getFileOrFolderMetadataByUrl
يحصل على بيانات وصفية لملف أو مجلد (DriveItem) من رابط مشاركة. يمكن فقط للمستخدمين الذين لديهم أذونات صريحة موجودة للوصول إلى الملف الحصول على بيانات التعريف.
المعلمات المطلوبة:
- fileOrFolderUrl: عنوان URL للملف أو المجلد. لم يتم استرداد عنوان URL لمشاركته مع المستخدم؛ يجب أن يكون لديهم بالفعل وصول صريح.
readSmallTextFile
يقرأ (يحمل) ملف نصي أصغر من 5 ميجابايت من مكتبة مستندات محددة (القرص).
المعلمات المطلوبة:
- معرف الملف: معرف الملف (DriveItem) للقراءة أو التنزيل
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
readSmallBinaryFile
قراءة ملف ثنائي أصغر من 5 ميغابايت من مكتبة مستندات معينة (محرك أقراص). يتم إرجاع محتوى الملف كسلسلة مرمزة ب base64.
المعلمات المطلوبة:
- معرف الملف: معرف الملف (DriveItem) للقراءة أو التنزيل
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
createSmallTextFile
ينشئ أو يرفع ملف نصي أصغر من 5 ميجابايت إلى مكتبة مستندات محددة (القرص).
المعلمات المطلوبة:
- اسم الملف: اسم الملف بما في ذلك الامتداد.
- المحتوى: محتوى النص في الملف.
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
المعلمات الاختيارية:
- parentFolderId: معرف المجلد الأصلي (الافتراضي: 'root').
إنشاء ملف ثنائي صغير
إنشاء ملف ثنائي أصغر من 5 ميغابايت عن طريق ترميز محتواه إلى مكتبة مستندات معينة (محرك أقراص) base64.
المعلمات المطلوبة:
- اسم الملف: اسم الملف بما في ذلك الامتداد.
- base64Content: محتوى ملف ثنائي مرمز كسلسلة base64.
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
المعلمات الاختيارية:
- parentFolderId: معرف المجلد الأصلي (الافتراضي: 'root').
إنشاء مجلد
إنشاء مجلد جديد (DriveItem) داخل مكتبة مستندات محددة (محرك أقراص). إذا كان هناك مجلد بنفس الاسم، يضيف النظام لاحقة رقمية (على سبيل المثال، NewFolder (1)).
المعلمات المطلوبة:
- اسم المجلد: اسم المجلد
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
المعلمات الاختيارية:
- parentFolderId: معرف المجلد الأصلي (الافتراضي: 'root').
إعادة تسمية ملف أو مجلد
إعادة تسمية ملف أو مجلد (DriveItem) داخل مكتبة مستندات محددة (محرك أقراص). يجب أن يتوافق الاسم الجديد مع اصطلاحات التسمية.
المعلمات المطلوبة:
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
- fileOrFolderId: معرف الملف أو المجلد المراد إعادة تسميته
- newFileOrFolderName: الاسم الجديد
المعلمات الاختيارية:
- Etag: ETag للتحكم في التزامن
حذف ملف أو مجلد
حذف ملف أو مجلد (DriveItem) من مكتبة مستندات محددة (محرك أقراص).
المعلمات المطلوبة:
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
- fileOrFolderId: معرف الملف أو المجلد المراد حذفه
المعلمات الاختيارية:
- Etag: ETag للتحكم في التزامن
نقل_الملف_أو_المجلد
نقل ملف أو مجلد (DriveItem) إلى مجلد وجهة. يدعم التنقل عبر مكتبات مستندات مختلفة (محركات أقراص) داخل SharePoint. هذه العملية غير متزامنة. يستخدم checkOperationStatus لمراقبة التقدم.
المعلمات المطلوبة:
- sourcedoclibid: معرف مكتبة المستندات المصدر (محرك الأقراص)
- sourcefileid: معرف الملف أو المجلد المصدر المراد نقله
- destdoclibid: معرف مكتبة المستندات الوجهة (محرك الأقراص)
- destfolderid: معرف المجلد الوجهة (يجب أن يكون موجودا)
المعلمات الاختيارية:
- newfilename: اسم جديد للعنصر المنقول
نسخ_ملف_أو_مجلد
نسخ ملف أو مجلد (DriveItem) إلى مجلد وجهة. يدعم النسخ عبر مكتبات مستندات مختلفة داخل SharePoint. هذه العملية غير متزامنة. يستخدم checkOperationStatus لمراقبة التقدم.
المعلمات المطلوبة:
- sourcedoclibid: معرف مكتبة المستندات المصدر (محرك الأقراص)
- sourcefileid: معرف الملف أو المجلد المصدر المراد نسخه
- destdoclibid: معرف مكتبة المستندات الوجهة (محرك الأقراص)
- destfolderid: معرف المجلد الوجهة (يجب أن يكون موجودا)
المعلمات الاختيارية:
- newfilename: اسم جديد للعنصر المنسخ
checkOperationStatus
يتحقق من حالة عملية غير متزامنة، مثل نسخة أو نقل، باستخدام رمز العملية المميز الذي تم إرجاعه من العملية الأصلية.
المعلمات المطلوبة:
-
رمز العملية: الرمز المميز للعملية الذي تم إرجاعه من عملية غير متزامنة مثل
copyFileOrFolderأوmoveFileOrFolder
تحميل_الملف_من_الرابط
تحميل ملف من عنوان URL SharePoint أو OneDrive إلى مجلد وجهة في مكتبة مستندات (محرك أقراص). يتم نسخ الملف من عنوان URL المصدر، لذلك لا يتم تغيير الملف الأصلي.
المعلمات المطلوبة:
- sourceUrl: عنوان URL المصدر (يجب أن يكون عنوان URL صالحا ل SharePoint أو OneDrive)
-
destinationDocumentLibraryId: معرف مكتبة المستندات الوجهة. استخدم
meلـ OneDrive الخاص بالمستخدم
المعلمات الاختيارية:
-
destinationFolderId: معرف المجلد الوجهة (الافتراضي:
root) - Filename: اسم ملف جديد؛ الإعدادات الافتراضية لاسم الملف الأصلي
مشاركة ملف أو مجلد
إرسال دعوة مشاركة لمنح أذونات القراءة أو الكتابة على ملف أو مجلد (DriveItem) داخل مكتبة مستندات محددة (محرك أقراص).
المعلمات المطلوبة:
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
- fileOrFolderId: معرف الملف أو المجلد المراد مشاركته
- رسائل البريد الإلكتروني للمستلم: صفيف عناوين البريد الإلكتروني للمستلمين
- أدوار: مصفوفة الأدوار: "قراءة" و"كتابة" (دور 'كتابة' يشمل 'قراءة' و'كتابة' معاً)
المعلمات الاختيارية:
- رساله: رسالة مخصصة للبريد الإلكتروني للدعوة (افتراضي: إليك الملف الذي نتعاون فيه.)
- إرسال دعوة: ما إذا كنت تريد إرسال دعوة مشاركة (افتراضي: صحيح)
تعيين تصنيف الحساسية على الملف
تعيين تسمية الحساسية لملف من مكتبة المستندات المحددة (محرك الأقراص).
المعلمات المطلوبة:
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
- معرف الملف: معرف الملف (DriveItem)
- sensitivityLabelId: معرف وصف الحساسية أو سلسلة فارغة لإزالته
المعلمات الاختيارية:
- assignmentMethod: أسلوب التعيين: "قياسي" أو "متميز" أو "تلقائي" أو "قيمة مستقبلية غير معروف" (افتراضي: "متميز")
- نص التبرير: نص التبرير لأغراض مراجعة الحسابات؛ مطلوب عند تخفيض تسمية أو إزالتها (افتراضي: "تم التغيير بواسطة MCPServer")
قوائم القوائم
الحصول على جميع قوائم SharePoint المتوفرة على موقع معين. يستخدم لاكتشاف القوائم الموجودة داخل موقع.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint (التنسيق: 'hostname,siteCollectionId,webId')
إنشاء قائمة
ينشئ قائمة SharePoint جديدة ضمن موقع.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- العرض: عرض اسم القائمة الجديدة
المعلمات الاختيارية:
-
الاعمده: مجموعة من الأعمدة كأزواج قيم المفاتيح:
[{ Key: 'JobTitle', Value: 'text' }]. أنواع صحيحة: نص، نص متعدد الأسطر، رقم، منطقي، توقيت، اختيار، بحث، شخص أو مجموعة، ارتباط تشعبي، عملة، محسوب - قالب: نوع قالب القائمة (افتراضي: 'genericList'). الخيارات: القائمة العامة, مكتبة المستندات, الفعاليات, المهام, الإعلانات, جهات الاتصال, الروابط, الاستبيان, تتبع المشكلات, لوحة النقاش
حذف قائمة
حذف قائمة SharePoint من موقع. حذف حاوية القائمة بأكملها وجميع العناصر الموجودة بداخلها. لا يمكن التراجع عن هذا الإجراء.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف القائمة المراد حذفها
المعلمات الاختيارية:
- Etag: ETag للتحكم في التزامن
إرسال دعوة للقائمة
إرسال دعوة مشاركة لمنح أذونات في قائمة SharePoint.
المعلمات المطلوبة:
- معرف القائمة: معرف قائمة SharePoint المراد مشاركتها
- رسائل البريد الإلكتروني للمستلم: صفيف عناوين البريد الإلكتروني للمستلمين
- دور: الدور: 'قراءة' (عرض فقط)، 'مساهمة' (عرض، إضافة، تحديث، حذف عناصر)، 'تحرير' (تحرير كامل بما في ذلك بنية القائمة)
المعلمات الاختيارية:
- siteUrl: URL الموقع لموقع SharePoint الذي يحتوي على القائمة
- sendEmail: ما إذا كنت تريد إرسال إعلام بالبريد الإلكتروني (افتراضي: صحيح)
listListItems
يسترجع العناصر (الصفوف/السجلات) من قائمة SharePoint معينة.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
getListItem
يحصل على عنصر واحد (صف أو سجل) من SharePoint list بجانب معرفه.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
- Itemid: معرف عنصر القائمة المحدد
إنشاء عنصر قائمة
إنشاء عنصر جديد (صف أو سجل) في SharePoint list.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
-
الحقول: أزواج القيم الرئيسية لقيم الحقول، مثل
[{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. عادة ما يكون حقل 'العنوان' مطلوبا.
تحديثعنصرقائمة
تحديث عنصر موجود (صف أو سجل) في SharePoint list. يتم تحديث الحقول المحددة فقط؛ تحتفظ الحقول المحذفة بقيمها.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
- Itemid: معرف العنصر المراد تحديثه
- الحقول: أزواج قيم المفاتيح من الحقول المراد تحديثها
المعلمات الاختيارية:
- Etag: ETag للتحكم في التزامن
deleteListItem
حذف عنصر (صف أو سجل) من SharePoint list.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
- Itemid: معرف العنصر المراد حذفه
المعلمات الاختيارية:
- Etag: ETag للتحكم في التزامن
قائمة الأعمدة
يجلب جميع الأعمدة من قائمة SharePoint.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
إنشاء عمود
إنشاء عمود جديد في SharePoint list. يدعم العديد من أنواع الأعمدة بما في ذلك النص والرقم والاختيار والتاريخ والوقت والعنوان المنطقي والمستخدم والبحث والمحسوب والمزيد.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
- اسم: اسم العمود الداخلي (معرف برمجي)
- نوع العمود: نوع العمود: نص, ملاحظة, رقم, عدد صحيح, منطقي, تاريخ ووقت, خيار, خيارات متعددة, عملة, استعلام, مستخدم, رابط, محسوب, مصطلح, مصطلحات متعددة, موقع, تحديد الموقع الجغرافي, صورة مصغرة, عداد, محسوب, معرف نوع المحتوى, ملف, مرفق, معرف فريد, خيار النتيجة, حالة الموافقة
المعلمات الاختيارية:
-
خصائص العمود: إعدادات خاصة بالنوع (على سبيل المثال،
{ "maxLength": 255 }للنص،{ "choices": ["A","B","C"] }للاختيار) - وصف: وصف العمود
- اسم_العرض: اسم العرض المعروض في واجهة المستخدم (الافتراضي هو "الاسم")
- مطلوب: جعل العمود مطلوبا (افتراضي: خطأ)
- مخفي: إخفاء العمود من طرق العرض (افتراضي: غير صحيح)
تحديث العمود
تحديث عمود موجود في SharePoint list.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
- معرف العمود: معرف العمود المراد تحديثه
المعلمات الاختيارية:
- نوع العمود: نوع العمود (مطلوب عند توفير 'columnProperties')
- خصائص العمود: الخصائص الخاصة بالنوع المراد تحديثها
- وصف: وصف جديد
- العرض: اسم العرض الجديد
- المخفيه: إخفاء العمود أو إظهاره
- مطلوب: جعل العمود مطلوبا أو اختياريا
حذف عمود
يحذف عمودًا من قائمة SharePoint. تحذير: يزيل هذا الإجراء كافة البيانات المخزنة في هذا العمود لكافة العناصر.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
- معرف العمود: معرف العمود المراد حذفه
الميزات الأساسية
إدارة الموقع
- ابحث عن المواقع حسب الاسم أو استعرض المواقع التي يمكن الوصول إليها.
- الحصول على موقع حسب مسار URL الدقيق.
- سرد المواقع التابعة والمواقع الفرعية.
- التنقل الهرمي الشامل للموقع.
إدارة مكتبة المستندات
- سرد كافة مكتبات المستندات في موقع.
- احصل على مكتبة المستندات الافتراضية.
- تصفح محتويات المجلد (حتى 20 عنصرا).
- إنشاء بنى المجلدات وإدارتها.
عمليات الملفات
- أنشئ ملفات نصية وثنائية (5 ميجابايت أو أقل).
- اقرأ ملفات نصية وثنائية (5 ميجابايت أو أقل).
- حذف الملفات والمجلدات وإعادة تسميتها ونقلها.
- نسخ الملفات والمجلدات عبر مكتبات المستندات.
- تحميل الملفات من عناوين URL SharePoint أو OneDrive.
- ابحث عن الملفات والمجلدات عبر جميع المواقع التي يمكن الوصول إليها.
- الحصول على بيانات تعريف الملف والمجلدات.
عمليات غير متزامنة
- نسخ الملفات والمجلدات ونقلها بشكل غير متزامن عبر مكتبات المستندات.
- تحقق من حالة العمليات غير المتزامنة باستخدام رموز العملية المميزة.
عمليات القائمة
- إنشاء القوائم وقراءتها وحذفها.
- دعم قوالب قوائم متعددة، بما في ذلك عامة ومكتبة مستندات وأحداث ومهام.
- مشاركة القوائم باستخدام الأذونات المستندة إلى الأدوار.
- إدارة عناصر القائمة عن طريق إنشائها وقراءتها وتحديثها وحذفها.
إدارة الأعمدة
- إنشاء أعمدة ذات مجموعة متنوعة من الأنواع، مثل النص والملاحظة والرقم والقيم المنطقية والتاريخ والوقت والاختيار والبحث والمستخدم وعنوان URL والمحسوب والمزيد.
- تحديث خصائص العمود وبيانات التعريف.
- تكوين متطلبات العمود والرؤية.
- تعيين خصائص عمود خاص بالنوع.
المشاركة والأذونات
- مشاركة الملفات والمجلدات والقوائم مع المستخدمين.
- استخدم التحكم في الوصول المستند إلى الدور مع أدوار القراءة والكتابة والمساهمة والتحرير.
- إشعارات عبر البريد الإلكتروني للمشاركة.
- رسائل مخصصة في الدعوات.
الأمان والتوافق
- تطبيق أوصاف الحساسية وإزالتها.
- استخدم أساليب تعيين متعددة، بما في ذلك قياسية وامتيازية و تلقائية.
- دعم تبرير التدقيق.
- استخدم التحكم في التزامن مع eTags.
الملاحظات
- تقتصر عمليات الملفات على الملفات التي تبلغ 5 ميغابايت أو أقل للتحميل والتنزيل.
- عمليات النسخ والنقل غير متزامنة. يستخدم
checkOperationStatusلمراقبة التقدم. - تدعم عمليات النسخ والنقل العمليات عبر المكتبات داخل SharePoint.
- يتطلب
uploadFileFromUrlعنوان URL مصدر SharePoint أو OneDrive صالحا. - توفر eTags التحكم في التزامن للتحديثات والحذف.
- لاحقة رقمية تلقائية لأسماء المجلدات المكررة.
- لا يمكن التراجع عن حذف القائمة.
- يؤدي حذف العمود إلى إزالة كافة البيانات المخزنة في هذا العمود.
- ترجع عمليات البحث أفضل 20 نتيجة بشكل افتراضي.