Integración con Power BI

Nota

Es posible que algunas de las funciones cubiertas en este artículo no formen parte de su plan de licencia actual. Comuníquese con su representante de ventas para saber cómo puede obtener acceso.

Conecte los datos de Samsara y los de terceros a Microsoft Power BI para crear cuadros de mando de indicadores clave de rendimiento (KPI) y descubrir información empresarial práctica sin tener que escribir código.

Tipos de datos admitidos

El conector proporciona una amplia gama de datos que le permiten crear paneles e informes que se adaptan a sus necesidades y casos de uso específicos. La siguiente tabla muestra informes y campos populares de Samsara que puede usar en Power BI:

Tipo de datos	Campos
Asignaciones de atributos	Nombre de atributo, ID de atributo, Tipo de objeto, ID de objeto, ID de asignación de atributo
Sesiones de asesoramiento	ID de la sesión, Conductor, ID del asesor asignado, Tipo de comportamiento asesorable, Nota de comportamiento, Último comportamiento asesorado, Tipo de asesoramiento, Estado de la sesión, Nota de la sesión, Sesión actualizada el
Dispositivos	ID del activo, Estado de funcionamiento, Última conexión, Datos celulares utilizados, Uso del punto de acceso, Modelo, Serie
Campos condicionales de documentos	ID de documento, Primer índice de campo condicional, Último índice, Índice de campo activado, Valor
Campos de documentos	ID de documento, Tipo de campo, Etiqueta, Valor {BarcodeType, Barcode; DateTime; MultipleChoiceSelected, Value; Number; Photo URL; Scanned Document URL; Signature Name, Signed At Time, Signature URL; Text}
Documentos	ID del documento, Tipo de documento, Nombre del documento, Notas, ID de la ruta, ID de la parada de la ruta, Identificador del conductor, ID del vehículo, Hora de creación, Hora de actualización
Combustible y energía para conductores	Día en UTC, ID del conductor, Energía utilizada (kWh), Distancia recorrida (km), Tiempo de ralentí (min), Eficiencia (mpg), Emisiones de carbono (kg), Monto del costo energético del combustible, Horas de motor, Combustible consumido (l)
Asignaciones de asesor a conductores	Identificador del conductor, Identificador del asesor, Fecha de creación de la asignación, Actualizado el
Conductores	Identificador del conductor, Nombre, Estado de activación, Número de tarjeta de identificación, Número de licencia, Estado de la licencia, Zona horaria, Exención de ELD, Hora de inicio del día de ELD
Defectos de inspección vehicular	ID del vehículo, ID del remolque, ID del tipo de defecto, ID de la inspección vehicular, ID del defecto, hora de creación, Estado de resolución, Hora de resolución, Resuelto por, Nota del mecánico, Comentario
Tipos de defectos de la inspección vehicular	ID de defecto, Etiqueta y Sección
Inspecciones vehiculares	ID del vehículo, ID del remolque, Tipo, Hora de inicio de envío, Hora de envío, Hora de actualización, Hora de firma, ID de firma, Dirección Formateada, Notas del mecánico, Odómetro, Estado de seguridad
Estadísticas del equipo	Marca de tiempo, ID del equipo, Nombre, Odómetro, Horas de uso del motor, RPM del motor, Estado del motor, Porcentaje de combustible
Vehículos de la flota	Identificador del vehículo, Nombre, NIV, Marca, Modelo, Año, Matrícula, Modo de regulación del vehículo
Registros hiarios de horas de servicio	ID del conductor, ID del vehículo, Hora de inicio, Hora de finalización, Distancia de conducción, Distancia de transporte personal, Distancia de maniobra de patio, Duraciones del estado de servicio, Estado de certificación, Tiempo certificado, Reclamaciones, Información del transportista, Dirección de la terminal, Documentos de envío, más
Registros de horas de servicio	ID de horas de servicio, ID del conductor, Tipo de estado de horas de servicio, Hora de inicio del registro, Hora de finalización del registro, Latitud/longitud, ID del vehículo, Observación
Infracciones de horas de servicio	Tipo, Descripción, ID del conductor, Hora de inicio, Hora de finalización, Duración, ID de infracción de horas de servicio
Segmentos de ralentí	ID del segmento de ralentí, Hora de inicio, Hora de finalización, Duración (min), ID del vehículo, Combustible consumido (l), TDF activa
Paradas de ruta	ID de ruta, ID de parada de ruta, Hora de inicio programada, Hora de finalización programada, Hora de inicio real, Hora de finalización real, Tiempo omitido, Estado de parada de ruta, ID de dirección, Latitud/longitud de ubicación, Dirección de la ubicación, Tiempo estimado de llegada a parada de ruta, Nombre de parada de ruta, Notas
Rutas	ID de Ruta, Nombre de ruta, Notas, ID del conductor, ID del activo, Hora de inicio programada, Hora de finalización programada, Hora de inicio real, Hora de finalización real
Incidentes de seguridad	ID de incidente de seguridad, Hora, ID de conductor, ID de vehículo, Estado de asesoramiento, Aceleración máxima, Latitud, Longitud, Etiqueta de comportamiento, Nombre de comportamiento, Fuente del comportamiento
Asignación de etiquetas	Nombre de etiqueta, ID de etiqueta, ID de etiqueta superior, Tipo de objeto, ID de objeto, ID de asignación de etiqueta
Estadísticas del remolque	Marca de tiempo, ID del remolque, Nombre, Información de ubicación, Odómetro, Horas de uso del motor, Porcentaje de combustible, Valores previos al trayecto y descongelación del contenedor refrigerado, Modo de funcionamiento del contenedor refrigerado, Zona de estado del contenedor refrigerado, Temperatura límite, Temperatura del aire de suministro, Temperatura del aire de retorno, Zona de estado de la puerta, Temperatura del aire ambiente Nota Todas las lecturas de temperatura en miliCelsius para las Zonas 1 a 3.
Remolques	ID del Remolque, Nombre, Número de serie, Matrícula, Modelo de terminal telemático y Número de serie (si aplica), Notas
Combustible y energía para vehículos	Día en UTC, ID del vehículo, Energía utilizada (kWh), Distancia recorrida (km), Tiempo de ralentí (min), Eficiencia (mpg), Emisiones de carbono (kg), Monto del costo energético del combustible, Horas de motor, Combustible consumido (l)
Estadísticas del vehículo	Marca de tiempo, ID del vehículo, Identificador del conductor actualmente asignado, Información de ubicación, Información geográfica, Último valor de velocidad, Valor del odómetro, Horas de uso del motor, Porcentaje de combustible Nota Esta tabla proporciona una instantánea de las lecturas en el momento en que se genera o se actualiza la tabla.
Usuarios	ID de usuario, Nombre, Correo electrónico, Rol y Combinaciones de etiqueta

