#الاستعلام عن البيانات

يُستخدم هذا لإجراء استعلام عن سجلات البيانات واستردادها من مجموعة معينة تستوفي شروطًا محددة.

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

#إنشاء عقدة

في واجهة تهيئة سير العمل، انقر على زر الزائد ("+") في التدفق لإضافة عقدة "الاستعلام عن البيانات":

#تهيئة العقدة

#المجموعة

اختر المجموعة التي تريد الاستعلام عن البيانات منها.

#نوع النتيجة

ينقسم نوع النتيجة إلى "سجل واحد" و"سجلات متعددة":

• سجل واحد: تكون النتيجة كائنًا، وهو السجل الأول المطابق فقط، أو null.
• سجلات متعددة: تكون النتيجة مصفوفة تحتوي على السجلات التي تطابق الشروط. إذا لم تتطابق أي سجلات، فستكون مصفوفة فارغة. يمكنك معالجتها واحدًا تلو الآخر باستخدام عقدة التكرار (Loop).

#شروط التصفية

على غرار شروط التصفية في استعلام المجموعة العادي، يمكنك استخدام متغيرات سياق سير العمل.

#الفرز

عند الاستعلام عن سجل واحد أو عدة سجلات، يمكنك استخدام قواعد الفرز للتحكم في النتيجة المطلوبة. على سبيل المثال، للاستعلام عن أحدث سجل، يمكنك الفرز حسب حقل "وقت الإنشاء" بترتيب تنازلي.

#الترحيل

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

#معالجة النتائج الفارغة

في وضع السجل الواحد، إذا لم تتطابق أي بيانات مع الشروط، فستكون نتيجة الاستعلام null. وفي وضع السجلات المتعددة، ستكون مصفوفة فارغة ([]). يمكنك اختيار ما إذا كنت تريد تحديد "الخروج من سير العمل عندما تكون نتيجة الاستعلام فارغة" أم لا. إذا تم تحديد هذا الخيار، وفي حال كانت نتيجة الاستعلام فارغة، فلن يتم تنفيذ العقد اللاحقة، وسيتم إنهاء سير العمل مبكرًا بحالة فشل.