مشاركة عبر

أحداث Microsoft Sharepoint

  • مقالة

توفر هذه المقالة خصائص ومخطط أحداث Microsoft Sharepoint التي يتم نشرها بواسطة Microsoft Graph API. للحصول على مقدمة حول مخططات الأحداث، راجع مخطط CloudEvents.

أنواع الأحداث المتاحة

يتم تشغيل هذه الأحداث عند تحديث listItem عن طريق التشغيل عبر هذه الموارد باستخدام Microsoft Graph API.

اسم الحدث ‏‏الوصف
Microsoft.Graph.ListUpdated يتم تشغيله عند تحديث قائمة في Microsoft Sharepoint.

مثال حدث

عند تشغيل حدث ما، ترسل خدمة Event Grid بيانات عن هذا الحدث إلى وجهات الاشتراك. يحتوي هذا القسم على مثال لما ستبدو عليه هذه البيانات لكل حدث من أحداث Microsoft Sharepoint.

حدث Microsoft.Graph.ListUpdated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ListUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "listItem/<listItem-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>",
    "clientState": "<user-provided secret>",
    "expirationDateTime": "2023-10-05T18:11:08.587Z",
    "resource": "<guid>",
    "siteUrl": "<relative path>",
    "webId": "<guid>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.listItem"
    },    
  }
}

خصائص الحدث

ويحتوي الحدث على بيانات المستوى الأعلى التالية:

الخاصية نوع الوصف
source سلسلة مصدر حدث المستأجر. هذا الحقل غير قابل للكتابة. توفر واجهة برمجة تطبيقات Microsoft Graph هذه القيمة.
subject سلسلة مسار يحدده الناشر لموضوع الحدث.
type سلسلة أحد أنواع الأحداث لمصدر هذا الحدث.
time سلسلة وقت إنشاء الحدث بناءً على وقت التوقيت العالمي المنسق للمزود
id سلسلة المعرف الفريد للحدث.
data كائن حمولة الحدث التي توفر البيانات حول تغيير حالة المورد.
specversion سلسلة إصدار مواصفات مخطط CloudEvents.

كائن البيانات له الخصائص التالية:

الخاصية نوع الوصف
changeType سلسلة نوع حالة الموارد تتغير.
resource سلسلة محدد الموارد الذي أثير من أجله الحدث.
tenantId سلسلة معرف المؤسسة حيث يتم الاحتفاظ بالقائمة.
clientState سلسلة بيانات سرية قدمها المستخدم في وقت إنشاء اشتراك Microsoft Azure Active Directory Graph API.
@odata.type سلسلة نوع تغيير واجهة برمجة التطبيقات Microsoft Azure Active Directory Graph.
@odata.id سلسلة محدد موارد Microsoft Azure Active Directory Graph API الذي أثير الحدث من أجله.
id سلسلة محدد الموارد الذي أثير من أجله الحدث.
subscriptionExpirationDateTime سلسلة الوقت في RFC 3339 تنسيق الذي ينتهي عنده الاشتراك في Microsoft Azure Active Directory Graph API.
subscriptionId سلسلة معرف اشتراكMicrosoft Azure Active Directory Graph API.
tenantId سلسلة معرف مستأجر Microsoft Entra.

الخطوات التالية