خُطاف الويب (Webhooks)

تعد "خطافات الويب" طريقة مدعومة على نطاق واسع للسماح لتطبيقات متعددة بالتفاعل مع بعضها البعض، باستخدام طلبات HTTP POST لتمرير الاستدعاءات بينها. لمزيد من المعلومات، راجع صفحة ويكيبيديا على خطافات الويب. تشمل الاستخدامات العامة لخطافات الويب إرسال إشعارات عبر البريد الإلكتروني أو الرسائل القصيرة، ونشر الرسائل على وسائل التواصل الاجتماعي، وكتابة السجلات تلقائيًا في جدول البيانات، وتحديث قواعد البيانات المؤسسية.

في ArcGIS Survey123، يمكن إعداد خطافات الويب وتنشيطها عند إرسال إجابة استطلاع. على سبيل المثال، بعد الإرسال الناجح للمعلومات إلى طبقة المعالم، يمكن استدعاء خطاف الويب وتشغيل إجراء آخر، مثل إرسال إخطار عبر البريد الإلكتروني، وإلحاق محتوى الاستطلاع بجدول بيانات، وإرسال تنبيه.

قد يكون لدى مساحة العمل لديك موفر خطاف الويب الخاص بها، ولكن تتوفر مجموعة من خدمات سير العمل الخارجية، مثل Microsoft Power Automate و Make (Integromat سابقًا) و Zapier و tray.io. يمكن استخدام كل منها لتضمين Survey123 كمشغل لعملية مؤتمتة. على وجه الخصوص، Microsoft Power Automate و Make بكل منهما موصل Survey123 مدمج، يتيح لك دمج Survey123 في سير عمل خطاف الويب بالحد الأدنى من الصعوبة، ودون الحاجة لتكوين خطاف الويب في موقع ويب Survey123 أو لإدخال عنوان URL للحمولة.

تنبيه:

عند إنشاء خطاف ويب أو تعديله للاستطلاع، لا بد أن يكون الاستطلاع محدثًا في تطبيق Survey123 الميداني ليتم تفعيل التغيرات.

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

في نهاية هذا الموضوع، يتم سرد جميع الخصائص المتاحة في حمولة حدث خطاف الويب كمرجع.

تعيين خطاف ويب في Make

Make (Platform سابقًا) هو منصة أتمتة على الإنترنت. التسجيل بحساب مجاني للبدء. يتضمن Make قوالب لاستخدامها كنقطة بداية لتضمين المرفقات في إشعارات البريد الإلكتروني، مما يضيف السجلات إلى جداول البيانات وإنشاء عناصر التقويم.

1. انتقل إلى https://www.make.com/ وسجل الدخول.
2. في صفحة السيناريوهات، انقر فوق زر إنشاء سيناريو جديد.
3. انقر على رمز الوحدة النمطية في منتصف الشاشة. ابحث عن Survey123 وحدده.

   

4. اختر وحدة تشغيل مشاهدة الاستطلاع.

   هذه الوحدة مصممة لتشغيل السيناريو في كل مرة تُقدم استجابة استطلاع.

   تظهر نافذة منبثقة لمساعدتك في تكوين الوحدة النمطية مشاهدة الاستطلاع.

   تلميح:

   يمكن استخدام وحدة إنشاء تقرير لإنشاء تقرير لإجابة استطلاع.

5. انقر على إضافة وأدخل اسمًا لخطاف الويب الخاص بك.

   يجب أن يكون هذا الاسم فريدًا للاستطلاع الذي تكوّن لأجله خطاف الويب.

6. إذا كانت هذه هي المرة الأولى لاستخدام وحدة Survey123في Make، فقم بإعداد اتصال بمؤسسة ArcGIS. ما عليك سوى أن تفعل ذلك مرة واحدة، حيث يعمل Make على حفظ معلوماتك لاستخدامها مستقبلاً. ضمن الاتصال، انقر على إضافة وقم بتسمية اتصالك إلى ArcGIS.
   • للاتصال بـ ArcGIS Online، انقر على حفظ لتسجيل الدخول إلى مؤسسة ArcGIS.
   • للاتصال بـ ArcGIS Enterprise، سجّل Make ببوابتك. لمزيد من المعلومات، راجع منشور المدونة حيل مبادلة Survey123: Make.
7. اختر استطلاعًا من مؤسسة ArcGIS الخاصة بك للاتصال به.

   

