مشغلات الأحداث

عند إنشاء خطاف ويب، يمكنك اختيار الاشتراك في مشغلات أحداث محددة مرتبطة بعمليات واجهة برمجة التطبيقات التي ستستدعي خطاف ويب الخاص بك وتقديم معلومات الحدث من خلال الحمولة. تدرج الأقسام أدناه مشغلات الأحداث المتاحة وعناوين URIs المرتبطة بها أو غيّر قيم نوع المؤسسة وخدمة المعالم.

ملاحظة:‏

على عكس خطافات الويب لخدمة المعالم والمؤسسة، لا تحتوي خطافات الويب لخدمة المعالجة الجغرافية على مشغلات أحداث محددة من قبل المستخدم. تسلم خطافات الويب الخاصة بخدمة معالجة البيانات الجغرافية الحمولات بمجرد اكتمال وظيفة معالجة البيانات الجغرافية. لمزيد من المعلومات حول الحمولات التي جرى تسليمها لخدمات المعالجة الجغرافية، راجع موضوع الحمولات.

أحداث عنصر المؤسسة

يسرد الجدول التالي مشغلات الأحداث لعناصر مؤسستك، والتي تتضمن خرائط الويب وتطبيقات الويب والطبقات والحزم وملفات PDF:

مُشغل الحدث	URI
كل أحداث المشغلات لكل العناصر	/items
تمت إضافة عنصر العضو إلى البوابة	/items/add
تم حذف أي عنصر	/items/delete
تم تحديث أي عنصر	/items/update
يتم نقل أي عنصر أو تغيير ملكيته	/items/move
تم نشر أي عنصر	/items/publish
تمت مشاركة أي عنصر	/items/share
تم إلغاء مشاركة أي عنصر	/items/unshare
أُعيد تعيين ملكية أي عنصر	/items/reassign
يُضاف تعليق إلى أي عنصر	/items/addComment
يتم حذف تعليق من أي عنصر	/items/deleteComment
يتم تحديث تعليق على أي عنصر	/items/updateComment
كل أحداث المشغلات لعنصر مخصوص	/items/<itemID>
تم حذف عنصر محدد	/items/<itemID>/delete
تم تحديث خصائص عنصر محدد ملاحظة:‏ تختلف خصائص العنصر التي يمكن تحديثها بين أنماط العنصر، وهناك إجراءات فريدة تشغل عملية Update. على سبيل المثال، إذا كان العنصر خريطة ويب، فإن تحديث علامة التبويب أو تكوين القائمة المنبثقة أو تغيير خريطة الأساس كلها تعمل على تحديث الأحداث التي سوف تشغِّل خطاف الويب الخاص بك.	/items/<itemID>/update
تم تغيير ملكية عنصر محدد أو نقل العنصر	/items/<itemID>/move
تم نشر عنصر محدد	/items/<itemID>/publish
تمت مشاركة عنصر محدد	/items/<itemID>/share
تم إلغاء مشاركة عنصر محدد	/items/<itemID>/unshare
أُعيد تعيين ملكية عنصر محدد	/items/<itemID>/reassign
يُضاف تعليق إلى عنصر محدد	/items/<itemId>/addComment
يتم حذف تعليق من عنصر محدد	/items/<itemId>/deleteComment
يتم تحديث تعليق على عنصر محدد	/items/<itemId>/updateComment

خصائص مشغل حدث العنصر

تقوم بعض مشغلات الحدث لعناصر المؤسسة بإرجاع خصائص إضافية في حمولاتها. توضح الأقسام أدناه خصائص الحمولة الإضافية لهذه المشغلات.

تمت مشاركة عنصر محدد

تحتوي خطافات الويب التي تشترك في مشغل حدث /items/<itemID>/share على الخاصية sharedToGroups المضمنة في حمولتها. تحدد خاصية sharedToGroups كيفية مشاركة عنصر. إذا تمت مشاركة العنصر مع مجموعة، فإن كائن properties JSON يتضمن المعرف لكل مجموعة تمت مشاركة العنصر معها. إذا تمت مشاركة العنصر مع المؤسسة ككل، فإن الكائن يشمل Organization. إذا تمت مشاركة العنصر بشكل علني، فإن الكائن يتضمن Everyone. يوضح المثال أدناه مشاركة عنصر لمجموعات محددة، بالإضافة إلى مشاركة عنصر بشكل علني ولمجموعات محددة.

أمثلة

//groupIDs
"properties": {
  "sharedToGroups": [
    "ecd6646698b24180904e4888d5eaede3",
    "2dff15c514ad4f04b291e304e24a524b"
  ]
}

//Everyone and groupIDs
"properties": {
  "sharedToGroups": [
    "Everyone",
    "4adc30bb03054812a846fa592de105de",
    "a4e6e37e2f7d4bb5b64d587c91d39a2c"
  ]
}

