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

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

تشمل التغييرات التي يجب استخدام النُسخ لها ما يلي:

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

لتنفيذ نظام التحكّم في الإصدارات، حدِّد 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.
 */
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
  }
}