الحقول المستهدفة هي التفاصيل التي يجمعها إجراؤك من العميل، كالاسم أو رقم الطلب. تعدّها في قسم الحقول المستهدفة من المحرّر.
أضف حقلاً وسمِّه
اضغط أضف حقلاً لإلحاق صف جديد.
في المفتاح، اكتب اسم الحقل، مثل order_number. ويُنقّى وأنت تكتب إلى أحرف صغيرة وأرقام وشرطات سفلية.
اختر النوع: نص أو رقم أو منطقي أو تاريخ أو هاتف أو بريد.
اكتب وصفاً ليعرف الوكيل ما يطلبه.
الحقول المطلوبة
شغّل مطلوب لأي حقل يجب أن يمتلكه الإجراء قبل انطلاقه. فإن بقي حقل مطلوب ناقصاً، لن يرسل الإجراء أو يستعلم شيئاً حتى يجمعه الوكيل.
الحقول الجديدة التي تضيفها مطلوبة افتراضياً. ولا يمكن حذف الحقل الأخير، فحرّره في مكانه بدلاً من ذلك.
المفتاح هو ما تستلمه
المفتاح الذي تكتبه هو تماماً اسم الخاصية في البيانات التي تستلمها. في إجراء الإرسال يكون مفتاح JSON في الحمولة؛ وفي الاستعلام يصبح معامل الاستعلام. أبقِ المفاتيح واضحة ومتسقة كي يقرأها نظامك.
يمكنك إضافة حتى 20 حقلاً. ولا يُسمح بحقلين لهما المفتاح نفسه، لأن أحدهما سيدهس الآخر.
أسئلة شائعة
لماذا تغيّر مفتاحي وأنا أكتب؟
تُنقّى المفاتيح إلى أحرف صغيرة وأرقام وشرطات سفلية. فـ"Order Number" تصبح "order_number".
ماذا يفعل الوصف؟
يقرأه الوكيل ليعرف ماذا يسأل العميل، فاجعله محدداً.
هل أعيد ترتيب الحقول؟
ليس من المحرّر. تحتفظ الحقول بترتيب إضافتها.