Algunas tablas, como las de ralentí y combustible y energía del vehículo, pueden tardar más en cargar dependiendo del rango de datos seleccionada (hasta 6 meses de datos). En tales casos, recomendamos una actualización programada asíncrona o limitar el rango de consulta.

Las tablas de estadísticas de equipo y estadísticas de remolque proporcionan una instantánea de las lecturas en el momento en que se genera o se actualiza la tabla.

Nota

Esta tabla no es una lista completa de todos los campos de datos disponibles con el conector, pero enumera los campos más comunes y relevantes. Para ver los tipos de datos en versión beta, consulte [Beta] Tipos de datos adicionales en Power BI.

Plantillas compatibles

Samsara proporciona las siguientes plantillas para rellenar Power BI con los datos de su organización.

Para utilizar una plantilla:

Descargue la plantilla, según sus necesidades de datos, utilizando los enlaces anteriores.
Abra el archivo .pbit, que abre Power BI.
Introduzca la región y la fecha.
Introduzca el token de la API de Samsara para su organización.

El token debe ser válido para establecer la conexión.

Requisitos

Power BI:
- Suscripción a Power BI Pro
  
  Es necesario contar con un espacio de trabajo premium para la actualización incremental con flujos de datos
- Lanzamiento del 28 de octubre de 2024 de Power BI Desktop, o posterior
  
  Lanzamiento de Desktop de abril de 2024 limitado a 9 tablas GA