8. فكّر في الخيارات التي ستضمنها في خطاف الويب الخاص بك، وانقر حفظ.

   يوصى بإبقاء القيمة الافتراضية نعم لجميع الإعدادات المتقدمة، فهذا سيمنحك أقصى قدر من المرونة عند تخصيص خطاف الويب.

9. انقر على موافق.

   يتم إنشاء خطاف الويب الخاص بك ويتم تكوين وحدة مشاهدة الاستطلاع النمطية.

10. انقر على زر إضافة وحدة نمطية أخرى بالجانب الأيمن بوحدة مشاهدة الاستطلاع النمطية لتوصيل وحدة نمطية أخرى بها.

    

11. ابحث عن البريد الإلكتروني وحدد وحدة البريد الإلكتروني النمطية.
12. حدد إجراء إرسال بريد إلكتروني.
13. إذا كانت هذه هي المرة الأولى لاستخدام هذه الوحدة النمطية في Make، فانقر على إضافة لتعيين اتصال إلى حساب البريد الإلكتروني. حدد نوع اتصال وسجّل الدخول إلى حسابك.

    ما عليك سوى أن تفعل ذلك مرة واحدة، حيث إن Make سيحفظ اتصالك لاستخدامه مستقبلاً.

14. أضف عنوان البريد الإلكتروني للمستلم.

    وهذا هو عنوان البريد الإلكتروني الذي ستُرسل إليه رسائل البريد الإلكتروني النشطة.

15. انقر على مربع نص الموضوع. اختر الحقول من الاستطلاع الخاص بك لبناء موضوع بريدك الإلكتروني باستخدام لوحة إعدادات الوحدة النمطية التي تظهر.
16. انقر في مربع نص المحتوى. اختر الحقول من الاستطلاع الخاص بك لإنشاء المحتوى لبريدك الإلكتروني باستخدام لوحة إعداد الوحدة النمطية التي تظهر. يمكنك تنسيق المحتوى باستخدام HTML.
17. انقر على موافق.

    يجب أن يرسل السيناريو رسالةً عبر البريد الإلكتروني عند الإجابة على سؤال بطريقة معينة، لذلك ستوفر عامل تصفية.

18. انقر فوق زر الأدوات بين الوحدتين، وحدد إعداد عامل تصفية.

    

19. انقر فوق المربع النصي الحالة واختر الحقل من الاستطلاع الذي تريد استخدامه في عامل التصفية.

    

20. اختر العامل الخاص بالشرط. في هذه الحالة، اختر الإعداد الافتراضي، مساو لـ.
21. اكتب قيمة الشرط، ثم انقر على موافق.
22. انقر على حفظ لحفظ السيناريو.

    اختياريًا، يمكنك النقر على التشغيل مرة واحدة لاختبار خطاف الويب. بعد النقر على Run once، افتح Survey123 وأرسل استطلاعًا، للتأكد أن إجابة الاستطلاع تستوفي شرط عامل التصفية. تأكد من تلقي المستلم للبريد الإلكتروني.

23. استخدم زر التبديل في أسفل يسار الصفحة لتنشيط السيناريو الخاص بك. عيّن الجدول الزمني على الفور لضمان تشغيل السيناريو في كل مرة يتم فيها إرسال استجابة الاستطلاع.

    لمعرفة طرق إضافية لاستخدام Survey123 كمشغل في سيناريوهات Make الخاصة بك، راجع عمليات تكامل Survey123.

تعيين خطاف ويب في Microsoft Power Automate

Microsoft Power Automate هي خدمة خطاف ويب متاحة على منصة Microsoft Office 365.

ملاحظة:‏

يتم تسجيل الخروج تلقائيًا من بيانات اعتماد ArcGIS Online المستخدمة لإنشاء تدفقات في Power Automate بعد أسبوعين. إذا لم تتمكن من تصفح الاستطلاعات المتوقعة في Power Automate، فتأكد من أن اتصال بيانات Survey123 الخاص بك نشط. لمزيد من المعلومات، راجع مقالة المدونة تلميح سريع: الحفاظ على صلاحية رمز تحديث ArcGIS Connectors for Power Automate.