أُعيد تعيين ملكية أي عنصر

تحتوي خطافات الويب التي تشترك في مشغل حدث /items/reassign على الخاصية reassignedTo المضمنة في حمولتها. تحدد الخاصية reassignedTo المستخدم الجديد الذي تمت إعادة تعيين عنصر أو مجموعة إليه، مع إرجاع اسم المستخدم للمالك الجديد في كائن properties JSON.

مثال

"properties": {
  "reassignedTo": ["newOwner"]
}

تم إلغاء مشاركة عنصر محدد

تحتوي خطافات الويب التي تشترك في مشغل حدث /items/<itemID>/unshare على الخاصية unsharedFromGroups المضمنة في حمولتها. تحدد الخاصية unsharedFromGroups كيفية إلغاء مشاركة عنصر ما. إذا تم إلغاء مشاركة العنصر من مجموعة، فسيتضمن كائن properties JSON معرفات لكل مجموعة تم إلغاء مشاركة العنصر منها. إذ تم إلغاء مشاركة العنصر من مؤسسة ككل، فسيتضمن الكائن Organization. إذ تم إلغاء مشاركة العنصر من الجميع، فسيتضمن الكائن Everyone. توضح خصائص المثال أدناه عدم مشاركة عنصر من الجمهور، وكذلك عدم مشاركة عنصر من مجموعة معينة.

أمثلة

//Everyone
"properties": {
  "unsharedFromGroups": ["Everyone"]
}

//groupID
"properties": {
  "unsharedFromGroups": [
    "4adc30bb03054812a846fa592de105de"
  ]
}

أُعيد تعيين ملكية عنصر محدد

تحتوي خطافات الويب التي تشترك في مشغل حدث /items/<itemID>/reassign على الخاصية reassignedTo المضمنة في حمولتها. تحدد الخاصية reassignedTo المستخدم الجديد الذي تم تعيين عنصر أو مجموعة إليه، مع إرجاع اسم المستخدم للمالك الجديد في كائن properties JSON.

مثال

"properties": {
  "reassignedTo": ["newOwner"]
}

أحداث عنصر المجموعة

يسرد الجدول التالي مشغلات الحدث لمجموعات مؤسستك:

مُشغل الحدث	URI
كل أحداث المشغلات لكل المجموعات	/groups
تمت إضافة مجموعة	/groups/add
تم تحديث أي مجموعة	/groups/update
تم حذف أي مجموعة	/groups/delete
تم تمكين الحماية ضد الحذف لأي مجموعة	/groups/protect
تم تعطيل الحماية ضد الحذف لأي مجموعة	/groups/unprotect
تمت دعوة مستخدم إلى أي مجموعة	/groups/invite
تمت إضافة مستخدم إلى أي مجموعة	/groups/addUsers
تمت إزالة مستخدم إلى أي مجموعة	/groups/removeUsers
تم تحديث دور مستخدم في أي مجموعة	/groups/updateUsers
أُعيد تعيين ملكية أي مجموعة	/groups/reassign
تمت مشاركة عنصر مع أي مجموعة	/groups/itemShare
تم إلغاء مشاركة عنصر مع أي مجموعة	/groups/itemUnshare
يقدم المستخدم طلبًا للانضمام إلى أي مجموعة	/groups/requestJoin
كل أحداث المشغلات لمجموعة محددة	/groups/<groupID>
تم تحديث مجموعة معينة ملاحظة:‏ أي تغييرات عامة في إعدادات المجموعة تشكل تحديثًا. على سبيل المثال، تغيير الوصول إلى المجموعة سوف يستحث حدثا من أحداث التحديث.	/groups/<groupID>/update
تم حذف مجموعة معينة	/groups/<groupID>/delete
تم تمكين الحماية ضد الحذف لمجموعة معينة	/groups/<groupID>/protect
تم تعطيل الحماية ضد الحذف لمجموعة معينة	/groups/<groupID>/unprotect
تمت دعوة مستخدم إلى مجموعة معينة	/groups/<groupID>/invite
تمت إضافة مستخدم إلى مجموعة معينة	/groups/<groupID>/addUsers
تمت إزالة مستخدم من مجموعة معينة	/groups/<groupID>/removeUsers
تم تحديث دور مستخدم في مجموعة معينة	/groups/<groupID>/updateUsers
أُعيد تعيين ملكية مجموعة معينة	/groups/<groupID>/reassign
عنصر مُشارك مع مجموعة	/groups/<groupID>/itemShare
تم إلغاء مشاركة عنصر من مجموعة معينة	/groups/<groupID>/itemUnshare
يطلب المستخدم الانضمام إلى مجموعة محددة	/groups/<groupId>/requestJoin

