Actualiza y administra pasos con versiones

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

Entre los cambios para los que debes usar versiones, se incluyen los siguientes:

  • Se agregaron campos obligatorios nuevos
  • Baja de campos de entrada o salida
  • Alterar tipos de datos, como cadena, flotante o entero
  • Cómo 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 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
  }
}