Base de Datos de Campana

Que es una Base de Datos de Campana?

Una Base de Datos de Campana es un almacen de datos persistente asociado a una campana. A diferencia de los datasets (que se usan para ejecuciones individuales), las bases de datos persisten a traves de multiples ejecuciones y pueden actúalizarse con nuevos datos en cualquier momento.

Casos de Uso Comunes

Creando una Base de Datos

Para crear una base de datos de campana, subes un archivo Excel que define el esquema inicial y los datos. El sistema detecta automaticamente los tipos de columna.

Pasos:

1. Abre tu campana y navega a la pestana Base de Datos
2. Haz clic en "Subir Base de Datos"
3. Selecciona un archivo Excel (.xlsx) de tu computadora
4. Revisa el esquema auto-detectado
5. Configura la(s) columna(s) de identificador unico
6. Haz clic en "Crear Base de Datos"

Gestion del Esquema

El esquema de la base de datos define la estructura de tus datos. Cada columna tiene un tipo que determina como se almacenan, validan y muestran los datos.

Tipos de Columna

Configuracion de Identificador Unico

Cada base de datos requiere al menos una columna de identificador unico. Esto se usa para:

• Identificar registros para actúalizaciones (upserts)
• Cruzar registros durante consultas
• Prevenir entradas duplicadas

Importando Datos

Despues de crear una base de datos, puedes importar datos adicionales en cualquier momento. El sistema soporta multiples modos de importacion para manejar diferentes escenarios de actúalizacion.

Modos de Importacion

Deteccion de Cambios de Esquema

Al importar datos con columnas diferentes al esquema existente, el sistema detecta los cambios y pide confirmacion:

• Columnas nuevas: Pueden agregarse tras confirmacion del usuario
• Columnas clave faltantes: Importacion bloqueada - las claves son requeridas
• Discordancia de tipos: Se muestra advertencia, los datos pueden convertirse

Progreso de Importacion

Las importaciones grandes se procesan en lotes. Puedes monitorear el progreso en tiempo real:

Versionado de Registros

Cada vez que se actúaliza un registro, se crea una nueva version. Esto proporciona una pista de auditoria completa de todos los cambios en tus datos.

Como Funciona el Versionado

1. La importacion inicial crea la Version 1 de cada registro
2. Cada actúalizacion (via importacion o API) crea una nueva version
3. Las versiones anteriores se retienen y son consultables
4. La version "actúal" siempre se usa para consultas

Viendo Historial de Versiones

Haz clic en cualquier registro para ver su historial completo de versiones:

Consultando Registros

La interfaz de base de datos proporciona herramientas para buscar, filtrar y exportar tus datos.

Busqueda y Filtro

• Busqueda rapida: Buscar en todas las columnas de texto
• Filtros de columna: Filtrar por valores de columna especificos
• Paginacion: Navegar a traves de conjuntos de datos grandes
• Ordenamiento: Ordenar por cualquier columna

Exportando Datos

Exporta tu base de datos a Excel en cualquier momento:

• Exportacion completa: Todos los registros y columnas
• Exportacion filtrada: Solo registros que coinciden con filtros actúales
• Columnas seleccionadas: Elige que columnas incluir

Integracion Base de Datos-Dataset

Al subir un dataset, puedes configurar el cruce con tu base de datos de campana para enriquecer automaticamente los datos de contacto.

Opciones de Cruce

Configuracion de Prefijo de Datos

Para evitar conflictos de nombres de columna, los campos de base de datos se prefijan al mezclarse con filas del dataset:

// Ejemplo: Campos de base de datos con prefijo "db_"
{
  "phone": "+56912345678",      // Campo del dataset
  "name": "Juan",               // Campo del dataset
  "db_balance": 150000,         // Campo de base de datos
  "db_last_payment": "2024-01"  // Campo de base de datos
}