Cargolake
المساعدة والأدلة/الشحنات

تنفيذ انتقال

كيف تنتقل الشحنة من خطوة للتالية، وما الذي قد يمنعها، وما يحدث تلقائيًا بعدها.

الانتقال حركة معرَّفة من خطوة في مسار العمل إلى أخرى. وهو كيف تتقدّم الشحنة — لا تعدّل الخطوة، بل تنفّذ الانتقال، فيسجّل النظام من فعل ذلك ومتى.

التنفيذ

افتح الشحنة واختر انتقال. لا ترى إلا الانتقالات المتاحة من خطوتها الحالية، ومن بينها ما يُسمح لك بتنفيذه فقط.

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

لماذا قد لا يُعرض انتقال

السببما تفعله
لا يبدأ من خطوة الشحنة الحاليةراجع الخطوة التي تقف فيها الشحنة فعلًا.
لست من مشغّليه المصرّح لهمكل انتقال يحدد من يجوز له تنفيذه. اسأل من يملك ذلك.
معطَّلأوقفه أحدهم في الإعدادات.
شرط مسبق لم يتحققشيء يشترطه الانتقال لم يصر صحيحًا بعد — انظر أدناه.

الشروط المسبقة

يمكن أن يحمل الانتقال شروطًا مسبقة: فحوصًا يجب أن تنجح قبل تنفيذه. وهكذا تُفرَض العملية بدل مجرد وصفها — فلا تبلغ الشحنة جاهزة للإفراج إن لم تتحقق فحوص تلك الخطوة.

والفشل يظهر كـ "Preconditions not met for transition …". والإصلاح في البيانات التي يفحصها الشرط لا في الانتقال: املأ الناقص على الشحنة وأعد المحاولة.

أما رسالة مختلفة — "Error checking precondition (…)" — فتعني أن الفحص نفسه تعذّر تشغيله. وهذا عطل إعدادات أو نظام لا نقص بيانات، وينبغي تصعيده لا الالتفاف حوله.

الإجراءات اللاحقة — ما يحدث تلقائيًا

إتمام الانتقال قد يُطلق إجراءات لاحقة. وهي تعمل نيابةً عنك، ولهذا يستحق الانتقال أن يُستخدم كما ينبغي:

الإجراء اللاحقالأثر
إشعار بالبريديرسل رسالة — للعميل أو الوكيل أو فريق داخلي.
تحديث كيانيكتب قيمًا على الشحنة أو سجل مرتبط.
توليد قالبيُنتج مستندًا من قالب.
توليد XMLيُنتج رسالة XML لنظام خارجي.
استدعاء خدمةيُشغّل جزءًا آخر من المنصة.

فالانتقال الواحد قد يضبط تاريخ المغادرة الفعلية، ويُصدر بوليصة الشحن، ويراسل المرسل إليه، ويبلّغ الجمارك — كلها من فعل واحد. وهذا هو سبب تحريك الشحنات بالانتقالات لا بتعديل الحقول. فالتعديل يغيّر السجل؛ أما الانتقال فيغيّر السجل ويؤدي كل ما يُفترض أن يصاحبه.

فإن لم يُنتَج مستند أو لم يُرسل بريد، فالسؤال الأول: هل حرّك أحدهم الشحنة يدويًا؟ وإن كان الانتقال قد نُفِّذ فعلًا، فابحث عن "Post action execution failed for type …" — فالخطوة تمّت ولم يتم ما يليها، أي أن الشحنة تقدّمت بينما لم يحدث المستند أو الإشعار. وهذا هو نمط الفشل الجدير بالمراقبة: الشحنة تبدو صحيحة وشيء لاحق مفقود بصمت.

والإجراءات المولّدة للمستندات لها متطلبات إعداد خاصة — يجب توفر قالب لنوع الكيان المعني، والمستند المحفوظ يحتاج مسارًا يُحفظ فيه. وتلك الأخطاء تذكر اسم القالب، فخذ الاسم إلى من يصونها.

تنفيذ انتقال على عدة شحنات دفعة واحدة

يمكن تنفيذ الانتقالات بالجملة. والقاعدة الكل أو لا شيء على خطوة البداية:

كل شحنة مختارة يجب أن تكون في خطوة من الخاصة بالانتقال بالفعل. فإن لم تكن إحداها كذلك، تُرفض العملية كلها بـ "Some shipments are not in the expected step …"، مع تفاصيل أيها.

ولا يُطبَّق شيء جزئيًا — فالشحنات المؤهلة لا تتحرك هي الأخرى. صحّح الشاذة أو ألغِ اختيارها ونفّذ من جديد.

ورفض مرتبط، "Some shipments not found"، يسرد المعرّفات التي تعذّر إيجادها. ويعني ذلك عادةً اختيارًا جرى على قائمة قديمة.

الانتقالات على كيانات أخرى

الانتقالات ليست حكرًا على الشحنات. فلـالحاويات والشحنات الرئيسية والرحلات شاشات انتقال خاصة، تحرّكها مساراتها. ويمكن للحاوية أن تمر بعملية ساحة مستقلةً عن الشحنة التي تخصّها. راجع الشحنات الرئيسية والحاويات والرحلات.

ما يحمله الانتقال (لمسؤولي النظام)

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

والنماذج تُبنى بـمنشئ النماذج.

ملاحظة على تصميم الانتقالات

اطلب الحد الأدنى عند كل خطوة. فنموذج انتقال بعشرين حقلًا، أغلبها لا يعرفه المشغّل بعد، يُملأ بقيم صورية — والقيم الصورية أسوأ من الفراغات، لأن ما بعدها لا يميّزها.

إن كانت الشحنة عالقة

  1. راجع خطوتها الحالية في سجل الشحنة.
  2. انظر ما الانتقالات الموجودة من تلك الخطوة — يستطيع مسؤول النظام رؤيتها على مسار العمل.
  3. إن وُجد انتقال ولم يُعرض لك، فالسبب المشغّلون أو مفعّل.
  4. إن عُرض وفشل، فالسبب شرط مسبق — والرسالة تخبرك بأيّها.
  5. إن لم يغادر أي انتقال تلك الخطوة، فالمسار به طريق مسدود ويحتاج إصلاحًا. راجع مسارات العمل.

آخر تحديث ١٠ أغسطس ٢٠٢٦