logologo
البدء
الدليل
التطوير
الإضافات
API
English
简体中文
日本語
한국어
Deutsch
Français
Español
Português
Русский
Italiano
Türkçe
Українська
Tiếng Việt
Bahasa Indonesia
ไทย
Polski
Nederlands
Čeština
العربية
עברית
हिन्दी
Svenska
البدء
الدليل
التطوير
الإضافات
API
logologo

مقدمة

ما هو FlowEngine؟
العلاقة بين FlowEngine والإضافات
بدء سريع
خارطة طريق التعلم

دليل

تسجيل FlowModel
إنشاء FlowModel
عرض FlowModel
تدفق أحداث FlowModel والإعداد
استمرارية FlowModel
دورة حياة FlowModel
نظام سياق FlowModel
آلية التفاعل: Observable
FlowModel مقابل React.Component

Definitions

ModelDefinition
FlowDefinition
EventDefinition
ActionDefinition
StepDefinition
Next Pageالعلاقة بين FlowEngine والإضافات
إشعار الترجمة بالذكاء الاصطناعي

تمت ترجمة هذه الوثائق تلقائيًا بواسطة الذكاء الاصطناعي.

#ما هو FlowEngine؟

FlowEngine هو محرك تطوير الواجهة الأمامية الجديد كليًا بدون/قليل التعليمات البرمجية، الذي تم إطلاقه في NocoBase 2.0. يجمع هذا المحرك بين الـ Models والـ Flows لتبسيط منطق الواجهة الأمامية وتحسين قابلية إعادة الاستخدام والصيانة. وفي الوقت نفسه، وبفضل قدرة الـ Flow على التكوين، يمنح مكونات الواجهة الأمامية ومنطق الأعمال قدرات تكوين وتنظيم بدون تعليمات برمجية.

#لماذا سُمي FlowEngine؟

لأن في FlowEngine، لم تعد خصائص المكونات ومنطقها تُعرّف بشكل ثابت، بل يتم تشغيلها وإدارتها بواسطة الـ Flows.

  • الـ Flow، تمامًا كتدفق البيانات، يقوم بتقسيم المنطق إلى خطوات (Step) مرتبة تُطبق تدريجيًا على المكون.
  • الـ Engine يشير إلى أنه محرك يدفع منطق الواجهة الأمامية وتفاعلاتها.

لذلك، FlowEngine = محرك منطق الواجهة الأمامية المدفوع بالـ Flows.

#ما هو الـ Model؟

في FlowEngine، الـ Model هو نموذج تجريدي للمكون، وهو مسؤول عن:

  • إدارة خصائص (Props) وحالة المكون.
  • تحديد طريقة عرض المكون.
  • استضافة وتنفيذ الـ Flows.
  • التعامل بشكل موحد مع توزيع الأحداث ودورات الحياة.

بمعنى آخر، الـ Model هو العقل المنطقي للمكون، يحوّله من وحدة ثابتة إلى وحدة ديناميكية قابلة للتكوين والتنظيم.

#ما هو الـ Flow؟

في FlowEngine، الـ Flow هو تدفق منطقي يخدم الـ Model. الغرض منه هو:

  • تقسيم منطق الخصائص أو الأحداث إلى خطوات (Step) وتنفيذها بالتسلسل كتدفق.
  • يمكنه إدارة تغييرات الخصائص بالإضافة إلى استجابات الأحداث.
  • جعل المنطق ديناميكيًا وقابلًا للتكوين وقابلًا لإعادة الاستخدام.

#كيف نفهم هذه المفاهيم؟

يمكنك تخيل الـ Flow كـ تيار ماء:

  • الخطوة (Step) تشبه العقدة على طول تيار الماء تؤدي كل خطوة (Step) مهمة صغيرة (مثل تعيين خاصية، تشغيل حدث، استدعاء واجهة برمجة تطبيقات API)، تمامًا كما يحدث تأثير لتيار الماء عندما يمر عبر بوابة أو عجلة مائية.

  • الـ Flows مرتبة يتبع تيار الماء مسارًا محددًا مسبقًا من المنبع إلى المصب، مرورًا بجميع الخطوات (Steps) بالتسلسل؛ وبالمثل، يتم تنفيذ المنطق في الـ Flow بالترتيب المحدد.

  • الـ Flows قابلة للتفرع والدمج يمكن تقسيم تيار الماء إلى عدة تيارات أصغر أو دمجها معًا؛ ويمكن أيضًا تقسيم الـ Flow إلى عدة تدفقات فرعية، أو دمجها لتشكيل سلاسل منطقية أكثر تعقيدًا.

  • الـ Flows قابلة للتكوين والتحكم يمكن تعديل اتجاه وحجم تيار الماء باستخدام بوابة تحكم؛ ويمكن أيضًا التحكم في طريقة تنفيذ الـ Flow ومعلماته من خلال التكوين (stepParams).

ملخص التشبيه

  • المكون (Component) يشبه عجلة مائية تحتاج إلى تيار ماء لدفعها كي تدور.
  • الـ Model هو القاعدة ووحدة التحكم لهذه العجلة المائية، المسؤول عن استقبال تيار الماء وتشغيلها.
  • الـ Flow هو تيار الماء هذا، الذي يمر عبر كل خطوة (Step) بالترتيب، ويدفع المكون للتغير والاستجابة باستمرار.

لذلك، في FlowEngine:

  • الـ Flows تجعل المنطق يتدفق بشكل طبيعي كتيار الماء.
  • والـ Models تمكّن المكونات من أن تصبح حاملات ومنفذات لهذا التيار.