تعديل الخطوات وإدارتها باستخدام الإصدارات

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

تشمل التغييرات التي يجب استخدام الإصدارات لها ما يلي:

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

لتنفيذ نظام تحديد الإصدار، حدِّد current_version وmin_version في ملف بيان الخطوة.

  • current_version: رقم إصدار عملية النشر النشطة الحالية.
  • ‫min_version: هو أقدم إصدار متوافق من الخطوة.

يوضّح مثال البيان التالي كيفية تحديد إصدارات لإحدى الخطوات:

JSON

...
"flows": {
     "workflowElements": [
       {
         "id": "...",
         "state": "...",
         "name": "...",
         "description": "...",
         "version" : {
           "current_version": 3,
           "min_version" : 1
         },
...

أثناء التنفيذ، يمكنك استرداد رقم الإصدار من عنصر الحدث وتحديد سلوك مخصّص لكل إصدار.

برمجة التطبيقات

/**
 * Executes the step and handles different versions.
 * @param {Object} event The event object from the workflow.
 */
function onExecute(event) {
  // Get the version ID from the execution metadata.
  const versionId = event.workflow.executionMetadata.versionId;

  // Implement different behavior based on the version.
  if (versionId < 2) {
    // Handle earlier versions
  } else {
    // Handle current and newer versions
  }
}