لإعداد تدفق في Microsoft Power Automate باستخدام ArcGIS أو موصلات ArcGIS Enterprise، أكمل الخطوات أدناه. إذا قمت سابقًا بإنشاء تدفقات باستخدام موصل Survey123، فستعمل هذه التدفقات، ولكن ستتم إضافة وظائف جديدة إلى ArcGIS وموصلات ArcGIS Enterprise فقط. لمزيد من المعلومات، راجع مقالة المدونة مشغلات وإجراءات Survey123 في ArcGIS Connectors for Power Automate.

1. افتح Microsoft Power Automate.
2. حدد إنشاء في قائمة الصفحة الجانبية.
3. حدد التدفق السحابي الآلي من خيارات البدء من فارغ.

   يظهر مربع الحوار إنشاء تدفق سحابي آلي.

4. حدد اسمًا للتدفق.

   بعد ذلك، حدد مشغلًا.

5. اكتب ArcGIS في شريط البحث، ثم حدد عند إرسال إجابة الاستطلاع.

   تنبيه:

   اختر خيار عند إرسال إجابة الاستطلاع أسفل ArcGIS إذا كان التدفق يتطلب منك تسجيل الدخول إلى مؤسسة ArcGIS Online. اختر خيار عند إرسال إجابة الاستطلاع أسفل ArcGIS Enterprise إذا كان التدفق يتطلب منك تسجيل الدخول إلى مؤسسة ArcGIS Enterprise.

   

6. انقر على إنشاء.
7. إذا كانت هذه المرة الأولى لك في استخدام هذا الموصل في Microsoft Power Automate، فانقر على تسجيل الدخول لتسجيل الدخول ببيانات اعتماد مؤسسة ArcGIS.

   ما عليك سوى تسجيل الدخول مرة واحدة فقط، إذ يقوم Microsoft Power Automate بحفظ بيانات الاعتماد الخاصة بك لاستخدامها مستقبلاً.

8. حدد الاستطلاع الذي تريد استخدامه لخطاف الويب من القائمة المنسدلة للاستطلاعات.

   لقد قمت الآن بإعداد المُشغل لخطاف الويب؛ ومع ذلك، لكي يقوم خطاف الويب بتنفيذ إجراءات باستخدام هذا المُشغل، هناك خطوات إضافية.

   يتعين على التدفق إرسال رسالة عبر البريد الإلكتروني عند الإجابة عن سؤال بطريقة معينة بحيث توفر شرطًا.

9. انقر على زر خطوة جديدة، واختر شرطًا أعلى قسم الإجراءات.

   

10. انقر فوق مربع النص الموجود في أقصى اليسار لفتح مربع حوار لتحديد سؤال أو خاصية من الاستطلاع، ثم حدد سؤال الاستطلاع الذي تريد استخدامه لوصف الاستطلاع.
11. في مربع النص الأوسط، من القائمة المنسدلة، حدد الشرط يساوي باعتباره المُشغل، إذ إنك تبحث عن استجابة دقيقة.
12. في المربع النصي في أقصى اليمين، اكتب قيمة للسؤال الذي تريد إرسال إخطار.

    تريد إرسال هذا البريد الإلكتروني فقط إذا تم استيفاء الشرط.

13. انقر على إضافة إجراء في صندوق إذا كانت الإجابة نعم.

    يظل مربع إن كان لا فارغًا.

    لدى العديد من خدمات بريد إلكتروني موصلات التي يمكن استخدامها في هذا التدفق.

14. حدد Office 365 Outlook - إرسال رسالة عبر البريد الإلكتروني (V2).
15. قم بتسجيل الدخول إلى خدمة البريد الإلكتروني باستخدام بيانات الاعتماد إذا لم يتم حفظ بيانات الاعتماد لديك بالفعل.
16. املأ الحقول إلى و الموضوع و نص الرسالة في بريدك الإلكتروني.

    يسمح لك مربع حوار المحتوى الديناميكي الذي يظهر عند تحديد مربع نص بإدراج محتوى من إجابة الاستطلاع حسب الضرورة.

17. عند اكتمال البريد الإلكتروني، انقر على حفظ.

يكون خطاف الويب مكتملاً ونشطًا بصورة افتراضية. سيقوم خطاف الويب الآن بالتشغيل في كل مرة تُرسل فيها إجابة الاستطلاع بشروط محددة.

تلميح:

يمكنك استخدام إجراء إنشاء تقرير لإنشاء تقرير لإجابة استطلاع.

تكوين خطاف ويب في موقع ويب Survey123

أكمل الخطوات التالية لإعداد خطاف ويب في موقع ويب Survey123.

