عند إنشاء خطاف ويب، يمكنك اختيار الاشتراك في مشغلات أحداث محددة مرتبطة بعمليات واجهة برمجة التطبيقات التي ستستدعي خطاف ويب الخاص بك وتقديم معلومات الحدث من خلال الحمولة. تدرج الأقسام أدناه مشغلات الأحداث المتاحة وعناوين 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 |