Manipulación de Entidades

¿Qué es la Manipulación de Entidades?

En DatAscend, manipular una entidad se refiere a realizar acciones sobre los registros de una entidad existente, como editar, eliminar o filtrar dichos registros.

Esto también incluye gestionar las relaciones que conectan los registros con otras entidades, permitiendo a los administradores, configuradores y usuarios de negocio mantener datos precisos y organizados en todo el sistema.

Manipulando Registros de Entidad

Esta sección cubre las operaciones básicas de registros como filtrar, editar y eliminar.

Accediendo a los Registros de Entidad

1. Para acceder a los registros de una entidad, utiliza el menú de navegación izquierdo en la barra lateral.
2. Cada elemento en el menú representa una entidad (por ejemplo: Desk, Worksheet, o Project).
3. Haz clic en la entidad deseada para ver su tabla de registros.

Entendiendo la Tabla de Registros de Entidad

Cuando se selecciona una entidad, se mostrará una tabla de registros con las siguientes áreas clave:

• Filtros: Para buscar o acotar registros por valores de campo.
• Menú de Columnas: Permite mostrar u ocultar columnas específicas.
• Acciones: Cada fila contiene acciones contextuales como Editar y Eliminar.
• Controles de Paginación: Gestiona el número de filas visibles por página.

Filtrando Registros

El filtrado te permite localizar registros específicos basados en ciertos criterios de campo.

1. En la sección de Filtros, escribe o selecciona un valor (ej., “Store” en Filtrar por Ubicación).
2. Haz clic en Aplicar Filtros para refrescar la tabla con los registros coincidentes.
3. Para limpiar los filtros, haz clic en Limpiar.

✅ Buena Práctica: Usa los filtros antes de editar o eliminar para asegurarte de que estás trabajando con el subconjunto correcto de registros.

Visibilidad de Columnas

Puedes personalizar qué campos aparecen en la tabla de registros:

1. Haz clic en el botón Columnas sobre la tabla.
2. Marca o desmarca los campos que deseas mostrar u ocultar.
3. La tabla se actualizará inmediatamente.

Editando Registros de Entidad

Para modificar un registro existente:

1. En la tabla de registros de la entidad, localiza el registro que quieres editar.
2. Haz clic en el botón Editar junto a ese registro.
3. Serás redirigido a la vista de edición del registro.
4. Realiza los cambios necesarios en los campos disponibles.
5. Haz clic en Actualizar para guardar tus cambios.

⚠️ Nota: Algunos campos pueden estar bloqueados dependiendo de tu rol o de la configuración de la entidad (ej., campos gestionados por el sistema o propiedades de solo lectura).

Gestionando Dominios y Propiedad

Mientras editan un registro, los administradores también pueden gestionar asignaciones de dominio y propiedad.

Cambiar Dominio

1. Haz clic en el menú de tres puntos (⋮) en la esquina superior derecha del editor de registros.
2. Selecciona Cambiar Dominio.
3. Aparecerá un modal de confirmación advirtiendo que las relaciones se eliminarán al cambiar de dominio.
4. Elige el nuevo dominio y haz clic en Guardar.

⚠️ Advertencia: Cambiar de dominio elimina permanentemente todas las relaciones ligadas a ese registro. Procede solo si estás seguro de que este registro debe moverse a otro dominio.

Cambiar Propietario

1. Abre el mismo menú de tres puntos (⋮) y selecciona Cambiar Propietario.
2. Elige el nuevo propietario de la lista desplegable.
3. Haz clic en Guardar para asignar la propiedad.

💡 Consejo: Usa esta función cuando transfieras la responsabilidad de un registro a otro administrador o usuario del dominio.

Eliminando Registros de Entidad

Para eliminar un registro:

1. En la tabla de entidad, localiza el registro que deseas eliminar y haz clic en el botón Eliminar. Esto resalta la fila y abre un mensaje de confirmación.

