Importación inicial de datos
Migre sus activos, empleados y contratos existentes a KaliaOps
KaliaOps proporciona herramientas de importación CSV para migrar rápidamente sus datos existentes. Importe sus activos, aplicaciones, empleados, organizaciones y contratos en pocos clics. El sistema valida automáticamente los datos, detecta duplicados y proporciona un informe detallado de errores. Mantenga un historial completo de sus importaciones para auditoría y seguimiento.
Entidades importables
KaliaOps permite importar las siguientes entidades mediante archivos CSV:
CMDB
- Activos
- Servidores, estaciones de trabajo, equipos de red, impresoras, periféricos. Incluye información de inventario, direcciones IP, números de serie y ubicación.
- Aplicaciones
- Software empresarial, servicios en la nube, bases de datos. Con versión, criticidad, propietario técnico y dependencias.
- Contratos
- Contratos de mantenimiento, licencias de software, SLAs de proveedores. Incluye fechas, importes y condiciones de renovación.
- Proveedores
- Proveedores y prestadores de servicios con datos de contacto, contactos e información legal.
Organización
- Organizaciones
- Entidades legales, filiales, departamentos, divisiones. Estructura jerárquica con responsables.
- Sitios
- Ubicaciones físicas: oficinas, centros de datos, almacenes. Con direcciones y zonas horarias.
- Equipos
- Equipos funcionales o de proyecto, asignados a una organización.
- Empleados
- Colaboradores con puesto, responsable, equipo y datos de contacto.
Preparar sus archivos
Formato CSV requerido
Sus archivos deben cumplir las siguientes especificaciones:
- Codificación: UTF-8 (obligatorio para caracteres acentuados)
- Separador: Coma (,) por defecto (RFC 4180)
- Encabezados: Primera línea con nombres de columnas
- Comillas: Valores que contienen el separador entre comillas dobles
- Tamaño máximo: 10 MB por archivo
Ejemplo de archivo de activos
name;asset_type;serial_number;ip_address;site_code;status
"SRV-PROD-01";server;"ABC123456";192.168.1.10;"MADRID-DC";active
"PC-CONTABILIDAD-001";desktop;"DEF789012";192.168.2.50;"MADRID-HQ";activeCampos obligatorios por entidad
| Entidad | Campos obligatorios |
|---|---|
| Activos | name, type, organization_id |
| Aplicaciones | name, organization_id |
| Empleados | code, first_name, last_name, email |
| Organizaciones | name |
| Sitios | name, city, country |
| Equipos | name, organization_id |
| Contratos | name, supplier_id, type, start_date, end_date |
| Proveedores | name |
Proceso de importación
Acceda a la herramienta de importación
En el menú lateral, haga clic en Administración → Importaciones. Seleccione el tipo de entidad que desea importar.
Cargue su archivo
Haga clic en «Seleccionar archivo» o arrastre y suelte su CSV. El sistema detecta automáticamente la codificación y el separador. Se muestra una vista previa de las primeras 5 líneas.
Configure el mapeo
KaliaOps ofrece mapeo automático basado en nombres de columnas. Revise y ajuste si es necesario:
- Asocie cada columna CSV a un campo de KaliaOps
- Marque las columnas a ignorar
- Defina valores predeterminados para campos faltantes
Valide e inicie la importación
Haga clic en «Validar» para verificar los datos. El sistema muestra un resumen:
- Número de líneas a crear
- Número de líneas a actualizar (si existe la clave)
- Líneas con errores (detalles disponibles)
Si el resultado es satisfactorio, haga clic en «Importar».
Revise el informe
Al final de la importación, un informe detallado muestra:
- Líneas creadas con éxito
- Líneas actualizadas
- Líneas omitidas (duplicados)
- Líneas con errores y el motivo
Mapeo de campos
Mapeo automático
KaliaOps reconoce automáticamente encabezados comunes y los asocia a campos correspondientes:
| Encabezados reconocidos | Campo KaliaOps |
|---|---|
| name, nombre, designacion | name |
| code, codigo, referencia, ref | code |
| serial, serial_number, numero_serie | serial_number |
| ip, ip_address, direccion_ip | ip_address |
| email, mail, correo | |
| status, estado | status |
Referencias entre entidades
Para vincular entidades entre sí, utilice el código de la entidad destino:
- Empleado → Equipo: columna
team_codecon el código del equipo - Activo → Sitio: columna
site_codecon el código del sitio - Aplicación → Organización:
organization_code
Si el código referenciado no existe, la línea se marcará como error.
Validación y errores
Validaciones automáticas
Antes de la importación, KaliaOps verifica:
- Formato de datos
- Fechas en formato ISO (AAAA-MM-DD), emails válidos, direcciones IP correctas, valores numéricos.
- Campos obligatorios
- Los campos requeridos deben estar presentes y no vacíos.
- Referencias existentes
- Los códigos referenciados (site_code, team_code, etc.) deben existir en KaliaOps.
- Unicidad
- Los códigos e identificadores únicos no deben estar duplicados.
- Valores permitidos
- Los campos enum (status, type, criticality) deben contener valores válidos.
Tipos de errores comunes
| Error | Causa | Solución |
|---|---|---|
| Reference not found | Código referenciado no existe | Importar primero la entidad destino |
| Duplicate entry | El código ya existe | Modificar el código o actualizar |
| Invalid format | Formato de dato incorrecto | Corregir el formato (fecha, email, IP) |
| Required field missing | Campo obligatorio vacío | Completar el valor |
Historial de importaciones
Cada importación se registra en el historial con la siguiente información:
- Fecha y hora de la importación
- Usuario que realizó la importación
- Tipo de entidad importada
- Nombre del archivo fuente
- Estadísticas: creados, actualizados, omitidos, errores
- Duración de la importación
- Registro de errores detallado (descargable)
Acceso al historial
El historial está disponible en Administración → Importaciones → Historial. Puede filtrar por tipo de entidad, período o usuario.
Orden de importación recomendado
Para que las referencias entre entidades funcionen correctamente, siga este orden de importación:
- Sitios - Ubicaciones físicas (sin dependencias)
- Organizaciones - Pueden referenciar un sitio principal
- Equipos - Referencian una organización
- Empleados - Referencian equipo, responsable, organización
- Proveedores - Pueden referenciar un empleado (enlace de cuenta)
- Aplicaciones - Referencian organización, proveedor, propietario técnico
- Activos - Referencian sitio, aplicación, VLAN
- Contratos - Referencian proveedor
Mejores prácticas
Preparar la migración
- Limpie sus datos antes de importar: elimine duplicados, corrija formatos
- Pruebe con una muestra: importe 10-20 líneas para validar el mapeo
- Documente sus códigos: establezca una convención de nombres consistente
Durante la importación
- Importe en varios lotes en lugar de un archivo enorme (máx. 5000 líneas recomendado)
- Revise los informes de errores antes de continuar
- Conserve los archivos fuente como referencia
Después de la importación
- Verifique una muestra de registros importados
- Pruebe las relaciones: ¿un activo apunta al sitio correcto?
- Complete manualmente datos faltantes o específicos
Gestión de actualizaciones
Para actualizar registros existentes mediante importación:
- Use el mismo código que el registro existente
- El sistema detecta automáticamente que es una actualización
- Solo se modifican los campos presentes en el CSV
- Importación CSV para activos, aplicaciones, empleados, organizaciones, equipos, sitios y contratos
- Mapeo automático de columnas con opción de ajuste manual
- Validación en tiempo real: formatos, referencias, duplicados
- Informe detallado: líneas creadas, actualizadas, omitidas y errores
- Historial completo de importaciones con capacidad de rollback