Actualiza y administra pasos con versiones

Para mantener la compatibilidad con el comportamiento anterior después de publicar un paso, usa versiones para los cambios. Cuando publicas una versión nueva de tu paso, los flujos existentes que incluyen el paso no se actualizan automáticamente.

Usa el control de versiones para los siguientes cambios:

  • Se agregaron campos obligatorios nuevos
  • Baja de campos de entrada o salida
  • Alterar tipos de datos, como cadena, flotante o entero
  • Modificar el comportamiento fundamental de un paso

Para implementar el control de versiones, especifica current_version y min_version en el archivo de manifiesto de tu paso.

  • current_version: Es el número de versión de la implementación activa actual.
  • min_version: Es la versión compatible más antigua del paso.

En el siguiente ejemplo de manifiesto, se muestra cómo definir versiones para un paso:

JSON

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

Durante la ejecución, puedes recuperar el número de versión del objeto de evento y definir un comportamiento personalizado para cada versión.

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