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

Gdy opublikujesz nową wersję kroku, istniejące ścieżki użytkownika, które go zawierają, nie zostaną automatycznie zaktualizowane. Po opublikowaniu kroku, aby zachować obsługę poprzedniego działania, użyj wersji zmian.

Wersje należy stosować w przypadku tych zmian:

  • Dodawanie nowych wymaganych pól
  • Wycofywanie pól wejściowych lub wyjściowych
  • zmiana typów danych, takich jak 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_versionmin_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 określić niestandardowe działanie dla każdej wersji.

Google 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
  }
}