انتقل إلى المحتوى الرئيسي

حالات الطلبات

حالات الطلبات ضرورية لتتبع تقدم الطلب من إنشائه حتى الانتهاء. إنها تساعد في تنظيم العمل مع الطلبات للمديرين، وكذلك رؤية الحالة الحالية للطلب للعميل.

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

أوضاع العمل مع الحالات​

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

  • أساسي (Basic) — الوضع الافتراضي. يستخدم مجموعة واحدة من الحالات المرتبطة بحساب الدفع. تتغير حالة الطلب بشكل خطي بناءً على أحداث الدفع. هذا الوضع كافٍ لمعظم السيناريوهات.
  • متقدم (Advanced) — إعداد مرن على ثلاثة محاور مستقلة: order (الحالة الرئيسية للطلب)، fulfillment (التنفيذ - التجميع، الشحن، التسليم) و payment (الدفع). لكل محور يتم تعيين مجموعة خاصة من الحالات، وخرائط الانتقال التلقائي بناءً على المحفزات، ومحفزات مخصصة.

لتغيير الوضع، اختر الخيار المطلوب في كتلة "إعداد وضع حالة الطلب" ووافق على الإجراء في النافذة المنبثقة.

من المهم أن نفهم

عند التبديل إلى الوضع المتقدم، تأكد من تعيين حالة افتراضية لمحور order — حيث يبدأ منه دورة حياة الطلب. طالما لم يتم تعيين حالة افتراضية لمحور order، تعتبر البيانات غير صحيحة وحفظ المستودع محظور.

إنشاء حالة​

لإنشاء حالة جديدة للطلب، افتح قسم الطلبات في القائمة اليسرى. اختر من القائمة مستودع الطلبات الذي تريد إنشاء حالة جديدة فيه واضغط على أيقونة التحرير Edit. انتقل إلى قسم "حالات الطلبات".

في كتلة إنشاء حالة جديدة، املأ:

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

بعد ملء الحقول، اضغط على زر "إضافة". إذا تم إدخال جميع البيانات بشكل صحيح، سيتم حفظ الحالة تلقائيًا وإضافتها إلى القائمة العامة.

تعديل الحالة​

لإجراء تغييرات على حالة الطلب الموجودة، افتح قسم الطلبات في القائمة اليسرى. اختر من القائمة مستودع الطلبات الذي تريد إنشاء حالة جديدة فيه واضغط على أيقونة التحرير Edit. انتقل إلى قسم "حالات الطلبات".

اختر من القائمة الحالة التي تريد تعديلها واضغط على أيقونة التحرير Edit. يمكنك تغيير اسم الحالة وعلامتها.

من المهم أن نفهم

إذا كانت الحالة مستخدمة بالفعل في تطبيقك، قم بتغيير العلامة فقط إذا كنت متأكدًا تمامًا من أن ذلك لن يؤثر على عمل التطبيق.

القيمة الافتراضية​

يمكنك اختيار واحدة من الحالات كقيمة افتراضية. سيتم تعيين الحالة التي تحمل هذه العلامة في كل مرة لا يتم فيها تعيين حالة أخرى.

لجعل الحالة حالة افتراضية، انتقل إلى إعدادات الحالة بالضغط على أيقونة التحرير Edit. قم بتفعيل الخيار "القيمة الافتراضية".

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

حذف الحالة​

لحذف حالة الطلب، افتح قسم الطلبات في القائمة اليسرى. اختر من القائمة مستودع الطلبات الذي تريد إنشاء حالة جديدة فيه واضغط على أيقونة التحرير Edit. انتقل إلى قسم "حالات الطلبات".

اختر من القائمة العامة حالة الطلب التي تريد حذفها. اضغط على أيقونة الحذف Edit. أكد الإجراء في النافذة المنبثقة. سيتم حذف الحالة من القائمة، وكذلك من الطلبات التي تم استخدامها فيها.

الوضع المتقدم​

الوضع المتقدم (Advanced) مخصص لسيناريوهات معالجة الطلبات المعقدة، عندما لا تكون مجموعة خطية واحدة من الحالات كافية. إنه يقسم الحالات إلى ثلاثة محاور مستقلة ويسمح بإعداد الانتقالات التلقائية بين الحالات بناءً على المحفزات.

لتفعيل الوضع المتقدم، في كتلة "إعداد وضع حالة الطلب"، اختر الخيار Advanced ووافق على التبديل.

ثلاثة محاور للحالات​

في الوضع المتقدم، كل طلب له ثلاثة محاور مستقلة للحالات:

  • order — الحالة التجارية الرئيسية للطلب.
  • fulfillment — تنفيذ الطلب (التجميع، الشحن، التسليم).
  • payment — حالة الدفع.

كل حالة تنتمي إلى محور واحد فقط. يتم إدارة المحورين order و fulfillment من قبل البائع (يدويًا أو من خلال التكامل)، بينما يتم إدارة المحور payment تلقائيًا بواسطة النظام بناءً على أحداث الدفع.

من المهم أن نفهم

لا يمكن حذف الحالة التي تم استخدامها في خريطة الانتقالات أو المعينة لأي طلب.

إنشاء حالة في الوضع المتقدم​

يتم إنشاء الحالة بنفس الطريقة كما في الوضع الأساسي، ولكن في نموذج الإنشاء يظهر حقل إضافي لاختيار المحور الذي تنتمي إليه الحالة (Order status، Fulfillment أو Payment). في القائمة العامة للحالات، يتم عرض عمود إضافي "المحور"، الذي يوضح انتماء كل حالة.

خرائط الحالات​

عند تفعيل الوضع المتقدم، تظهر علامة "حالات الطلبات" → "تخطيط الحالة" (خرائط الحالات). تقوم الخريطة تلقائيًا بتحويل حالة محور order أو fulfillment بناءً على المحفز. على سبيل المثال، عند المحفز payment.paid، يتم تحويل حالة محور order إلى "مدفوع".

يتم تقسيم إعداد الخريطة إلى علامات فرعية حسب المحاور (Order status و Fulfillment). لكل محفز، يتم تجميعه حسب الفئات (أحداث الطلب، الدفع، والإرجاع)، يتم تحديد الحالة المستهدفة التي يجب أن ينتقل إليها الطلب. يتم أخذ الحالة الابتدائية من الحالة الافتراضية للمحور المعني.

بعد إعداد الخريطة، اضغط على زر "حفظ".

معلومات

يمكن تغيير حالات المحاور order و fulfillment يدويًا أو من خلال التكامل. بينما يتم إدارة المحور payment فقط بواسطة النظام بناءً على أحداث الدفع.

المحفزات المخصصة​

في علامة خرائط الحالات، يمكنك إنشاء محفزات مخصصة من نوع custom.{name}. يتم استدعاء هذه المحفزات فقط من خلال تكامل API ومتاحة للمحاور order و fulfillment. وهذا يسمح بوصف انتقالات الحالات لأحداث الأعمال غير القياسية في تطبيقك.