خصائص مشغل حدث المجموعة

تقوم بعض مشغلات الحدث لمجموعات المؤسسة بإرجاع خصائص إضافية في حمولتها. توضح الأقسام أدناه خصائص الحمولة الإضافية لهذه المشغلات.

تمت دعوة مستخدم إلى مجموعة معينة

تحتوي خطافات الويب التي تشترك في مشغل حدث /groups/<groupID>/invite على الخاصية invitedUserNames المضمنة في حمولتها. تحدد خاصية invitedUserNames أسماء المستخدمين المدعوين إلى مجموعة، مع إرجاع قائمة بأسماء المستخدمين في كائن properties JSON.

مثال

"properties": {
  "invitedUserNames": [
    "u1TestUser",
    "u2TestUser"
  ]
}

تمت إضافة مستخدم إلى مجموعة معينة

تحتوي خطافات الويب التي تشترك في مشغل حدث /groups/<groupID>/addUsers على الخاصية addedUserNames المضمنة في حمولتها. تحدد خاصية addedUserNames أسماء المستخدمين المضافين إلى مجموعة، مع إرجاع قائمة بأسماء المستخدمين في كائن properties JSON.

مثال

"properties": {
  "addedUserNames": [
    "u1TestUser",
    "u2TestUser"
  ]
}

تمت إزالة مستخدم من مجموعة معينة

تحتوي خطافات الويب التي تشترك في /groups/<groupID>/removeUsers على خاصية removeUserNames المضمنة في حمولتها. تحدد خاصية removeUserNames أسماء المستخدمين الذين تمت إزالتهم من مجموعة، مع إرجاع قائمة بأسماء المستخدمين في كائن properties JSON.

مثال

"properties": {
  "removedUserNames": [
    "u1TestUser",
    "u2TestUser"
  ]
}

تم تحديث دور مستخدم في مجموعة معينة

تحتوي خطافات الويب التي تشترك في /groups/<groupID>/updateUsers على خاصية updateUserNames المضمنة في حمولتها. تحدد خاصية updateUserNames أسماء المستخدمين الذين تم تحديث أدوار مجموعتهم، مع إرجاع قائمة بأسماء المستخدمين في كائن properties JSON.

مثال

"properties": {
  "updatedUserNames": [
    "u1TestUser",
    "u2TestUser"
  ]
}

عنصر مُشارك مع مجموعة

تحتوي خطافات الويب التي تشترك في /groups/<groupID>/itemShare على خاصية sharedItems المضمنة في حمولتها. تحدد خاصية sharedItems itemID ونوع العنصر الذي تمت مشاركته مع مجموعة، مع إرجاع هذه المعلومات في كائن properties JSON.

مثال

"properties": {
  "sharedItems": [
    {
      "itemId": "6cd80cb32d4a4b4d858a020e57fba7b1",
      "itemType": "Map Package"
    }
  ]
}

تم إلغاء مشاركة عنصر من مجموعة معينة

تحتوي خطافات الويب التي تشترك في /groups/<groupID>/itemUnshare على خاصية unsharedItems المضمنة في حمولتها. تحدد خاصية unsharedItems itemID ونوع العنصر الذي تمت مشاركته من مجموعة، مع إرجاع هذه المعلومات في كائن properties JSON.

مثال

"properties": {
  "unsharedItems": [
    {
      "itemId": "7dd95fadaec84859ab8ed1059e675e0c",
      "itemType": "Image"
    }
  ]
}

أحداث مستخدم المؤسسة

يسرد الجدول التالي مشغلات الحدث لمستخدمي مؤسستك:

