دالة HTTP

🔌 ما هي HTTP Function؟

تمكنك دالة أمان Http من توسيع ngSurvey بسهولة بوظائف REST HTTP عن بُعد خاصة بك.

باستخدام دالة الأمان HTTP يمكنك إعداد واجهة مستخدم مخصصة لجمع بيانات من المستجيب قبل عرض الاستبيان، وإرسال تلك البيانات إلى نقطة نهاية HTTP REST معينة ككائن JSON بسيط، وتنفيذ أي منطق أعمال تحتاجه بالبيانات، وإرجاع كائن JSON جديد من نقطة النهاية HTTP ليتم تخزينه مع إجابات المستجيب ويمكن استخدامه في أي مكان في الاستبيان باستخدام ميزات piping في ngSurvey.

☁️ ما الذي يُرسَل ويُستقبل؟

الكائن الذي سترسله ngSurvey إلى نقطة النهاية HTTP الخاصة بك هو كائن مُنسق بصيغة JSON بسيط كما يلي

{
 properynamefromyouruserinterface1 : 'value', 
 properynamefromyouruserinterface2 : 'value'
}

بالإضافة إلى قيم واجهة المستخدم التي يدخلها المستجيب، يرسل ngSurvey أيضًا الخصائص الإضافية التالية إلى نقطة النهاية:

{
 ngsSurveyId : 'abcd' // معرف الاستبيان، 
 ngsRemoteip : '127.0.0.1' // عنوان IP للمستجيب
}

يجب أن يكون الكائن الذي ترجع به نقطة النهاية HTTP مُنسقًا ككائن JSON كما هو موضح أدناه، يمكنك إرجاع أي عدد من الخصائص التي تريدها.

{
yourproperty1:'value', 
yourproperty2:'value'
}

🧙 القيم التي تُرجَع من نقطة النهاية HTTP الخاصة بك يمكن أن تُستخدم كـ piped في أي مكان داخل نصوص أسئلة الاستبيان أو الإجابات باستخدام صيغة الأنبوب التالية __yourproperty1__

🔅 خصائص HTTP Function

• عنوان URL لنقطة نهاية Http يجب أن يكون عنوان URL الخاص بـ http الذي سيتلقى البيانات المُدخلة في واجهة المستخدم. يرسل ngSurvey البيانات إما ككائن JSON إذا تم ضبطه على post أو كزوجيّة مفاتيح/قيم تُضاف إلى عنوان نقطة النهاية.

• نقل قيم الاستعلام إذا تم تمكينه، سيقوم ngSurvey بإعادة توجيه كافة مفاتيح/قيم سلسلة الاستعلام التي تم إعدادها في عنوان URL الخاص بالاستبيان.

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

• مؤمن lاسمح لك بإعداد رمز JWT الذي سيُستخدم لتفويض نقطة النهاية http.

• اسم خاصية القيمة الفريدة هو اسم الخاصية من الكائن الذي تُرجعه نقطة نهاية Http والذي سيُستخدم كـ "المفتاح الأساسي" لتحديد البيانات المرتجعة بشكل فريد. سيُستخدم هذا المفتاح الفريد لمنع الإدخالات المكررة ولتمكين ميزات الحفظ/الاستئناف إذا تم تعيين عنصر أمان دالة Http كمزود مفتاح.

• جاري التحميل رسالة قصيرة ستُعرض أثناء النداء عند التحميل.

• رسالة تقديمية رسالة قصيرة ستُعرض أعلى واجهة المستخدم.