Para obtener información sobre precios y comparación de productos, consulte la documentación de Microsoft Power BI.
Samsara:
- Acceso a la API desde la instalación de Power BI del Catálogo de aplicaciones
  
  El acceso a la tabla corresponde a su acceso a la API, que depende de su plan de Samsara. Por ejemplo, para acceder a la tabla IFTA en Power BI, necesitará la suscripción nombrada para la API IFTA (Tel-Prem). Para revisar si algún tipo de datos requiere una suscripción específica, consulte Requisitos de licencia para el uso de API y Webhooks.
- (Opcional) Si desea limitar el acceso a un grupo de activos, se recomienda asignar etiquetas a esos activos en el panel de Samsara.

Implementación

Samsara desarrolló la integración proporcionará apoyo con las implementaciones según sea necesario. Siga los pasos a continuación para comenzar. En caso de problemas, póngase en contacto con el servicio de Soporte de Samsara. Para obtener orientación adicional sobre la configuración y preguntas comunes para el conector de Power BI, consulte las Preguntas frecuentes sobre el conector de Power BI.

Nota

El conector Power BI es compatible con otros productos Power Query (además de Power BI Desktop).

Consulte la documentación de Microsoft Power BI para obtener más información.

Inicie sesión en el panel de Samsara.
(Opcional) Etiquete cualquier activo relevante con Power BI Tracking si desea limitar el acceso solo a esos activos.
Instale la integración de la aplicación.
1. Seleccione el ícono de Configuración ( ) en la parte inferior del menú Flota y luego haga clic en Aplicaciones.
2. Busque y seleccione Power BI para instalar la aplicación.
3. Si etiquetó sus activos para limitar el acceso, cambie el alcance de acceso de Toda la organización al nombre de la etiqueta.
4. Haga clic en Permitir para aceptar los términos del Anexo de Importación e Intercambio de Datos de Samsara.
5. Haga clic en Generar token.
6. Registre el token, ya que lo necesitará para configurar los siguientes pasos de la instalación. Si es necesario, puede volver a generar el código.
Instalar Power BI Desktop.

La instalación de Power BI Desktop es la misma tanto para la puerta de enlace estándar como para la personal.
Instale el servicio Power BI.

Existen dos formas de configurar Power BI Service: puerta de enlace estándar y puerta de enlace personal. La estándar tiene un proceso de instalación más largo, pero se recomienda para organizaciones en las que varias personas acceden a varias fuentes de datos.
- Instalar puerta de enlace estándar
- Instalar una puerta de enlace personal

Para obtener más orientación sobre la configuración y respuestas a preguntas comunes sobre el Conector de Power BI, consulte Preguntas frecuentes sobre el Conector de Power BI.

Instalar Power BI Desktop

Instale Power BI Desktop utilizando una de las siguientes opciones:

Instalación de Power BI Desktop mediante flujos de datos (recomendado)
Instalar Power BI Desktop mediante una conexión directa

Instalación de Power BI Desktop mediante flujos de datos

Los flujos de datos son colecciones de tablas gestionadas en la nube, que permiten la conexión directa a Power BI Service sin puerta de enlace y pueden ofrecer tiempos de actualización más rápidos.

Vaya al espacio de trabajo seleccionado en el servicio Power BI.

Nota

No puede utilizar su espacio de trabajo personal My Workspace para conectarse a Dataflows.
Seleccione Nuevo > Flujo de datos > Añadir nuevas tablas.
Busque y seleccione la fuente Samsara que aparece.

Aunque este conector está certificado por Microsoft y con disponibilidad general, Microsoft exige que se muestre la etiqueta beta para la primera versión certificada.
Introduzca los campos obligatorios y opcionales.

