Solución de problemas
Durante la configuración y prueba de los servicios OData, pueden surgir algunos inconvenientes que impidan ejecutar correctamente la aplicacicón. A continuación se describen los problemas más frecuentes y sus posibles soluciones:
⚙️ Instalación
Problemas con Microsoft .NET Framework 4.8
Posible causa:
- No se instaló correctamente el componente .NET Framework 4.8
Solución:
- Buscar en la carpeta de instalación de Delfín API la siguiente ubicación
App_Data
- Ejecutar el archivo
ndp48-x86-x64-allos-enu.exe
, para reinstalar el componente .Net Framework 4.8. - Luego de que se haya instalado el componente correctamente, intentar ingresar nuevamente a la aplicación.
Problemas con OLEDB o Visual FoxPro OLEDB
Posible causa:
- No se instaló correctamente el componente de Visual FoxPro OLEDB
Solución:
- Buscar en la carpeta de instalación de Delfín API la siguiente ubicación
App_Data
- Ejecutar el archivo
VFPOLEDBSetup.msi
, para reinstalar el componente Visual Foxpro OLEDB. - Luego de que se haya instalado el componente, intentar ingresar nuevamente a la aplicación.
🛠️ Configuración
Error 404 - Servicio no encontrado
Al intentar acceder a OrganizacionOData.svc
o AnalisisOData.svc
, el navegador muestra que la página no existe.
Posible causa:
- La URL está mal escrita.
- El servicio no está habilitado.
- La configuración de los directorios de datos es incorrecta.
Solución:
- Verifica que la URL sea correcta:
http://localhost/DelfinAPI/v1/OrganizacionOData.svc
- Asegúrate de haber completado la configuración de los directorios de datos en la página principal del API.
- Reinicia el servidor web si hiciste cambios recientes.
Error 500 - Error interno del servidor
El servidor devuelve un error al intentar acceder a los servicios.
Posible causa:
- Problemas con los permisos de acceso a los archivos de datos.
- Archivos de base de datos corruptos o mal ubicados.
Solución:
- Verifica que el usuario del servidor web tenga permisos de lectura/escritura sobre los directorios de datos.
- Asegúrate de que los archivos
.DBF
estén en buen estado y en la ruta configurada.
Respuesta vacía o sin datos
El servicio responde correctamente, pero no muestra registros.
Posible causa:
- La base de datos está vacía.
- El filtro aplicado en la consulta no devuelve resultados.
Solución:
- Revisa que las tablas contengan datos.
- Prueba una consulta sin filtros para validar que el servicio está funcionando.
Error de conexión desde Excel o herramientas externas
Excel no puede conectarse al servicio OData.
Posible causa:
- El servicio no está corriendo en el puerto esperado.
- El firewall bloquea la conexión.
- Excel no reconoce el formato del servicio.
Solución:
- Verifica que el servicio esté activo en
http://localhost/DelfinAPI
. - Asegúrate de que el firewall permita conexiones locales.
- Usa la opción “Desde OData Feed” en Excel y selecciona el formato correcto.