وقتی نسخه جدیدی از مرحله خود را منتشر می‌کنید، جریان‌های کاربری موجود که شامل آن مرحله هستند، به‌طور خودکار به‌روزرسانی نمی‌شوند. پس از انتشار یک مرحله، برای حفظ پشتیبانی از رفتار قبلی، از نسخه‌ها برای تغییرات استفاده کنید.
تغییراتی که باید برای آنها از نسخه‌ها استفاده کنید عبارتند از:
- اضافه شدن فیلدهای جدید و مورد نیاز
- منسوخ کردن فیلدهای ورودی یا خروجی
- تغییر انواع داده‌ها، مانند رشته، اعشار یا عدد صحیح
- اصلاح رفتار اساسی یک پله
برای پیاده‌سازی قابلیت نسخه‌بندی، current_version و min_version را در فایل مانیفست مربوط به هر مرحله مشخص کنید.
-
current_version: شماره نسخه استقرار فعال فعلی. -
min_version: قدیمی‌ترین نسخه پشتیبانی‌شده از مرحله.
مثال مانیفست زیر نحوه تعریف نسخه‌ها برای یک مرحله را نشان می‌دهد:
جی‌سون
...
"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
}
}