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 هو محرك تطوير جديد لواجهة المستخدم (frontend) بدون/قليل التعليمات البرمجية، تم تقديمه في NocoBase 2.0. يجمع هذا المحرك بين النماذج (Model) و التدفقات (Flow) لتبسيط منطق الواجهة الأمامية وتعزيز قابلية إعادة الاستخدام والصيانة. وفي الوقت نفسه، من خلال الاستفادة من طبيعة التدفق القابلة للتكوين، فإنه يوفر قدرات تكوين وتنسيق بدون تعليمات برمجية لمكونات الواجهة الأمامية ومنطق الأعمال.

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

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

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

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

#ما هو Model؟

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

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

بمعنى آخر، النموذج (Model) هو العقل المنطقي للمكون، يحوّله من عنصر ثابت إلى وحدة ديناميكية قابلة للتكوين والتنسيق.

#ما هو Flow؟

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

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

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

يمكنك تخيل التدفق (Flow) كـ تيار ماء:

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

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

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

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

ملخص التشبيه

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

لذلك في FlowEngine:

  • التدفق (Flow) يسمح للمنطق بالتحرك بشكل طبيعي مثل تيار الماء؛
  • النموذج (Model) يجعل المكون هو الحامل والمنفذ لهذا التيار.