2. Aparecerá un modal de confirmación preguntando si estás seguro.
3. Haz clic en Eliminar para confirmar la acción.

⚠️ Advertencia: Eliminar un registro es permanente y no se puede deshacer. Si el registro tiene relaciones (ej., tareas, usuarios o entidades relacionadas vinculadas), asegúrate de que esas relaciones no sean requeridas en otro lugar.

---

Gestionando Relaciones entre Entidades

Las relaciones de entidad te permiten conectar registros a través de múltiples entidades dentro del mismo dominio. Entender y gestionar estas relaciones asegura datos consistentes, precisos y soporta modelos de datos complejos.

Tipos de Relación

DatAscend soporta los siguientes tipos de relación:

• Uno a Uno (1:1)
• Uno a Muchos (1:N)
• Muchos a Uno (N:1)
• Muchos a Muchos (N:N)

Cada tipo determina cómo interactúan los registros y cómo aparecen en el editor de registros.

Trabajando con Relaciones

Accediendo a Registros Relacionados

Cuando abres un registro que tiene relaciones configuradas, verás pestañas de relación además de la pestaña de información básica:

• “Información Básica”: Contiene los campos propios de la entidad.
• “[Entidad Padre] ← [Entidad Hija]”: Para relaciones Uno-a-Muchos (ej., “Desk ← Worksheet”).
• “[Nombre de la Relación]”: Para relaciones Muchos-a-Muchos (ej., “One and three”).

Cada pestaña de relación muestra una tabla de registros relacionados con:

• Controles de filtro para acotar resultados.
• Opciones de visibilidad de columnas.
• Botones de acciones (Editar, Remover).
• Opción para agregar nuevos registros relacionados.

Navegación con Breadcrumbs

Cuando trabajas con relaciones anidadas, DatAscend muestra breadcrumbs contextuales en la parte superior de la página para ayudarte a navegar:

Ejemplos:

• Editar - Desk (Kaiser) → Editando un registro Desk llamado “Kaiser”.
• Editar - Desk (Kaiser) | Worksheet → Viendo Worksheets relacionados al Desk “Kaiser”.
• Editar - Desk (Kaiser) | Editar - Worksheet (Hoshino) → Editando un Worksheet “Hoshino” que pertenece al Desk “Kaiser”.
• Desk | Worksheet | Project → Creando un nuevo Project desde un Worksheet que pertenece a un Desk.

Consejos de Navegación:

• Haz clic en cualquier nivel del breadcrumb para navegar de regreso a ese contexto.
• El breadcrumb te ayuda a entender tu ubicación actual en relaciones anidadas.
• El sistema preserva tu ruta de navegación al moverte entre entidades relacionadas.

Creando y Vinculando Registros Relacionados

Método 1: Vincular Registros Existentes

Al editar un campo de relación (ej., seleccionar un Proyecto para un Desk):

1. Haz clic en el menú desplegable del campo de relación (ej., “Project”).
2. Aparecerá un panel de búsqueda con:
   • Caja de búsqueda: Escribe para encontrar registros existentes.
   • Opciones disponibles: Lista de registros que puedes vincular.
3. Selecciona el registro que quieres vincular.
4. Haz clic en Actualizar para guardar la relación.

Ejemplo: Vinculando un Desk a un Proyecto existente

• El desplegable muestra Proyectos disponibles: “Atrasis Simulator”, “Divi:sion”, “Blackmarket”, “Ruins”.
• Busca para filtrar opciones.
• Selecciona el Proyecto deseado.
• Guarda para establecer el vínculo.

Método 2: Crear Nuevos Registros Relacionados

En lugar de vincular un registro existente, puedes crear un nuevo registro directamente desde el campo de relación:

1. Haz clic en el menú desplegable del campo de relación.
2. Haz clic en la opción “Agregar nuevo registro [Entidad]” (en rojo).
3. Se abrirá un nuevo formulario para crear el registro relacionado.
4. Rellena los campos requeridos.
5. Haz clic en Agregar o Actualizar para guardar.
6. El nuevo registro se vincula automáticamente al padre.

