Cómo documentar versiones de reglas y transformaciones
Documenta cada versión de regla como una decisión reproducible: qué entrada interpreta, qué salida produce, desde cuándo aplica y quién aprobó el cambio.
Equipo enginerIT· 2 min de lectura
Documenta cada versión de regla como una decisión reproducible: qué entrada interpreta, qué salida produce, desde cuándo aplica y quién aprobó el cambio. Un número de versión sin ejemplos no permite explicar por qué dos registros similares acabaron de forma distinta. Conserva tanto el criterio anterior como el nuevo.
Diferencia regla, implementación y configuración
Una regla expresa el criterio del negocio; el código o los pasos del flujo lo ejecutan y los parámetros lo concretan para un entorno. Registra las tres referencias juntas sin confundirlas. En un ejemplo hipotético, decidir qué pedidos pasan a revisión es la regla; cambiar el identificador de la cola es configuración. Cada cambio necesita una explicación diferente para poder investigarlo después.
Añade ejemplos que expliquen la diferencia
Para cada revisión conserva una entrada que mantiene su resultado y otra que cambia. Describe el motivo con lenguaje que pueda revisar la persona responsable del proceso. Incluye tratamiento de valores desconocidos y excepciones. Si una modificación altera redondeos, muestra el valor de entrada y la salida acordada; una frase como «mejora de importes» no ayuda a reproducir una discrepancia.
Fija vigencia y tratamiento de pendientes
Decide si aplica según fecha del evento, recepción o ejecución. Elige conscientemente qué versión usarán los casos que ya estaban en cola. No cambies su interpretación por accidente al desplegar. Anota si un reintento conserva la regla original o necesita revisión humana. Esa decisión evita que la misma solicitud produzca resultados distintos solo por haberse repetido después de una actualización.
Relaciona la ficha con lo desplegado
Mantén historial de flujo y evidencia de despliegue, además de la ficha de negocio. Power Automate dispone de versiones para flujos de nube incluidos en soluciones, con condiciones propias de esa capacidad; no presupongas el mismo historial en cualquier herramienta. Registra la revisión efectiva en cada ejecución. Comprueba un caso antiguo desde su evidencia y verifica que puedes explicar su resultado sin depender de la memoria del autor.
Utiliza una ficha con identificador de regla, motivo, aprobador, vigencia y ejemplos afectados. Evita reutilizar el mismo identificador para criterios incompatibles. Si corriges la explicación sin cambiar comportamiento, anótalo como revisión documental; si alteras la decisión, crea una revisión de regla. Esa distinción ayuda a saber cuándo corresponde repetir pruebas y cuándo basta revisar la documentación.
Comprobaciones para cerrar la tarea
- ✓ Incluye ejemplos anteriores y posteriores al cambio.
- ✓ Define qué versión usan eventos pendientes y reintentos.
- ✓ Vincula aprobación, implementación y configuración.
- ✓ Reproduce la explicación de una ejecución antigua.
Fuentes y documentación
- Microsoft — Borradores y versiones — En flujos de nube incluidos en soluciones, una versión anterior puede recuperarse como borrador.
Aplicarlo en tu empresa
Podemos revisar el entorno y acordar qué actuaciones, validaciones y mantenimiento necesitas.
Conocer el servicio relacionado →