La puerta de enlace de datos no es necesaria para esta conexión. Si decide utilizar una, asegúrese de que ya esté instalada y configurada.
Seleccione los datos que desea cargar y haga clic en Transformar datos.
Abra Power BI Desktop y vaya a Obtener datos > Flujos de datos.
Inicie sesión en Dataflows con su cuenta de Samsara.
Seleccione la carpeta del espacio de trabajo donde se estableció la conexión Dataflow. Elija las tablas pertinentes y cárguelas en Power BI Desktop.
Cree su informe de Power BI.

Si desea publicar el informe en Power BI Service y configurar las actualizaciones, continúe con los siguientes pasos.
1. Guarde su informe y haga clic en Publicar en Power BI Desktop.
2. Localice el informe publicado en su área de trabajo de Power BI Service y haga clic en Programar actualización.
  
  Nota
  
  La configuración de actualizaciones programadas mediante Dataflows NO requiere una puerta de enlace. Una conexión Personal Cloud se indicará en verde junto a PowerPlatformDataflows como sus credenciales de fuente de datos.
3. Para programar una actualización, despliegue el menú desplegable Actualizar, seleccione la configuración deseada y, a continuación, haga clic en Aplicar.
La actualización y la conexión del servicio Power BI estrá completa.

Instalar Power BI Desktop mediante una conexión directa

Abra Power BI Desktop.
En la ventana emergente, haga clic en Obtener datos. Si es necesario, puede que tenga que ir a Archivo > Nuevo.
Busque Samsara. A continuación, seleccione Samsara (Beta) y haga clic en Conectar.

Nota

Aunque este conector está certificado por Microsoft y con disponibilidad general, Microsoft exige que se muestre la etiqueta beta para la primera versión certificada.
Introduzca la región y el intervalo de tiempo en formato Mes/Día/Año durante cuánto tiempo desea obtener los datos y, a continuación, haga clic en Aceptar. Este conector de datos tiene actualmente un límite de 6 meses para la actualización de datos. Esto significa que solo podrá obtener los últimos 6 meses de datos.

Los campos de fecha inicial y fecha final son campos de texto, no de tipo fecha. Esto se debe a que Microsoft no admite la introducción de campos de fecha cuando se utiliza la puerta de enlace estándar. Para evitar errores más adelante en este proceso, asegúrese de utilizar el formato adecuado.
Introduzca el token de la API de Samsara que generó al instalar la aplicación Power BI y haga clic en Conectar.

Tras introducir el token de la API de Samsara, podrá ver todas las tablas de datos disponibles y seleccionar las que desea cargar. Algunas tablas tardarán un poco (hasta unos minutos) en cargarse, especialmente en el caso de los conjuntos de datos más grandes.

Instalar puerta de enlace estándar

Descargar el Power BI Gateway - modo estándar.
Inicie sesión con sus credenciales de Microsoft.
Haga clic en Configurar para iniciar la configuración de la puerta de enlace.
Seleccione Registrar una nueva puerta de enlace en este equipo y, a continuación, haga clic en Siguiente.
Rellene los campos obligatorios para el nombre de la puerta de enlace y la clave de recuperación.

Nota

La clave de recuperación no es lo mismo que el token de API.
Revise el estado de la puerta de enlace para confirmar que está lista para usar.
Vaya a Power BI Service en línea y, a continuación, seleccione Configuración > Gestionar conexiones y puertas de enlace > Puertas de enlace de datos locales.

Compruebe que puede ver la conexión que ha creado.
Vuelva a la ventana emergente de la pasarela y haga clic en Conectores.

Debería ver el nombre de su conector Samsara. Esto garantiza que la cuenta de servicio que utiliza la puerta de enlace tiene los permisos correctos para acceder a la carpeta en la que se instaló el conector.

Si no ve el conector Samsara, la ruta de la carpeta no se configuró correctamente con la instalación de la puerta de enlace o la cuenta del servicio Power BI no tiene permiso para leer la ruta de la carpeta.