Beneficios:

• Acelera la entrada de datos reduciendo el cambio de contexto.
• Asegura que la relación se establezca inmediatamente.
• Mantiene la consistencia de los datos.

Método 3: Agregar desde Pestañas de Relación

Cuando ves una pestaña de relación (ej., “Desk ← Worksheet”):

1. Navega a la pestaña de relación.
2. Haz clic en el botón “Agregar [Entidad]” (ej., “Agregar Worksheet”).
3. Rellena el formulario del nuevo registro.
4. La relación padre se establece automáticamente.
5. Guarda para agregar el registro a la relación.

Nota: La entidad padre (ej., Desk) se vincula automáticamente al crear desde una pestaña de relación.

Quitando una Selección de Relación

Para desvincular un registro sin eliminarlo:

1. Abre el menú desplegable del campo de relación.
2. Haz clic en ”✕ Quitar selección”.
3. La relación se eliminará, pero ambos registros permanecerán en el sistema.
4. Guarda para confirmar.

Importante: Esto solo quita el vínculo entre registros; ninguno de los registros se elimina.

Editando Registros Relacionados

Desde la Pestaña de Relación

1. Navega a la pestaña de relación (ej., “Desk ← Worksheet”).
2. Localiza el registro que quieres editar en la tabla.
3. Haz clic en el botón “Editar” junto al registro.
4. Modifica los campos según sea necesario.
5. Haz clic en “Actualizar” para guardar los cambios.

Navegación con Breadcrumb:

• Al editar un registro relacionado, el breadcrumb muestra tu ruta.
• Ejemplo: Editar - Desk (Kaiser) | Editar - Worksheet (Hoshino).
• Esto te ayuda a entender que estás editando un Worksheet que pertenece a un Desk específico.

Edición de Relaciones Anidadas

DatAscend soporta la edición de relaciones multinivel:

Ejemplo de Flujo:

1. Editar un registro Desk (breadcrumb: Desk).
2. Navegar a la pestaña Worksheet (breadcrumb: Desk | Worksheet).
3. Crear o editar un Worksheet (breadcrumb: Desk | Worksheet).
4. Desde dentro del Worksheet, editar o crear un Project (breadcrumb: Desk | Worksheet | Project).

Este enfoque anidado te permite:

• Trabajar con datos profundamente relacionados sin perder el contexto.
• Mantener la integridad referencial a través de múltiples niveles.
• Navegar de regreso a cualquier nivel usando los breadcrumbs.

Eliminando Registros Relacionados

Entendiendo “Remover” (Desvincular) vs “Eliminar”

DatAscend proporciona dos acciones diferentes para gestionar registros relacionados:

🔗 Remover (Desvincular)

• Quita la relación entre dos registros.
• NO elimina ninguno de los registros de la base de datos.
• Ambos registros continúan existiendo independientemente.
• El vínculo puede ser reestablecido más tarde si es necesario.

Cuándo usarlo:

• Cuando quieres disociar registros pero mantener ambos.
• Cuando podrías necesitar vincularlos de nuevo en el futuro.
• Cuando estás reorganizando relaciones.

❌ Eliminar

• Elimina permanentemente el registro relacionado de la base de datos.
• No se puede deshacer o reestablecer.
• La relación también se elimina.
• Puede afectar otras relaciones si el registro eliminado tiene dependencias.

Cuándo usarlo:

• Cuando el registro ya no se necesita en el sistema.
• Cuando estás seguro de que no se necesitará de nuevo.
• Cuando has verificado que no tiene dependencias críticas.

⚠️ Advertencia: Eliminar es permanente y no se puede deshacer.

Cómo Remover (Desvincular) Registros

