Funciones de gestión del cambio

Prev Next

Who can use Functions

As of r380, Functions is generally available.

Read more in the Community thread.


Cambios en las entradas o salidas

Breaking change alert:

Adding, removing, or renaming inputs and outputs requires changes to app trigger actions that call the function.

Sigue este proceso para modificar la firma de una función:

  1. Diseña cuidadosamente la estructura de entradas y salidas antes de implementar la función a gran escala.
  2. Entradas: cuando crees una función para generar un nuevo registro en una tabla, ten en cuenta todas las columnas típicas que la función debería rellenar al crear el registro, no solo las columnas correspondientes al primer caso de uso.
  3. Salidas: entre las salidas habituales que puede incorporar a una función se incluyen:
    • ID de los registros de la tabla que crea la función
    • Mensajes visibles para el operador (asignados a una variable por la lógica de la función)
  4. Notifica a todos los desarrolladores de aplicaciones antes de realizar cambios.
  5. Actualiza la función de forma sistemática:
  6. Modifica la función.
  7. Prueba la función con el botón «Probar» utilizando entradas representativas.
  8. Prueba la función de principio a fin en una aplicación de desarrollo.
  9. Actualiza cada aplicación para asignar las nuevas entradas y salidas.
    • A partir de la versión r351, la visibilidad sobre dónde se utiliza una función es limitada (tanto en qué aplicaciones como en qué parte de una aplicación). Desde la pestaña «Versiones» de una aplicación, puedes ver qué funciones utiliza una versión.
    • Para las aplicaciones que utilizan una función, haz clic en el botón «Ver errores» en el editor de aplicaciones. Aparecerá una ventana modal que muestra las referencias a funciones de la aplicación que no funcionan correctamente.
  10. Prueba cada aplicación en modo desarrollador.
  11. Publica las aplicaciones.

Enfoque alternativo para cambios importantes

Crea una nueva función con una firma actualizada y migra las aplicaciones de forma gradual:

  1. Crea una nueva versión de la función con nuevas entradas (por ejemplo, CreateSample_v2).
  2. Migrar las aplicaciones de alta prioridad a la nueva versión.
  3. Migrar las aplicaciones restantes a lo largo del tiempo.
  4. Marcar como obsoleta y archivar la versión antigua de la función.

Modificar la lógica interna de la función

Info

Changes to internal function logic (decision trees, calculations, table operations) do not break apps. However, you need to publish apps with a new version to associate the new function logic.

Sigue este proceso:

  1. Actualiza la lógica de la función.
  2. Prueba la función con el botón «Probar» utilizando entradas representativas.
  3. Prueba la función de principio a fin en una aplicación de desarrollo.
  4. Publica una nueva versión de « version » de las aplicaciones para asociarla a la función actualizada.
  5. Supervisa las aplicaciones de producción para detectar comportamientos inesperados.

Práctica recomendada: utiliza un procedimiento de flujo de trabajo de aprobación para las funciones utilizadas en las aplicaciones de producción.


Recursos adicionales

{{snippet.Recursos adicionales sobre funciones: biblioteca y comunidad}}

{{snippet.¿Has encontrado lo que buscabas?}}