Skip To Content

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

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

ملاحظة:‏

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

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

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

مُشغل الحدثURI

كل أحداث المشغلات لكل العناصر

/items

تمت إضافة عنصر العضو إلى البوابة

/items/add

تم حذف أي عنصر

/items/delete

تم تحديث أي عنصر

/items/update

يتم نقل أي عنصر أو تغيير ملكيته

/items/move

تم نشر أي عنصر

/items/publish

تمت مشاركة أي عنصر

/items/share

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

/items/unshare

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

/items/reassign

كل أحداث المشغلات لعنصر مخصوص

/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>/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/<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>/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