--- title: Cómo leer el mapa de relaciones slug: como-leer-mapa-de-relaciones description: Guía para descubrir el ecosistema de gobierno, analizar impacto y navegar relaciones técnicas. audiencia: Administrador | Data Owner | Data Steward | Ingeniero de datos | Usuario roles: Consulta según alcance; acciones de administración según capacidad modulo: Explorador de relaciones estado: Comportamiento actual validado revision: "2026-10-19" section: guias order: 20 sources: - "Cómoleerelmapaderelaciones.md" --- # Cómo leer el mapa de relaciones 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: ```text 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: ```text 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: ```text Dominio ↓ Subdominio ↓ Entidad ↓ Atributo ``` A los costados aparecen los objetos relacionados: ```text 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 - [Modelo de objetos y relaciones](/es/explicaciones/modelo-de-objetos-y-relaciones/) - [Roles, capacidades y alcance](/es/referencia/roles-capacidades-y-alcance/) - [Módulos y dependencias](/es/referencia/modulos-y-dependencias/) ## 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.