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

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

Wersjonowania używaj w przypadku tych zmian:

  • Dodawanie nowych wymaganych pól
  • Wycofywanie pól wejściowych lub wyjściowych
  • zmienianie 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_version i min_version.

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

Poniższy przykład pliku 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.
 */
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
  }
}