إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
Important
- هذه ميزة إصدار أولي.
- الهدف من ميزات المعاينة ليس الاستخدام في الإنتاج وقد يكون لها دالات مقيدة. تخضع هذه الميزات لشروط الاستخدام التكميلية، وهي تتوفر قبل الإصدار الرسمي حتى يتمكن العملاء من الوصول المبكر وتقديم الملاحظات.
نظرة عامة
| مُعرف خادم | اسم العرض | الوصف |
|---|---|---|
mcp_SharePointRemoteServer |
العمل على IQ SharePoint | خادم MCP لعمليات SharePoint. استخدم هذا الخادم لإدارة المواقع والقوائم وعناصر القوائم والأعمدة ومكتبات المستندات والملفات والمجلدات ومشاركة الملفات. تقتصر عمليات الملفات على ≤5 ميغابايت. |
ملاحظة
- تظل الاتصالات الموجودة التي تستخدم الإصدارات السابقة من خوادم Microsoft MCP، مثل خادم Microsoft Teams MCP، مدعومة.
- بالنسبة لجميع الاتصالات الجديدة، استخدم أحدث خوادم Work IQ MCP، مثل Work IQ Teams.
الأدوات المتوفرة
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: معرف المجلد الأصل (الافتراضي: "الجذر")
ابحث عن ملف أو مجلد
البحث عن ملف أو مجلد (DriveItem) يمكن للمستخدم الوصول إليه بواسطة استعلام البحث. عمليات البحث عبر جميع المواقع ومكتبات المستندات التي يمكن للمستخدم الوصول إليها.
المعلمات المطلوبة:
- searchQuery: استعلام البحث (اسم الملف بالكامل أو جزئيا)
getFileOrFolderMetadata (الحصول على بيانات الملف أو المجلد الوصفية)
احصل على بيانات التعريف لملف أو مجلد (DriveItem) من مكتبة مستندات محددة (محرك أقراص) في SharePoint.
المعلمات المطلوبة:
- fileOrFolderId: معرف الملف أو المجلد (DriveItem)
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
getFileOrFolderMetadataByUrl
احصل على بيانات التعريف لملف أو مجلد (DriveItem) من عنوان URL للمشاركة. سيسمح فقط للمستخدمين الذين لديهم أذونات صريحة موجودة للوصول إلى الملف بالحصول على بيانات التعريف.
المعلمات المطلوبة:
- fileOrFolderUrl: عنوان URL للملف أو المجلد. لن يتم استرداد عنوان URL لمشاركته مع المستخدم؛ يجب أن يكون لديهم بالفعل وصول صريح
readSmallTextFile
قراءة (تنزيل) ملف نصي بحجم أقل من 5 ميغابايت من مكتبة مستندات معينة (محرك أقراص).
المعلمات المطلوبة:
- معرف الملف: معرف الملف (DriveItem) للقراءة/التنزيل
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
readSmallBinaryFile
اقرأ ملفا ثنائيا بحجم أقل من 5 ميغابايت من مكتبة مستندات معينة (محرك أقراص). يتم إرجاع محتوى الملف كسلسلة مرمزة ب base64.
المعلمات المطلوبة:
- معرف الملف: معرف الملف (DriveItem) للقراءة/التنزيل
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
createSmallTextFile
إنشاء ملف نصي بحجم أقل من 5 ميغابايت أو تحميله إلى مكتبة مستندات معينة (محرك أقراص).
المعلمات المطلوبة:
- Filename: اسم الملف بما في ذلك الملحق
- نص المحتوى: محتوى نصي للملف
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
المعلمات الاختيارية:
- parentFolderId: معرف المجلد الأصل (الافتراضي: "الجذر")
إنشاء ملف ثنائي صغير
إنشاء ملف ثنائي بحجم أقل من 5 ميغابايت عن طريق ترميز محتواه إلى مكتبة مستندات معينة (محرك أقراص) base64.
المعلمات المطلوبة:
- Filename: اسم الملف بما في ذلك الملحق
- base64Content: محتوى ملف ثنائي مرمز كسلسلة base64
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
المعلمات الاختيارية:
- parentFolderId: معرف المجلد الأصل (الافتراضي: "الجذر")
إنشاء مجلد
إنشاء مجلد جديد (DriveItem) داخل مكتبة مستندات محددة (محرك أقراص). إذا كان هناك مجلد بالاسم نفسه، تتم إضافة لاحقة رقمية (على سبيل المثال، NewFolder (1)).
المعلمات المطلوبة:
- اسم المجلد: اسم المجلد
- documentLibraryId: معرف مكتبة المستندات (محرك الأقراص)
المعلمات الاختيارية:
- parentFolderId: معرف المجلد الأصل (الافتراضي: "الجذر")
إعادة تسمية ملف أو مجلد
أعد تسمية ملف أو مجلد (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: معرف مكتبة المستندات الوجهة. استخدام "أنا" ل OneDrive الخاص بالمستخدم
المعلمات الاختيارية:
- destinationFolderId: معرف المجلد الوجهة (الافتراضي: "الجذر")
- 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 بواسطة معرفه.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
- Itemid: معرف عنصر القائمة المحدد
إنشاء عنصر قائمة
إنشاء عنصر جديد (صف/سجل) في قائمة SharePoint.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
-
الحقول: أزواج قيم المفاتيح لقيم الحقول:
[{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. عادة ما يكون حقل "العنوان" مطلوبا
تحديثعنصرقائمة
تحديث عنصر موجود (صف/سجل) في قائمة SharePoint. يتم تحديث الحقول المحددة فقط؛ تحتفظ الحقول المحذفة بقيمها.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
- Itemid: معرف العنصر المراد تحديثه
- الحقول: أزواج قيم المفاتيح من الحقول المراد تحديثها
المعلمات الاختيارية:
- Etag: ETag للتحكم في التزامن
deleteListItem
حذف عنصر (صف/سجل) من قائمة SharePoint.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
- Itemid: معرف العنصر المراد حذفه
المعلمات الاختيارية:
- Etag: ETag للتحكم في التزامن
قائمة الأعمدة
احصل على كل الأعمدة من قائمة SharePoint.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
إنشاء عمود
إنشاء عمود جديد في قائمة SharePoint. يدعم العديد من أنواع الأعمدة بما في ذلك النص والرقم والاختيار والتاريخ والوقت والعنوان المنطقي والمستخدم والبحث والمحسوب والمزيد.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
- اسم: اسم العمود الداخلي (معرف برمجي)
- نوع العمود: نوع العمود: نص, ملاحظة, رقم, عدد صحيح, منطقي, تاريخ ووقت, خيار, خيارات متعددة, عملة, استعلام, مستخدم, رابط, محسوب, مصطلح, مصطلحات متعددة, موقع, تحديد الموقع الجغرافي, صورة مصغرة, عداد, محسوب, معرف نوع المحتوى, ملف, مرفق, معرف فريد, خيار النتيجة, حالة الموافقة
المعلمات الاختيارية:
-
خصائص العمود: إعدادات خاصة بالنوع (على سبيل المثال،
{ "maxLength": 255 }للنص،{ "choices": ["A","B","C"] }للاختيار) - وصف: وصف العمود
- اسم_العرض: اسم العرض المعروض في واجهة المستخدم (الافتراضي هو "الاسم")
- مطلوب: جعل العمود مطلوبا (افتراضي: خطأ)
- مخفي: إخفاء العمود من طرق العرض (افتراضي: غير صحيح)
تحديث العمود
تحديث عمود موجود في قائمة SharePoint.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
- معرف العمود: معرف العمود المراد تحديثه
المعلمات الاختيارية:
- نوع العمود: نوع العمود (مطلوب عند توفير 'columnProperties')
- خصائص العمود: الخصائص الخاصة بالنوع المراد تحديثها
- وصف: وصف جديد
- العرض: اسم العرض الجديد
- المخفيه: إخفاء العمود أو إظهاره
- مطلوب: جعل العمود مطلوبا أو اختياريا
حذف عمود
حذف عمود من قائمة SharePoint. تحذير: إزالة كافة البيانات المخزنة في هذا العمود لكافة العناصر.
المعلمات المطلوبة:
- معرف الموقع: معرف موقع SharePoint
- معرف القائمة: معرف قائمة SharePoint
- معرف العمود: معرف العمود المراد حذفه
الميزات الرئيسية
إدارة الموقع
- البحث عن المواقع حسب الاسم أو استعراض المواقع التي يمكن الوصول إليها
- الحصول على الموقع حسب مسار URL الدقيق
- قائمة المواقع التابعة والمواقع الفرعية
- التنقل الهرمي الشامل للموقع
إدارة مكتبة المستندات
- سرد كافة مكتبات المستندات في موقع
- الحصول على مكتبة المستندات الافتراضية
- استعراض محتويات المجلد (حتى 20 عنصرا)
- إنشاء هياكل المجلدات وإدارتها
عمليات الملفات
- إنشاء الملفات النصية والثنائية (≤5 ميغابايت)
- قراءة الملفات النصية والملفات الثنائية (≤5 ميغابايت)
- حذف الملفات والمجلدات وإعادة تسميتها ونقلها
- نسخ الملفات والمجلدات عبر مكتبات المستندات
- تحميل الملفات من عناوين URL ل SharePoint أو OneDrive
- البحث عن الملفات والمجلدات عبر جميع المواقع التي يمكن الوصول إليها
- الحصول على بيانات تعريف الملفات والمجلدات
عمليات غير متزامنة
- نسخ الملفات والمجلدات ونقلها بشكل غير متزامن عبر مكتبات المستندات
- التحقق من حالة العمليات غير المتزامنة باستخدام رموز العملية المميزة
عمليات القائمة
- إنشاء القوائم وقراءتها وحذفها
- دعم قوالب قوائم متعددة (عامة، مكتبة مستندات، أحداث، مهام)
- مشاركة القوائم مع إذونات حسب الأدوار
- إدارة عناصر القائمة (إنشاء، قراءة، تحديث، حذف)
إدارة الأعمدة
- إنشاء أعمدة ذات مجموعة متنوعة من الأنواع (النص والملاحظة والرقم والقيمة والتاريخ والوقت والاختيار والبحث والمستخدم وعنوان URL والمحسوب والمزيد)
- تحديث خصائص العمود وبيانات التعريف
- تكوين متطلبات العمود والعرض
- خصائص العمود الخاصة بالنوع
المشاركة والأذونات
- مشاركة الملفات والمجلدات والقوائم مع المستخدمين
- التحكم في الوصول استنادا إلى الدور (القراءة والكتابة والمساهمة والتحرير)
- تنبيهات البريد الإلكتروني للمشاركة
- الرسائل المخصصة في الدعوات
الأمان والتوافق
- تطبيق أوصاف الحساسية وإزالتها
- أساليب تعيين متعددة (قياسية، مميزة، تلقائية)
- دعم مبررات التدقيق
- التحكم في التزامن باستخدام eTags
Notes
- تقتصر عمليات الملفات على ≤5 ميغابايت للتحميل والتنزيل
- عمليات النسخ والتحريك غير متزامنة؛ استخدام
checkOperationStatusلمراقبة التقدم - تدعم عمليات النسخ والنقل عمليات المكتبة المشتركة داخل SharePoint
-
uploadFileFromUrlيتطلب عنوان URL مصدر SharePoint أو OneDrive صالحا - توفر eTags التحكم في التزامن للتحديثات والحذف
- لاحقة رقمية تلقائية لأسماء المجلدات المكررة
- لا يمكن التراجع عن حذف القائمة
- يؤدي حذف العمود إلى إزالة كافة البيانات المخزنة في هذا العمود
- ترجع عمليات البحث أفضل 20 نتيجة بشكل افتراضي
ملاحظة
تخضع أسماء أدوات MCP والمعلمات للتغيير ويجب تجنب التبعيات ذات التعليمات البرمجية المضمنة. سيتم الاحتفاظ بدعم السيناريو.