Ir al contenido principal

Instalación y configuración de BL Connect con Edusign.

Escrito por Lucas Minarro-Rey

Esta guía explica paso a paso cómo instalar y configurar BL Connect para asegurar la sincronización entre su software de gestión (Berger-Levrault) y Edusign.

⚠️ Este procedimiento requiere un buen dominio de su entorno técnico. En caso de duda, contacte con su referente Edusign.

Por favor, consulte este documento como complemento: Dossier_Installation_BLConnect_Edusign.pdf

Paso 1 - Preparar el entorno

✅ Requisitos previos

  • Tener acceso de administrador en el servidor que aloja BL Connect.

  • Tener las direcciones de correo electrónico registradas en la ficha de cada estudiante.

  • Haber completado el campo GRP EDUSIGN (grupo de pertenencia) en la ficha del estudiante.

  • Para los docentes, también deben registrarse las direcciones de correo electrónico.

Paso 2 - Instalación de BL Connect

  1. Descargue e instale BL Connect en el servidor previsto.

  2. Verifique que los servicios necesarios estén iniciados.

Paso 3 - Configurar la interfaz Edusign

  1. Abra el archivo de configuración BLCONNECT_EDUSIGN.INI.

  2. Ingrese la siguiente información:

    • Clave API proporcionada por Edusign.

    • Parámetros de conexión específicos para su institución.

Paso 4 - Iniciar la primera sincronización

  • Inicie una sincronización manual.

  • Verifique que los estudiantes estén creados correctamente en Edusign.

  • El ID de Edusign debe estar inscrito automáticamente en el campo Código RFID.

Paso 5 - Programar las sincronizaciones automáticas

Recomendamos programar 3 sincronizaciones por día:

  • Por la mañana (antes de que comiencen las clases).

  • Entre las 12h y 14h.

  • Al final del día.

Esto garantiza que los estudiantes, grupos y sesiones estén siempre actualizados.

Paso 6 - Seguimiento y depuración

  • Los registros se encuentran en la carpeta de instalación de BL Connect.

  • En caso de error:

    • Verifique los registros.

    • Asegúrese de que los campos obligatorios (correo electrónico, grupo) estén llenados.

    • Reinicie una sincronización.

Paso 7 - Control y resolución de problemas (lista de verificación detallada)

Este bloque reúne las verificaciones prioritarias al fallar una sincronización o si parecen faltar datos. Siga los pasos en orden:

✅ Verificaciones rápidas

  • Verifique que los correos electrónicos de los estudiantes e docentes estén completos (según EMAIL_COMM: principal o secundario).

  • Confirme que el campo GRP EDUSIGN está presente y completado en las fichas correspondientes.

  • Asegúrese de que el Bundle/nombre base y los identificadores en BLCONNECT_EDUSIGN.INI apunten a las bases correctas.

  • Verifique que las tareas programadas estén activas y que las últimas ejecuciones no presenten errores.

🔎 Análisis de registros

  • Abra la carpeta \Log en la instalación BL Connect.

  • Identifique la franja horaria correspondiente al intento de sincronización.

  • Observe los errores clave: conexión DB, tiempo de espera, rechazo de autenticación API, error de análisis de un registro.

  • Busque las apariciones de las palabras clave: ERROR, EXCEPTION, TIMEOUT, AUTH.

🔧 Acciones correctivas comunes

  1. Error de conexión DB: verifique el host/puerto/credenciales en el INI; pruebe la conexión desde el servidor (telnet / sqlclient).

  2. Ausencias o estudiantes faltantes: confirme que las promociones/sesiones estén dentro de la ventana de sincronización (7 días recomendados) y que el GRP EDUSIGN esté completado.

  3. docentes sin correo electrónico: complete las direcciones de correo electrónico en BL Escolaridad; reinicie la sincronización.

  4. Problema de escritura del Código RFID: permisos sobre la base BL; verifique que ninguna restricción DB impida la actualización.

  5. Fallo API Edusign: verifique la validez y el alcance de la clave API proporcionada (expiración, permisos).

🆘 Cuándo contactar con el soporte de Edusign

Si después de estas verificaciones el problema persiste, contacte con el soporte Edusign con los siguientes elementos:

  • Extracto de registro (10-20 líneas alrededor del error);

  • Contenido anonimizado de las secciones clave de BLCONNECT_EDUSIGN.INI;

  • Indicaciones de las tareas programadas (nombres y horarios);

  • Ejemplo de un registro incompleto (ej: ficha del estudiante con campos faltantes).

Paso 8 - Lista de verificación final

  • BL Connect está instalado y operativo.

  • Los correos electrónicos de estudiantes/docentes están completados.

  • El campo GRP EDUSIGN está completo.

  • El archivo BLCONNECT_EDUSIGN.INI está configurado correctamente.

  • El ID de Edusign está presente en el campo Código RFID.

  • Las sincronizaciones automáticas están programadas.

💡 Buenas prácticas

  • Utilice siempre una dirección de e-mail genérica (ej. formacion@escuela.es) para las notificaciones.

  • Supervise regularmente las sincronizaciones en los registros.

  • Contacte a Edusign si una sincronización falla varias veces consecutivas.

Su interfaz BL Connect x Edusign ahora está lista. 🎉

En caso de bloqueo, abra un ticket de soporte o contacte directamente al equipo de Edusign a través del chat.

¿Ha quedado contestada tu pregunta?