1. Navega a la pestaña de relación.
2. Localiza el registro en la tabla de registros relacionados.
3. Haz clic en “Remover” junto al registro.
4. La relación se quita, pero el registro aún existe en el sistema.

Cómo Eliminar Registros Relacionados

⚠️ Advertencia: Esta acción es permanente y no se puede deshacer.

1. Navega a la pestaña de relación.
2. Localiza el registro que quieres eliminar.
3. Haz clic en “Eliminar” (si está disponible).
4. Confirma la eliminación en el modal.
5. El registro se elimina permanentemente de la base de datos.

Detalles de Tipos de Relación

Relación Uno a Uno (1:1)

Cada registro en una entidad se vincula a exactamente un registro en otra entidad.

Ejemplo: Un Desk está vinculado a un único Project.

Cómo funciona:

1. Abre un registro Desk.
2. Localiza el campo relacionado Project en “Información Básica”.
3. Selecciona un Proyecto existente o crea uno nuevo.
4. Guarda los cambios — ambos registros permanecen sincronizados.

Nota Técnica: DatAscend fuerza esto con una llave foránea única (unique foreign key) asegurando solo un vínculo por registro.

Caso de Uso: Cada escritorio de estación de trabajo pertenece a exactamente un proyecto; editar cualquiera de los registros mantiene ambos sincronizados.

Relación Uno a Muchos (1:N)

Un registro padre puede tener múltiples registros hijos.

Ejemplo: Un Desk puede incluir varios registros Worksheet.

Cómo funciona:

1. Abre un registro Desk.
2. Navega a la pestaña “Desk ← Worksheet”.
3. Haz clic en “Agregar Worksheet” para añadir un nuevo registro hijo.
4. O haz clic en “Editar” para modificar un Worksheet existente.
5. La tabla muestra todos los Worksheets vinculados a este Desk.

Nota Técnica: Cada registro hijo almacena un campo de llave foránea (ej., desk_id) que referencia a su padre.

Caso de Uso: Una estación de trabajo puede tener múltiples informes de trabajo directamente bajo un registro de escritorio.

Relación Muchos a Uno (N:1)

Múltiples registros pueden referenciar a la misma entidad padre.

Ejemplo: Múltiples registros Worksheet pueden apuntar a un único Desk.

Cómo funciona:

1. Crea o edita un Worksheet.
2. En “Información Básica”, localiza el campo Desk.
3. Elige el Desk padre del menú desplegable o crea uno nuevo.
4. Guarda para establecer el vínculo.

Nota Técnica: Cada registro hijo contiene una llave foránea apuntando de regreso al padre.

Caso de Uso: Centralizar múltiples entradas de trabajo bajo un escritorio para mejor seguimiento y organización.

Relación Muchos a Muchos (N:N)

Registros en ambas entidades pueden relacionarse con múltiples registros en la otra entidad.

Ejemplo: Una Entidad Uno puede estar conectada a varios registros de Entidad Tres, y viceversa.

Cómo funciona:

1. Abre un registro de Entidad Uno.
2. Navega a la pestaña de relación (ej., “One and three”).
3. Haz clic en “Add Record” (Agregar Registro) para crear o vincular múltiples registros de Entidad Tres.
4. Cada Entidad Tres también puede vincularse de regreso a múltiples registros de Entidad Uno.

Nota Técnica: Gestionado a través de una tabla de unión (join table) que almacena pares de relaciones entre entidades.

Caso de Uso: Proyectos y empleados vinculados bidireccionalmente — un empleado puede pertenecer a múltiples proyectos, y un proyecto puede tener múltiples empleados.

Filtros en Tablas de Relación

Cuando ves una pestaña de relación con muchos registros, puedes usar filtros para acotar los resultados:

1. Usa los campos de filtro sobre la tabla (ej., “Filtrar por Worker:”, “Filtrar por Result Expectation:”).
2. Ingresa o selecciona valores de filtro.
3. Haz clic en “Aplicar filtros” para refrescar la tabla.
4. Haz clic en “Limpiar” para borrar todos los filtros.

