Gdy opublikujesz nową wersję kroku, istniejące agenty, 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 takich zmian jak:
- 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 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
}
}