مُشغل الحدث	URI
جميع أحداث المشغل لكل المستخدمين في البوابة	/users
تمت إضافة مستخدم إلى المؤسسة	/users/add
تم تسجيل دخول أي مستخدم إلى البوابة	/users/signin
تم تسجيل خروج أي مستخدم إلى البوابة	/users/signout
تم حذف أي مستخدم	/users/delete
تم تحديث ملف تعريف أي مستخدم ملاحظة:‏ يتم تشغيل حدث التحديث في أي وقت يقع فيه تغيير لملف المستخدم التعريفي. ومع ذلك فإن التغييرات التي حدثت لدور المستخدم أو نمطه أو رخصته لا تُعتبر تحديثًا لملف المستخدم التعريفي.	/users/update
تم تعطيل حساب أي مستخدم	/users/disable
تم تمكين حساب أي مستخدم	/users/enable
تم تعيين دور جديد لأي مستخدم	/users/updateUserRole
تم تعيين نوع مستخدم جديد لأي مستخدم	/users/updateUserLicenseType
تم تمكين قائمة من حسابات المستخدم	/users/bulkEnable
تم تعطيل قائمة من حسابات المستخدم	/users/bulkDisable
كل أحداث المشغلات لمستخدم مخصوص	/users/<username>
تم تسجيل دخول مستخدم محدد إلى البوابة	/users/<username>/signIn
تم تسجيل خروج مستخدم محدد من البوابة الإلكترونية	/users/<username>/signOut
تم حذف مستخدم معين	/users/<username>/delete
تم تحديث ملف تعريف مستخدم معين ملاحظة:‏ يتم تشغيل حدث التحديث في أي وقت يقع فيه تغيير لملف المستخدم التعريفي. ومع ذلك فإن التغييرات التي حدثت لدور المستخدم أو نمطه أو رخصته لا تُعتبر تحديثًا لملف المستخدم التعريفي.	/users/<username>/update
تم تعطيل حساب مستخدم معين	/users/<username>/disable
تم تمكين حساب مستخدم معين	/users/<username>/enable
تم تعيين دور جديد لمستخدم معين	/users/<username>/updateUserRole
تم تعيين نوع مستخدم جديد لمستخدم معين	/users/<username>/updateUserLicenseType

خصائص مشغل حدث المستخدم

تقوم بعض مشغلات الحدث لمستخدمي المؤسسة بإرجاع خصائص إضافية في حمولتها. توضح الأقسام أدناه خصائص الحمولة الإضافية لهذه المشغلات.

تم تعيين دور جديد لمستخدم معين

تحتوي خطافات الويب التي تشترك في /users/<username>/updateUserRole على خاصية userRoleUpdatedTo المضمنة في حمولتها. تحدد الخاصية userRoleUpdatedTo الدور الجديد المخصص للمستخدم، مع إرجاع الدور الجديد في كائن properties JSON.

"properties": {
  "userRoleUpdatedTo": ["New role"]
}

تم تعيين نوع مستخدم جديد لمستخدم معين

تحتوي خطافات الويب التي تشترك في /users/<username>/updateUserLicenseType على خاصية userLicenseTypeUpdatedTo المضمنة في حمولتها. تحدد خاصية userLicenseTypeUpdatedTo نوع المستخدم الجديد الذي تم تعيينه لمستخدم، مع إرجاع الدور الجديد في كائن properties JSON.

"properties": {
  "userLicenseTypeUpdatedTo": ["Editor"]
}

أحداث دور المؤسسة

يسرد الجدول التالي مشغلات الحدث لأدوار مستخدمي مؤسستك:

مُشغل الحدث	URI
جميع أحداث المشغل لكل الأدوار في البوابة	/roles
تم إنشاء دور جديد.	/roles/add
تم تحديث دور موجود ملاحظة:‏ يتم تشغيل حدث تحديث في أي وقت يقع فيه تغيير لأدوار المؤسسة.	/roles/update
تم حذف دور موجود	/roles/delete

خصائص مشغل حدث الدور

تقوم بعض مشغلات الحدث لأدوار المؤسسة بإرجاع خصائص إضافية في حمولتها. يوضح القسم أدناه خصائص الحمولة الإضافية لهذه المشغلات.

تم إنشاء دور جديد.

تحتوي خطافات الويب التي تشترك في مشغل حدث /roles/add على الخاصية name المضمنة في حمولتها. تحدد خاصية name اسم الدور الذي تم إنشاؤه، مع إرجاع اسم الدور في كائن properties JSON.

مثال

"properties": {
  "name": ["New role"]
}

أحداث خدمة المعالم

يسرد الجدول التالي مشغلات الحدث لخطافات ويب خدمة المعالم:

مُشغل الحدث	قيمة
تم تشغيل أي حدث	*
تم إنشاء معلم جديد	FeaturesCreated
تم تحديث المعلم	FeaturesUpdated
تم حذف المعلم	FeaturesDeleted
تم تحرير المعلم (على سبيل المثال، الإدراج أو التحديث أو الحذف)	FeaturesEdited
يُضاف مرفق جديد إلى المعالم	AttachmentsCreated
تم تحديث مرفق معالم	AttachmentsUpdated
تم حذف مرفق معالم	AttachmentsDeleted
تم تغيير مخطط طبقة معالم	LayerSchemaChanged
تم تغيير تعريف طبقة معالم	LayerDefinitionChanged
تم تغيير تعريف خدمة معالم	FeatureServiceDefinitionChanged
تم إجراء عملية النشر على خدمة المعالم. ملاحظة:‏ لجدولة خطاف ويب باستخدام مُشغل الحدث هذا، يجب تمكين إمكانية إدارة الإصدار في خدمة المعالم. لمزيد من المعلومات، راجع وثائق إنشاء خطافات ويب.	FeaturesPosted