Flow — موافقة الإجازة (Leave Approval) — دليل كامل خطوة بخطوة

التطبيق:
HR Leave
Scope: x_786686_hr_leave
الجدول:
x_786686_hr_leave_req_v2

افتح Flow Designer:
URL: /$flow-designer.do
أو من Studio:
Create Application File → Flow

0) قبل أن تبدأ (Prerequisites)

يجب أن يكون جاهزًا قبل الـ Flow:

بدون u_approver_user مملوء، خطوة Ask For Approval لن تجد معتمدًا.

ملف BR1:
src/server/business_rules/BR1_calculate_days.js

1) الفكرة (ماذا يفعل الـ Flow)

text الموظف يغيّر الحالة إلى submitted ↓ Flow يبدأ (Trigger: Record Updated + شرط submitted) ↓ Ask For Approval → يرسل للمعتمد في u_approver_user ↓ إذا وافق → u_state = approved إذا رفض → u_state = rejected ↓
BR3 يسجّل التدقيق ويحدّث الرصيد (بعد تغيير الحالة)

مهم:
لا تستخدم Trigger Record Created فقط إذا الطلب يُنشأ أولًا كـ draft ثم يُرسل لاحقًا.
استخدم Record Updated عندما تصبح الحالة submitted.

2) إنشاء Flow جديد

الخطوات

1. افتح Flow Designer.
   URL: /$flow-designer.do
2. اضغط Create Flow (أو New).
3. املأ:
   - Name: HRLX Leave Approval
   - Application: HR Leave (scope x_786686_hr_leave)
4. احفظ.

3) الخطوة 1 — Trigger (مشغّل التدفق)

الإعدادات الصحيحة

الخطوات في الواجهة

1. في بداية الـ Flow اضغط Add a trigger.
2. اختر Record Updated.
3. Table: ابحث عن x_786686_hr_leave_req_v2 أو Leave Request.
4. في Condition (أو Trigger conditions):
   - Field: State / u_state
   - Operator: is
   - Value: submitted
5. Done أو احفظ الـ Trigger.

خطأ شائع

4) الخطوة 2 — Action: Ask For Approval

هذه الخطوة تظهر في صورتك كـ Action 1 — Ask For Approval.

الخطوات

1. بعد الـ Trigger اضغط + → Ask for Approval.
2. املأ Action inputs كالتالي:

3. Rules (الأهم — يصلح الخطأ الأحمر):

الخطأ في الشاشة:
Rules on action number 1 are missing

الحل:

1. في قسم Rules عند Approve:
2. اضغط القائمة Choose approval rule (لا تتركها فارغة).
3. اختر أحد الخيارات:

4. للتطبيق البسيط: اختر Anyone approves.

5. (اختياري) أضف قاعدة Reject إن طلبت الواجهة ذلك — نفس المستوى.

6. اضغط Done على الـ Action.

تحقق قبل المتابعة

• لا يظهر خط أحمر على Action 1.
• في الشريط السفلي لا يبقى Error: Rules on action 1 are missing.

5) الخطوة 3 — If: If approval was Approved

الخطوات

1. بعد Ask For Approval اضغط + → Flow Logic → If.
2. الشرط الجاهز غالبًا:
   - If approval was Approved
   - أو: 1 - Ask For Approval → Approval state is approved
3. لا تغيّر الشرط إلا إذا تعرف ما تفعل.

6) الخطوة 4 — Update Record (موافقة)

داخل فرع If (Approved):

1. اضغط + → Update Record.
2. Record: pill من Trigger → Leave Request Record.
3. Table: x_786686_hr_leave_req_v2.
4. Set field values:
   - Field: State / u_state
   - Value: approved
5. Done.

7) الخطوة 5 — Else (رفض)

الخطوات

1. من فرع Else (بجانب If):
2. + → Update Record.
3. نفس السجل (Trigger record).
4. Set:
   - u_state = rejected
5. Done.

8) مخطط الـ Flow النهائي

[Trigger] Record Updated
 Table: x_786686_hr_leave_req_v2
 Condition: u_state is submitted
 │
 ▼
[1] Ask For Approval
 Record: Trigger → Leave Request Record
 Approval field: u_approver_user
 Rule (Approve): Anyone approves
 │
 ▼
[2] If ── approval was Approved?
 │
 ├─ Yes ─► [3] Update Record → u_state = approved
 │
 └─ Else ─► [5] Update Record → u_state = rejected

9) الحفظ والنشر (Publish)

Modified بدون Publish = الـ Flow غير فعّال للمستخدمين.

10) اختبار عملي (Practice Lab)

تجهيز مستخدمين

سيناريو الاختبار

1. سجّل دخول كموظف.
2. افتح x_786686_hr_leave_req_v2 → New.
3. املأ التواريخ والنوع.
4. تأكد BR1 ملأ u_approver_user = المدير.
5. غيّر State إلى submitted → Save.
6. سجّل خروج → سجّل دخول كـ manager.
7. افتح:
   Navigate: All > My Approvals أو Inbox / Approvals في الـ Next Experience — Open direct
8. افتح طلب الإجازة → Approve.
9. ارجع للسجل: u_state يجب أن تصبح approved.
10. تحقق من جدول التدقيق x_786686_hr_leave_audit_v2.

سيناريو الرفض

كرر الخطوات 1–6 ثم اختر Reject → تحقق u_state = rejected.

11) استكشاف الأخطاء (Troubleshooting)

12) ربط مع باقي التطبيق

ملف التطوير الكامل:
../../01_DEVELOPMENT.md §7

13) قائمة تحقق سريعة

• [ ] Trigger = Record Updated
• [ ] Condition = u_state is submitted
• [ ] Ask For Approval → Record = trigger record
• [ ] Approval field = u_approver_user
• [ ] Rules → Anyone approves (لا تترك Choose approval rule فارغًا)
• [ ] If Approved → Update u_state = approved
• [ ] Else → Update u_state = rejected
• [ ] Publish flow
• [ ] اختبار Approve و Reject

14) ملاحظة للصورة التي أرسلتها

في الشاشة كان:
- Trigger يظهر كـ Record Created — غيّره إلى Record Updated + شرط submitted إن كان الطلب يمرّ بـ draft أولًا.
- Rules فارغة (Choose approval rule) — هذا سبب الخطأ الأحمر؛ اختر Anyone approves ثم Done ثم Publish.

15) Options & alternatives (Flow)

Hub: ../../00_TUTORIAL_OPTIONS_REFERENCE.md

Trigger alternatives:

Ask For Approval — Rules options:

Instance note: Flow UI labels vary by release; Publish required — Save alone is not enough.