Errores y razones

Un error identifica una operación fallida. Sus razones explican por qué falló y pueden agrupar otras razones. Así se conserva tanto el contexto general como las causas concretas.

Error: no se pudo importar el libro
└── Razón: hoja Clientes
    └── Razón: fila 12
        └── Razón: el correo es obligatorio

El mensaje sirve para comunicar el fallo; los metadatos y las propiedades conservan datos para consultarlo. Construir este árbol no ejecuta una validación ni lee un archivo: describe un fallo que la aplicación ya detectó.

Dos formas de organizar las razones

	Estructura libre	Estructura fija o tipada
Construcción	Error y Reason	Una familia de clases con padres declarados
Organización	El productor decide los niveles en cada caso	Los tipos expresan las relaciones permitidas
Datos	Mensajes, metadatos y posibles clases propias	Propiedades y códigos de cada tipo
Consumidores	Comparten convenciones sobre los nodos	Reconocen tipos y propiedades
Cuándo usarla	Fallos puntuales o estructura variable	Diagnósticos con una organización reutilizable

Fija significa que las relaciones están declaradas por tipos. No significa un número fijo de nodos ni una lista cerrada de causas: puedes ampliar una familia con nuevas razones compatibles.

Recorrido recomendado

1. Aprende la estructura libre y cómo agregar razones.
2. Compara estructura libre y fija.
3. Conoce el contrato de las estructuras fijas.
4. Usa las familias existentes de dominio o procesos.
5. Aprende a crear tu propia estructura y aplícala a Excel.

Usar el diagnóstico

Una vez construido, puedes devolverlo desde un método, recorrer sus causas o referenciar una causa como error. Estas operaciones complementan ambos estilos de organización.

Para elegir entre buscar un tipo, enumerar hojas o consultar metadatos, continúa con buscar errores y razones.