كيف أُعدّ خطوة تعديل القائمة؟

ما فائدتها؟

تعدّل خطوة «تعديل قائمة» قائمةً وتكتب النتيجة في متغير جديد. وتأتي القائمة غالبًا من رد خطوة «استدعاء أداة» أو «إجراء تكامل»، وإجابة الاختيار المتعدد قائمة أيضًا.

لا يرى الزائر هذه الخطوة ولا يقول الأفاتار شيئًا؛ ويتابع الوكيل دون انتظار الزائر.

لإضافتها انقر على «إضافة خطوة» في تبويب «المحرر»، ثم انقر على «تعديل قائمة» في فئة «المنطق» فتُضاف الخطوة في وسط اللوحة. وإعداداتها في تبويب «المحتوى» في لوحة الخطوة التي تُفتح على الجانب عند النقر عليها.

لا يوجد في هذه الخطوة «النص المعروض على الشاشة»؛ بل توجد «ملاحظة الخطوة» في أسفل اللوحة. الملاحظة لك وحدك: لا يراها الزائر، ولا تُنطق ولا تُترجم.

تكتب في القيم متغيرات من الخطوات السابقة، مثل {city}. ولحقل داخل إجابة أضف اسم الحقل بعد نقطة: {order.status}. يعرض زر «إدراج متغير» في الحقول المتغيرات التي يمكنك استخدامها في تلك النقطة. والمتغير الذي لم يُملأ بعد يُعدّ نصًا فارغًا.

إعداد الخطوة

1. اكتب في «القائمة» المسار إلى القائمة نفسها، مثل {answer.items}؛ فالرد كاملًا ليس قائمة. وإن كانت القائمة في رد «استدعاء أداة» فانقر «جلب بيانات نموذجية» لاستدعاء الأداة مرة واحدة: تختار إحدى «القوائم في الرد» وترى «حقول الصف الأول».
2. فعّل العمليات التي تريدها (أدناه).
3. أدخل «اسم المتغير» الذي تُكتب فيه النتيجة. يعطي {list} القائمة كاملة، و{list.1.field} حقلًا من العنصر الأول.

العمليات

تُطبَّق العمليات دائمًا بهذا الترتيب، فتأتي نتائج مثل «أرخص 5» صحيحة:

• «ترشيح»: تبقى العناصر التي تحقق القواعد فقط. تعمل القواعد كما في خطوة «شرط»؛ اكتب حقل العنصر بصيغة {item.field} ({item} إن كان العنصر قيمة بسيطة). وإن لم توجد قواعد فلا ترشيح.
• «ترتيب»: اكتب في الحقل الذي يظهر الحقلَ المراد الترتيب حسبه (مثل price) واختر «تصاعدي» أو «تنازلي». تُرتَّب الأرقام كأرقام والتواريخ كتواريخ وغيرها أبجديًا، والعناصر ذات القيمة الفارغة في النهاية.
• «حذف المكرر»: اكتب في الحقل الذي يظهر الحقلَ المراد المقارنة به؛ ومن العناصر التي تحمل القيمة نفسها يبقى الأول فقط. ولأنه يُطبَّق بعد الترتيب يبقى الأعلى. وإن لم يُحدَّد حقل يُقارَن العنصر كاملًا.
• «إبقاء أول N عنصر»: يبقى من أعلى القائمة عدد العناصر الذي تكتبه فقط.

استخدام النتيجة

يمكنك استخدام النتيجة في الخطوات اللاحقة: عرضها خياراتٍ في خطوة «اختيار» عبر «مصدر الخيارات» › «من متغير»، أو تشغيل الخطوات نفسها لكل عنصر فيها بخطوة «حلقة تكرار»، أو عدّها وجمعها بـ«ملخص قائمة» في «تعيين متغيرات». وإن كانت النتيجة طويلة جدًا (نحو 16,000 حرف) تُحذف العناصر من آخرها.

مثال

تكتب خطوة «استدعاء أداة» مواعيد الحجز المتاحة في {answer}. في «تعديل قائمة»: «القائمة» {answer.slots}؛ «ترشيح» {item.seats} · «رقم» · «أكبر من» · 0؛ «ترتيب» حسب حقل start «تصاعدي»؛ «إبقاء أول N عنصر» 5؛ «اسم المتغير» next_slots. ثم تعرض خطوة «اختيار» بمصدر «من متغير» أقرب خمسة مواعيد خياراتٍ.

ما يجب الانتباه إليه

ينبّهك المحرر في هذه الحالات: لم تُحدَّد القائمة، أو اسم المتغير غير صالح، أو قاعدة ترشيح لا تنظر إلى حقل العنصر (فتعطي النتيجة نفسها لكل عنصر). وإن لم يشر ما كتبته إلى قائمة تُظهر البيانات النموذجية «هذا المسار لا يشير إلى قائمة؛ تبقى النتيجة فارغة.». ولخطوة «استدعاء أداة» راجع خطوتي إجراء التكامل واستدعاء الأداة.

لا يُستخدم في اسم المتغير إلا الأحرف اللاتينية a–z والأرقام والشرطة السفلية (_)؛ وتسقط الأحرف العربية والأحرف ذات العلامات والمسافات أثناء الكتابة. والاسم «system» محجوز لمتغيرات النظام، فاختر اسمًا آخر.

لا تمنع المشكلات الحفظ: يُحفظ الوكيل، لكن الخطوة الناقصة لن تعمل كما يُتوقع في المحادثة. أصلح الخطوات المعلَّمة، ثم جرّب الوكيل بـ«معاينة». ولمعرفة الخطوات المعلَّمة راجع محرر المسارات.