Conectar Power BI a la API pública de Alvys

​

Resumen

Esta integración conecta Microsoft Power BI (también llamado Power BI, PowerBI, Microsoft Power BI o inteligencia empresarial) a la API pública de Alvys (API OData/REST) para que pueda extraer datos operativos en vivo a Power BI para informes y análisis. Una vez conectado, Power BI recupera datos de Alvys en tiempo real para que pueda crear paneles actualizados y usar las herramientas de visualización de Power BI para representar datos de Alvys. La conexión admite solicitudes GET para recuperación básica de datos y métodos POST para búsquedas avanzadas, que agregan filtrado, selección de rangos de fechas y consultas basadas en estado que van más allá de informes básicos. Los datos se mueven en una sola dirección: de Alvys a Power BI. Con acceso a endpoints como Loads, Drivers, Fuel, Invoices, Trips y Trucks, puede explorar datos en múltiples áreas operativas y generar análisis adaptados a sus necesidades.

​

Requisitos previos

Antes de conectar Power BI a Alvys, asegúrese de tener lo siguiente. Su cuenta tiene uno de los roles requeridos: generar y administrar credenciales de la API pública de Alvys requiere el rol Admin o Partner Admin. Sus credenciales de API de Alvys están listas: necesita su Client ID, Tenant ID y Client Secret de la plataforma Alvys, generados en Profile luego API. Power BI Desktop está instalado con la versión más reciente disponible. La configuración de privacidad de Power BI está configurada para desactivar las comprobaciones de privacidad, de modo que la integración de API funcione sin problemas.

​

Cómo conectar?

1. En la plataforma Alvys, vaya a Profile luego API para abrir la página Public API.
2. Localice sus credenciales de API en esa página. Necesita el Client ID, Tenant ID y Client Secret. Estos tres valores autentican Power BI con la API pública de Alvys.
3. Genere un token de API. El token autentica cada solicitud que Power BI envía a los endpoints de la API de Alvys.
4. Abra Power BI Desktop y confirme que está en la versión más reciente.
5. En Power BI Desktop, configure sus ajustes para desactivar las comprobaciones de privacidad para que la integración de API funcione sin interrupciones.
6. Use sus credenciales y token para conectar Power BI a los endpoints de la API pública de Alvys en los que desea informar.

Para detalles completos de configuración, incluidos ejemplos de consultas y un archivo de Power BI preconfigurado para integración rápida, use la documentación de la API pública de Alvys.

​

Qué se sincroniza?

Power BI extrae datos de endpoints individuales de la API pública de Alvys, y cada endpoint se mapea a un área operativa en Alvys. El endpoint Loads Search devuelve datos de carga y le permite filtrar cargas por criterios como fecha y estado. El endpoint Drivers Search devuelve detalles de conductores y le permite consultar por flota o estado. El endpoint Fuel Search devuelve historiales de transacciones de combustible. El endpoint Invoices Search devuelve datos de facturas y le permite recuperar facturas por fecha o estado. Hay endpoints adicionales disponibles para Trips y Trucks, para que pueda extraer datos de múltiples áreas operativas a Power BI. La conexión es unidireccional y bajo demanda. Power BI recupera datos de la API pública de Alvys en tiempo real cuando ejecuta o actualiza una consulta, de modo que sus paneles de Power BI reflejan los datos actuales de Alvys en el momento de la recuperación. Las solicitudes GET manejan la recuperación básica de datos. Los métodos POST manejan búsquedas avanzadas, incluido el filtrado por estado o rangos de fechas. Los datos fluyen solo de Alvys a Power BI; no se escribe nada de vuelta a Alvys.

​

Verificar que funciona

1. En Power BI Desktop, ejecute una consulta contra uno de los endpoints de Alvys, como Loads Search.
2. Confirme que los datos de Alvys se cargan en Power BI sin un error de autenticación o privacidad.
3. Cree una visualización simple con los datos devueltos para confirmar que los campos se completan como se espera.

​

Solución de problemas

​

Power BI no puede autenticarse con la API de Alvys

1. Confirme que inició sesión en Alvys con el rol Admin o Partner Admin, ya que solo estos roles pueden generar y administrar credenciales de Public API.
2. Vaya a Profile luego API y confirme que su Client ID, Tenant ID y Client Secret son correctos y se copiaron sin espacios adicionales.
3. Genere un token de API nuevo y úselo para sus solicitudes.

​

Power BI bloquea la conexión con un error de privacidad

1. Abra la configuración de Power BI Desktop.
2. Desactive las comprobaciones de privacidad para que Power BI permita que la conexión de API de Alvys funcione.
3. Vuelva a ejecutar su consulta.

​

Una consulta no devuelve datos o devuelve resultados limitados

1. Confirme que está usando un método POST cuando necesita filtrado, rango de fechas o búsquedas basadas en estado, ya que las solicitudes GET solo devuelven datos básicos.
2. Revise sus valores de filtro, rango de fechas y estado contra los ejemplos de consulta en la documentación de la API pública de Alvys.

​

Límites y no compatibles

Esta es una conexión unidireccional de solo lectura. Power BI extrae datos de Alvys y no puede escribir ni enviar datos de vuelta a Alvys. El filtrado avanzado, la selección de rango de fechas y las consultas basadas en estado requieren métodos POST. Las solicitudes GET solo admiten recuperación básica de datos.

​

Preguntas frecuentes

P: ¿Puedo usar Power BI para conectarme directamente a la API de Alvys? R: Sí. La API pública de Alvys admite la integración con Power BI y habilita métodos GET y POST para recuperar datos. P: ¿Por qué usar métodos POST con Power BI? R: Las solicitudes GET permiten recuperación básica de datos. Los métodos POST desbloquean capacidades de búsqueda avanzadas, incluido el filtrado por estado o rangos de fechas. P: ¿Dónde encuentro mis credenciales de API? R: Sus credenciales de API (Client ID, Tenant ID y Client Secret) están disponibles en Profile luego API en la plataforma Alvys.