Para resolver problemas con la ruta, pruebe los siguientes pasos.
1. En el Explorador de Windows, vaya a la ruta de la carpeta que creó previamente en los pasos de instalación de Power BI: ~/Documents/Power BI Desktop/Custom Connectors
2. Haga clic derecho en Conectores personalizados y seleccione Propiedades.
3. Vaya a la pestaña Seguridad y compruebe que el usuario PBIEgwService existe en la lista. Si el usuario no existe, proceda a crearlo como se describe en los pasos siguientes.
4. Haga clic en Editar y, a continuación, en Añadir el usuario.
5. Introduzca el nombre NT SERVICE\PBIEgwService y haga clic en Aceptar.
6. Asegúrese de que el usuario PBIEgwService tiene los siguientes permisos de acceso:
  - Leer y ejecutar
  - Listar el contenido de la carpeta
  - Leer
7. Haga clic en Aceptar.
8. En la pestaña Inicio de sesión, cambie la cuenta de servicio para el servicio de puerta de enlace de datos local a la cuenta del sistema local.
9. Haga clic en Aceptar.
10. Compruebe que ahora puede ver el conector Samsara en la sección Conectores de la página de la puerta de enlace de datos local.
Publique en Power BI Desktop el informe que desea ver en Power BI Service. El informe publicado debería ser visible en su área de trabajo de Power BI Service.
Seleccione Programar actualización para el conjunto de datos (icono de calendario junto a los tres puntos y el icono de actualización).
Seleccione Conjuntos de datos > Puerta de enlace y conexiones de nube y compruebe que ve la pasarela en la lista con un estado no configurado correctamente.
Haga clic en el ícono de engranaje situado junto a la puerta de enlace para gestionar las conexiones y las puertas de enlace.
Seleccione las dos opciones en la sección Power BI para activar la actualización.
Guarde los cambios y cierre.
Cree una nueva conexión para la puerta de enlace estándar.
1. Haga clic en Nuevo y rellene los campos obligatorios.
  
  Si no se muestra Samsara API Get Records (Beta) como Tipo de conexión, hay un problema de ruta.
  
  Nota
  
  Los campos de fecha de inicio y fecha de fin son campos de texto. Asegúrese de que el texto que introduce sigue el formato adecuado.
2. Haga clic en Crear y cierre la ventana emergente.
  
  La nueva conexión debería aparecer si se ha creado correctamente y es de color verde cuando está en funcionamiento. Esta conexión se puede compartir y reutilizar entre miembros de la misma organización.
Vuelva a Mi espacio de trabajo > Programar actualización > Conjuntos de datos > Conexiones de puerta de enlace y en la nube.
Haga clic en el menú desplegable de Ruta y seleccione la puerta de enlace adecuada.
Haga clic en Aplicar.

La instalación de la puerta de enlace finalizará. Ahora puede actualizar el informe y el conjunto de datos.

Instalar una puerta de enlace personal

Descargue la puerta de enlace Power BI - modo personal.
Inicie sesión con sus credenciales de Microsoft.
Haga clic en Conectores en el panel izquierdo.
Asegúrese de que la ruta coincide con la ruta de instalación de Power BI Desktop.

El conector Samsara no aparecerá si la ruta es incorrecta.
Haga clic en Cerrar.

Su Power BI Gateway está listo para usar.
Establezca una actualización del horario.
1. Compruebe que las credenciales están conectadas en la sección Credenciales de la fuente de datos.
2. Si las credenciales no están conectadas, haga clic en Editar credenciales. A continuación, introduzca el mismo token de API que utilizó para instalar Power BI Desktop en Clave de cuenta y seleccione la configuración del nivel de privacidad que prefiera.
3. Para programar una actualización de datos, haga clic en Actualizar y rellene la información requerida.
Para activar manualmente una actualización, también puede hacer clic en el ícono de actualización de la conexión.

Soporte

Consulte la documentación de Microsoft Power BI para obtener más información.

Para cuestiones relacionadas con la integración, póngase en contacto con el servicio de Soporte de Samsara.

Nota

Tipos de datos admitidos

Nota

Nota

Nota

Plantillas compatibles

Requisitos

Implementación