6.2 KiB
pkg
| pkg |
|---|
| @nocobase/plugin-workflow-variable |
:::tip إشعار الترجمة بالذكاء الاصطناعي تمت ترجمة هذه الوثائق تلقائيًا بواسطة الذكاء الاصطناعي. :::
متغير
مقدمة
يمكنك تعريف المتغيرات في سير العمل أو إسناد قيم لمتغيرات معرفة مسبقًا. يُستخدم هذا عادةً لتخزين البيانات المؤقتة ضمن سير العمل.
إنشاء عقدة
في واجهة إعدادات سير العمل، انقر على زر الزائد ("+") في سير العمل لإضافة عقدة "متغير":
إعداد العقدة
الوضع
عقدة المتغير تشبه المتغيرات في البرمجة؛ يجب تعريفها أولاً قبل أن تتمكن من استخدامها وإسناد قيمة لها. لذلك، عند إنشاء عقدة متغير، تحتاج إلى اختيار وضع المتغير. هناك وضعان متاحان للاختيار:
- تعريف متغير جديد: لإنشاء متغير جديد.
- إسناد قيمة لمتغير موجود: لإسناد قيمة لمتغير تم تعريفه مسبقًا في سير العمل، وهو ما يعادل تعديل قيمة المتغير.
عندما تكون العقدة التي يتم إنشاؤها هي أول عقدة متغير في سير العمل، يمكنك فقط اختيار وضع التعريف، حيث لا توجد متغيرات متاحة للإسناد إليها بعد.
عند اختيار إسناد قيمة لمتغير معرف مسبقًا، تحتاج أيضًا إلى تحديد المتغير الهدف، وهو العقدة التي تم تعريف المتغير فيها:
القيمة
يمكن أن تكون قيمة المتغير من أي نوع. يمكن أن تكون ثابتة، مثل سلسلة نصية أو رقم أو قيمة منطقية أو تاريخ، أو يمكن أن تكون متغيرًا آخر من سير العمل.
في وضع التعريف، يعادل تعيين قيمة للمتغير إسناد قيمة أولية له.
في وضع الإسناد، يعادل تعيين قيمة للمتغير تعديل قيمة المتغير الهدف المُعرّف إلى قيمة جديدة. وستحصل الاستخدامات اللاحقة على هذه القيمة الجديدة.
استخدام قيمة المتغير
في العقد اللاحقة لعقدة المتغير، يمكنك استخدام قيمة المتغير عن طريق اختيار المتغير المُعرّف من مجموعة "متغيرات العقدة". على سبيل المثال، في عقدة الاستعلام، استخدم قيمة المتغير كشرط للاستعلام:
مثال
تظهر فائدة عقدة المتغير بشكل أكبر في الفروع، حيث يتم حساب أو دمج قيم جديدة مع قيم سابقة (على غرار reduce/concat في البرمجة)، ثم استخدامها بعد انتهاء الفرع. فيما يلي مثال على استخدام فرع التكرار وعقدة المتغير لدمج سلسلة نصية للمستلمين.
أولاً، أنشئ سير عمل يتم تشغيله بواسطة مجموعة، بحيث يتم تشغيله عند تحديث بيانات "المقالات"، ويقوم بتحميل مسبق لبيانات علاقة "المؤلف" ذات الصلة (للحصول على المستلمين):
ثم، أنشئ عقدة متغير لتخزين سلسلة نصية للمستلمين:
بعد ذلك، أنشئ عقدة فرع تكرار للتنقل عبر مؤلفي المقال ودمج معلومات المستلمين الخاصة بهم في متغير المستلم:
ضمن فرع التكرار، أنشئ أولاً عقدة حساب لدمج المؤلف الحالي مع سلسلة المؤلف المخزنة مسبقًا:
بعد عقدة الحساب، أنشئ عقدة متغير أخرى. اختر وضع الإسناد، وحدد عقدة متغير المستلم كهدف للإسناد، واختر نتيجة عقدة الحساب كقيمة:
بهذه الطريقة، بعد انتهاء فرع التكرار، سيتم تخزين سلسلة المستلمين لجميع مؤلفي المقالات في متغير المستلم. بعد ذلك، يمكنك استخدام عقدة طلب HTTP بعد التكرار لاستدعاء واجهة برمجة تطبيقات إرسال البريد، وتمرير قيمة متغير المستلم كمعامل للمستلم إلى الواجهة:
بذلك، تم تنفيذ ميزة إرسال البريد الإلكتروني الجماعي البسيطة باستخدام فرع التكرار وعقدة المتغير.