Ejemplo: Filtrar Worksheets por “Worker” para ver solo los worksheets asignados a “Hoshino”.

Estados Vacíos

Cuando una pestaña de relación no tiene registros relacionados, el sistema muestra:

“No se encontraron datos.”

Esto indica:

• No hay registros vinculados actualmente.
• Puedes agregar nuevos registros usando el botón “Agregar [Entidad]”.
• La relación está configurada pero vacía.

Permisos y Restricciones de Dominio

Relaciones Limitadas por Dominio

CRÍTICO: Las relaciones en DatAscend solo pueden existir entre entidades en el mismo dominio.

• No puedes vincular un Desk del dominio “PRINCIPAL” con un Project del dominio “TestQA”.
• Cuando cambias el dominio de un registro, todas sus relaciones se eliminan permanentemente.
• Solo los usuarios que pertenecen al dominio pueden crear y gestionar relaciones.

🔐 Requisitos de Permisos

Para trabajar con relaciones, necesitas:

• Acceso de Lectura para ver registros relacionados en pestañas de relación.
• Acceso de Edición para vincular registros existentes o modificar relaciones.
• Acceso de Creación para agregar nuevos registros relacionados.
• Acceso de Eliminación para usar “Eliminar” en registros relacionados.
• Capacidad de Remover para desvincular registros (puede ser específico del rol).

Buenas Prácticas y Advertencias Críticas

✅ Cuándo Usar Cada Tipo de Relación

• 1:1: Úsalo para asociaciones únicas (ej., un escritorio = un código de proyecto).
• 1:N: Úsalo para jerarquías padre-hijo (ej., un escritorio tiene muchos reportes de trabajo).
• N:1: Úsalo cuando muchos hijos comparten un padre (ej., muchos reportes pertenecen a un escritorio).
• N:N: Úsalo para asociaciones flexibles (ej., empleados trabajan en múltiples proyectos).

✅ Navegación y Contexto

• Usa breadcrumbs para entender tu ubicación actual en relaciones anidadas.
• Navega de regreso a registros padre haciendo clic en los niveles del breadcrumb.
• Mantén un seguimiento de qué entidad estás editando para evitar confusión.

✅ Vincular vs Crear

• Vincula registros existentes cuando el registro relacionado ya existe en otro lugar.
• Crea nuevos registros desde campos de relación cuando necesitas agregar datos que aún no existen.
• Usa la función de búsqueda para encontrar rápidamente registros para vincular.

⚠️ Advertencias Críticas

• Cambios de Dominio: Cambiar el dominio de un registro elimina permanentemente todas sus relaciones. Procede solo si estás seguro de que el registro debe moverse a otro dominio.

• Eliminación de Registros: Eliminar un registro relacionado es permanente y no se puede deshacer. Si el registro tiene otras dependencias, asegúrate de que no sean requeridas en otro lugar antes de eliminar.

• Remover vs Eliminar: “Remover” quita la conexión. “Eliminar” destruye permanentemente el registro. Elige cuidadosamente basándote en si quieres mantener el registro en el sistema.

• Sincronización: Las actualizaciones a registros vinculados se sincronizan automáticamente a través de las relaciones. Cambiar el nombre de un Proyecto se actualizará en todos los lugares donde se haga referencia a ese Proyecto.

---

Resumen

Gestionar entidades en DatAscend implica:

• Manipulación Básica de Registros (Filtrar, Editar, Eliminar).
• Entender los tipos de relación (1:1, 1:N, N:1, N:N).
• Navegar con breadcrumbs para mantener el contexto.
• Crear o vincular registros a través de campos o pestañas de relación.
• Remover (Desvincular) vs Eliminar registros apropiadamente.
• Respetar los límites del dominio y los requisitos de permisos.

Al dominar estos conceptos, puedes construir ecosistemas de datos interconectados y confiables en DatAscend.