Guías

Cómo leer el mapa de relaciones

Guía para descubrir el ecosistema de gobierno, analizar impacto y navegar relaciones técnicas.

Descargar Markdown
  1. Antes de empezar
  2. La franja de ruta es el selector de contexto
  3. Panorama: entender el ecosistema
  4. Impacto: analizar un objeto elegido
  5. Detalle técnico: seguir la relación física
  6. Columna vertebral
  7. Cómo investigar un campo
  8. Qué significa una línea
  9. Filtros y profundidad
  10. Cuándo abrir Detalle
  11. Problemas frecuentes
  12. El mapa parece vacío
  13. Una tabla aparece pero no sus campos
  14. Aparecen dos líneas similares
  15. No puedo navegar a un nivel anterior
  16. Contenido relacionado
  17. Resultado esperado

El Explorador de relaciones ayuda a responder una pregunta concreta: ¿cómo se conecta este concepto de negocio con sus responsables, controles, fuentes técnicas y productos?

La taxonomía permanece como eje. No es un grafo libre en el que todos los objetos aparecen al mismo nivel.

Antes de empezar

  • El módulo Explorador de relaciones debe estar activo para la empresa.
  • Solo aparecen objetos del tenant y del alcance autorizado.
  • El mapa parte del objeto seleccionado o de una semilla válida del tenant cuando se abre sin selección.
  • Los atributos y campos se consultan progresivamente; no se cargan todos en el primer nivel.

La franja de ruta es el selector de contexto

La ruta superior funciona como el explorador de carpetas de Windows:

Empresa / Dominio / Subdominio / Entidad / Atributo / Repositorio / Campo
  • Cada segmento representa un nivel disponible.
  • Al hacer clic en un segmento se vuelve a ese nivel y se muestran los objetos relacionados de ese contexto.
  • Volver al nivel anterior sube un paso sin perder la vista actual.
  • Limpiar selección devuelve el mapa a la semilla general.
  • La misma franja muestra profundidad, filtros efectivos y cantidad de objetos/relaciones.

La ruta no abre el inspector automáticamente. Cambiar de contexto sirve para navegar; Detalle abre la información ampliada solo cuando se solicita.

Panorama: entender el ecosistema

Usa Panorama cuando todavía no sabes qué relación estás buscando.

  1. Selecciona un Dominio o Subdominio.
  2. Revisa la columna taxonómica: Entidades y Atributos.
  3. Observa los laterales: Términos, Reglas, Repositorios, Sistemas, Productos y Contratos.
  4. Haz clic en un objeto para cambiar el contexto del mapa.
  5. Usa la ruta superior para subir o volver a una carpeta conceptual anterior.

Panorama prioriza nombres y agrupaciones comprensibles. No intenta mostrar todos los campos físicos de una fuente.

Impacto: analizar un objeto elegido

Impacto responde qué alimenta al objeto y qué puede verse afectado si cambia.

  • Objeto analizado: se selecciona mediante el control visible de objeto raíz.
  • Upstream: orígenes o elementos que alimentan al objeto.
  • Downstream: productos, contratos, reglas, sistemas o procesos que dependen de él.
  • Filtros de impacto: reducen el resultado a categorías como Calidad, Productos, Contratos o Sistemas.
  • Profundidad: indica cuántos saltos se recorren desde el objeto raíz.

Ejemplo:

Atributo “Fecha de ingreso”
  ← Campo técnico en tabla académica
  ← Repositorio universitario
  → Regla de completitud
  → Contrato de datos
  → Producto de datos

Si no existe una ruta upstream o downstream real, la pantalla debe explicar esa ausencia. No debe inventar una dependencia por compartir solamente el mismo Dominio.

Detalle técnico: seguir la relación física

Detalle técnico está pensado para el Ingeniero de datos, el Steward y el Owner que necesitan comprobar la trazabilidad.

Columna vertebral

El centro conserva una jerarquía legible:

Dominio
  ↓
Subdominio
  ↓
Entidad
  ↓
Atributo

A los costados aparecen los objetos relacionados:

Atributo ↔ Regla de calidad
Atributo ↔ Campo del Diccionario técnico
Campo ↔ Repositorio / esquema / tabla / columna
Repositorio ↔ Sistema

Una Entidad o Repositorio puede mostrar filas internas de atributos o campos. La tarjeta enseña inicialmente hasta ocho filas; +N y el scroll interno permiten revisar el resto sin convertir todo el diagrama en cuadros ilegibles.

Cómo investigar un campo

  1. Selecciona la Entidad o Atributo en el eje central.
  2. Busca la tarjeta de Repositorio o Diccionario técnico.
  3. Comprueba el nombre de tabla y columna, esquema, tipo y estado de asociación.
  4. Sigue la línea hasta el Atributo taxonómico.
  5. Abre Detalle si necesitas la tabla completa de campos, origen o descripción.

El nombre funcional del Atributo se muestra en la interfaz. El código técnico se reserva para persistencia, validación, importación o SQL generado.

Qué significa una línea

Señal Significado
Línea hacia el centro taxonómico El objeto está relacionado con el contexto de negocio.
Línea desde un Atributo a un Campo Existe una asociación física documentada.
Línea entre Repositorio y Sistema El repositorio declara un sistema relacionado.
Línea hacia una Regla La Regla usa el Atributo o un campo asociado.
Línea hacia Producto/Contrato El objeto participa en una entrega o compromiso de datos.
Sin línea No existe una relación registrada; no debe inferirse solo por nombre.

Filtros y profundidad

Los filtros se aplican sobre el contexto activo, no sobre todo el tenant:

  • La profundidad 1 muestra relaciones directas.
  • La profundidad 2 permite seguir un salto adicional.
  • Las aristas equivalentes se muestran una sola vez.
  • Los filtros incompatibles con la raíz se deshabilitan para evitar un mapa vacío o engañoso.
  • Cambiar de nivel por la ruta recalcula la profundidad y los filtros válidos.

Cuándo abrir Detalle

No abras el panel lateral para cada clic. Mantén el canvas libre para navegar y usa Detalle cuando quieras:

  • leer descripción, ownership y estado;
  • revisar todos los atributos o campos;
  • consultar asociaciones técnicas y origen;
  • abrir la ficha completa del objeto.

Problemas frecuentes

El mapa parece vacío

Comprueba que exista un objeto raíz visible, que el módulo esté activo y que la profundidad/filtros sean compatibles. El sistema mantiene la raíz renderizada mientras carga y muestra un estado explicativo si no hay relaciones.

Una tabla aparece pero no sus campos

La tabla puede existir como Repositorio sin que todos sus campos estén en el Diccionario técnico o asociados a atributos. Abre Detalle y revisa el estado de cada campo; no asumas que la relación de tabla implica asociación de columnas.

Aparecen dos líneas similares

La interfaz deduplica relaciones equivalentes por par de objetos. Si dos líneas representan relaciones semánticamente distintas, la leyenda debe diferenciarlas; si son el mismo vínculo, debe mostrarse una sola.

No puedo navegar a un nivel anterior

Usa el segmento correspondiente de la ruta superior o Volver al nivel anterior. Limpiar selección vuelve a la semilla general sin cambiar de empresa.

Contenido relacionado

Resultado esperado

Puedes distinguir una asociación de negocio de una relación física registrada, navegar Panorama, Impacto y Detalle técnico y reconocer cuando una dependencia aún no está documentada.

Fuentes de esta documentación

  • Cómoleerelmapaderelaciones.md