Aktualizowanie kroków i zarządzanie nimi za pomocą wersji

Gdy opublikujesz nową wersję kroku, dotychczasowe przepływy, które go zawierają, nie zostaną automatycznie zaktualizowane. Aby po opublikowaniu kroku zachować obsługę poprzedniego działania, użyj wersji.

Zmiany, w przypadku których należy użyć wersji:

  • dodawanie nowych pól wymaganych,
  • wycofywanie pól wejściowych lub wyjściowych,
  • zmienianie typów danych, np. ciąg znaków, liczba zmiennoprzecinkowa lub liczba całkowita,
  • modyfikowanie podstawowego działania kroku.

Aby wdrożyć wersjonowanie, w pliku manifestu kroku określ current_version i min_version.

  • current_version: numer wersji bieżącego aktywnego wdrożenia.
  • min_version: najstarsza obsługiwana wersja kroku.

Poniższy przykład manifestu pokazuje, jak zdefiniować wersje kroku:

JSON

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

Podczas wykonywania możesz pobrać numer wersji z obiektu zdarzenia i zdefiniować niestandardowe działanie dla każdej wersji.

Apps Script

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