Cập nhật và quản lý các bước bằng phiên bản

Khi bạn xuất bản một phiên bản mới của bước, các luồng người dùng hiện có có chứa bước đó sẽ không được tự động cập nhật. Sau khi xuất bản một bước, để duy trì hỗ trợ cho hành vi trước đó, hãy sử dụng các phiên bản cho những thay đổi.

Những thay đổi mà bạn nên sử dụng phiên bản bao gồm:

  • Thêm các trường bắt buộc mới
  • Ngừng sử dụng các trường đầu vào hoặc đầu ra
  • Thay đổi kiểu dữ liệu, chẳng hạn như chuỗi, số thực hoặc số nguyên
  • Sửa đổi hành vi cơ bản của một bước

Để triển khai việc quản lý phiên bản, hãy chỉ định current_versionmin_version trong tệp kê khai của bước.

  • current_version: Số phiên bản của hoạt động triển khai hiện tại.
  • min_version: Phiên bản cũ nhất được hỗ trợ của bước này.

Ví dụ sau đây về tệp kê khai cho biết cách xác định các phiên bản cho một bước:

JSON

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

Trong quá trình thực thi, bạn có thể truy xuất số phiên bản từ đối tượng sự kiện và xác định hành vi tuỳ chỉnh cho từng phiên bản.

Apps Script

/**
 * 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
  }
}