1. في صفحة استطلاعاتي، حدد علامة التبويب الإعدادات من القائمة الموجودة في أسفل يمين لوحة الاستطلاع.
2. حدد قسم خطافات الويب من القائمة في الجانب الأيمن.

   تتيح لك هذه الصفحة تعيين كل خطافات الويب التي قمت بإعدادها والوصول إليها. إذا لم تقم بإعداد أي خطافات ويب في Survey123، فستكون الصفحة فارغة.

3. انقر على إضافة خطاف ويب.

   تظهر صفحة جديدة حيث يمكنك إعداد كيفية تفاعل خطاف الويب مع الاستطلاع.

   

4. اكتب اسمًا لخطاف الويب، والذي سيتم استخدامه لتحديده مستقبلاً.
5. عنوان URL الخاص بالبيانات الأساسية هو مكان إرسال معلومات الاستطلاع. يجب توفير ذلك بواسطة خدمة خطاف ويب خارجية.

   عند إنشائك خطاف ويب باستخدام خدمة مثل Microsoft Power Automate أو Make، يتم ملء عنوان URL الخاص بالحمولة تلقائيًا في هذه الصفحة. توفر لك الخدمات الأخرى مثل Zapier أو خادم FME عنوان URL الخاص بالحمولة لتنسخه في هذه الصفحة. قد تتطلب منك بعض التطبيقات الأخرى إنشاء خدمة مخصصة للتعرف على خطاف الويب.

6. يوضح حدث المشغل الإجراءات المحددة الذي ستستدعي خطاف الويب. حدد تم إرسال سجل جديد.
7. تتيح لك بيانات الحدث تحديد المعلومات التي سيتم تضمينها في البيانات الأساسية من الاستطلاع الخاص بك: معلومات الاستطلاع، واستجابة الخادم، والسجل المُرسَل، ومعلومات المستخدم، ومعلومات البوابة الإلكترونية. تحقق من معلومات الاستطلاع وخيارات السجل المُرسَل.
8. يحدد زر التبديل الحالة ما إذا سيكون خطاف الويب نشطًا عند حفظه من عدمه. اتركه لتعيينه على تشغيل (الافتراضي).
9. انقر حفظ.

خطاف الويب جاهز للاستخدام، وسيقوم بالعمل في كل مرة تُرسل فيها إجابة الاستطلاع. يمكن للقواعد التي تم تعيينها ضمن موفر خطاف الويب ضمان إرسال البريد الإلكتروني فقط إذا تمت تلبية معايير محددة.

خصائص حمولة الحدث

يرسل حدث خطاف الويب حمولة من الخصائص ككائن JSON. ستختلف محتويات الحمولة تبعًا للاستطلاع. يدرج الجدول التالي الخصائص المشتركة المضمنة في كائن JSON:

الخاصية	الوصف
eventType	نوع الحدث. يمكن أن تكون القيم addData أو editData.
portalInfo	معلومات حول مؤسسة ArcGIS حيث يتم استضافة الاستطلاع. يحتوي على الخصائص التالية: url token
surveyInfo	معلومات بشأن الاستطلاع المستخدم لإنشاء خطاف الويب. يحتوي على الخصائص التالية: formItemId formTitle serviceItemId serviceUrl
userInfo	معلومات بشأن حساب ArcGIS المؤسسي للمستخدم الذي أرسل الاستطلاع. يحتوي على الخصائص التالية: username firstName lastName fullName email

ستختلف الخصائص التالية تبعًا للاستطلاع ونوع الحدث:

الخاصية	الوصف
applyEdits	تم إرسال حمولة تطبيق عمليات التحرير بواسطة الاستطلاع. إذا كان eventType هو addData، فسيحتوي على adds. إذا كان eventType هو editData، فسيحتوي على updates. عند إضافة سجل تكرار جديد، فإنه سيحتوي أيضًا على adds.
response	الرد من عملية applyEdits. يتضمن المعرفات العالمية للمعالم التي تم إنشاؤها بواسطة العملية وما إذا كانت العملية ناجحة أم لا.
feature	سجل الاستطلاع الذي تم إرساله. يحتوي على الخصائص التالية: attributes geometry layerInfo result repeats ملاحظة:‏ كل كائن داخل مصفوفة repeats هو عبارة عن feature يحتوي على attributes وgeometry وlayerInfo وresult وrepeats وattachments. attachments id globalId name contentType size keywords url parentObjectId