Integración con Tableau

El conector OData de Samsara le permite llevar conjuntos de datos de Samsara e informes personalizados que haya creado dentro de Samsara a Tableau para su uso en visualizaciones de datos avanzadas y análisis adicional.

Requisitos

Tableau: Licencia Explorer o Creator para el correo electrónico que utiliza con Tableau.

Samsara: Acceso a la API con permisos de lectura

Implementación

Samsara desarrolló la integración y brindará asistencia con las implementaciones según sea necesario. Siga los pasos a continuación para comenzar. Si tiene algún problema, ppóngase en contacto con el servicio de Soporte de Samsara.

Genere el token de API desde Samsara:
1. Inicie sesión en el panel de Samsara.
2. Seleccione el ícono de Configuración ( ) en la parte inferior del menú Flota y luego haga clic en Aplicaciones.
3. Haga clic en Código beta en la esquina superior derecha.
4. Para el código de entrada, escriba tableau-beta, luego haga clic en Instalar.
5. Acepte los términos y condiciones y luego seleccione Generar token.
6. Copie el token de API generado.
  
  Este token de API se utilizará para autenticar el conector de Tableau. Si pierde el token, no podrá recuperarlo y necesitará regenerar un nuevo token.
A continuación, Genere la URL y las credenciales de OData.
Finalmente, conéctese a Tableau.

URL y credenciales de OData

Los informes y el alcance del rango de datos se generan en OData a través de la URL de conexión, en lugar de un selector de fechas como otros protocolos de conexión.

Para generar una URL de OData, siga los pasos a continuación:

Recopile la siguiente información:
- La región de su organización.
  
  Puede identificarla verificando el dominio en la URL de su panel de control (por ejemplo, cloud.samsara.com, cloud.ca.samsara.com o cloud.eu.samsara.com).
- El rango de fechas para los datos con los que desea trabajar.
  
  Asegúrese de que el rango esté dentro del máximo permitido para el conjunto de datos; de lo contrario, la extracción no se ejecutará.
- Su identificador de la organización.
- Su token de API.
  
  Si aún no tiene uno, consulte Implementación.
Cree la conexión URL utilizando esta plantilla como referencia:

https://<connector_domain>/data-connectors/odata/v4/<start_date>/<end_date>/
1. Reemplace <connector_domain> con el dominio del conector de datos regional asignado a su organización:
  - data-connector.samsara.com
  - data-connector.ca.samsara.com
  - data-connector.eu.samsara.com
2. Reemplace <start_date> con la fecha de inicio del rango de fechas, en formato AAAA-MM-DD.
3. Reemplace <end_date> con la fecha de finalización del rango de fechas, en formato AAAA-MM-DD.
Por ejemplo, una organización a la que se le asignó el dominio del conector de datos regional de la UE con un rango de fechas del 1 de enero de 2025 al 31 de enero de 2025, usaría la siguiente URL: https://data-connector.eu.samsara.com/data-connectors/odata/v4/2025-01-01/2025-01-31/.

Los parámetros deben editarse en la URL, la fecha se puede editar posteriormente.

Samsara recomienda que la duración máxima del rango de fechas sea de no más de 1 año en cualquier conjunto de datos. Para obtener más información, consulte Rendimiento y rangos de fechas.
Mantenga su identificador de la organización y token de API para usar como credenciales al Conectarse a Tableau.

Su nombre de usuario es el identificador de la organización. Su contraseña es el token de API.

Rendimiento y rangos de fechas

Los conjuntos de datos para los conectores de Power BI y Tableau cuentan con límites de tiempo establecidos. Samsara recomienda que el rango máximo no sea mayor de 1 año en cualquier conjunto de datos. Las extracciones de datos particularmente grandes y complejas, como las que se indican en la siguiente tabla, pueden agotar el tiempo de espera si realiza solicitudes en un rango mayor al sugerido. Al ingresar un rango de datos en su URL, considere lo siguiente:

Conjunto de datos	Rango de fecha máximo recomendado
Actividades de activos	6 meses
Diagnósticos de activos	6 meses
Activos	1 año
Conductores	1 año
Inspecciones vehiculares	3 meses
Envíos de formularios	6 meses
Registros de horas de servicio	3 meses
Segmentos no asignados de horas de servicio	3 meses
Infracciones de horas de servicio	3 meses
Eventos de ralentí	3 meses
Incidencias	6 meses
Saltos del odómetro	6 meses
Incidentes de reversa	1 semana
Incidentes de seguridad	6 meses
Intervalos de exceso de velocidad	3 meses
Registros de tacógrafo	3 meses
Capacitación	6 meses
Trayectos	3 meses

La selección de fechas se realiza a través de parámetros de URL, no a través de un selector de fechas en la interfaz de usuario. Para obtener más información sobre cómo generar el alcance de su rango de fechas, consulte URL y credenciales de OData.

Si está utilizando un informe personalizado como fuente de datos, el rango de fechas de la URL que proporcione al generar su URL de OData reemplaza el rango que estableció en el informe personalizado. Solo podrá ver los datos en el rango de fechas que establezca en la URL de OData. Este rango de fechas aún puede agotar el tiempo de espera si solicita un rango de fechas mayor al que el conjunto de datos puede admitir.

Conectarse a Tableau

Después de generar el token de API, generar la URL de OData y tener a la mano sus credenciales, puede conectarse a Tableau.

Ejecute la aplicación de escritorio de Tableau.
1. En el menú Conectar, seleccione Más... > OData.
2. En el formulario, ingrese la URL de OData que creó y sus credenciales y luego Iniciar sesión.
3. De la lista de tablas disponibles, cree un informe.
  
  Puede arrastrar y soltar las tablas seleccionadas en el panel derecho para crear un modelo de datos.
4. Cuando termine, haga clic en Hoja 1 en la parte inferior para extraer datos de Samsara.
  
  Puede tomar tiempo dependiendo de la cantidad de tablas y datos seleccionados.
  
  Después de que se cree la base de datos extraída, ahora puede usar las fuentes a la izquierda para crear un informe.
Ejecutar en Tableau Cloud
1. Vaya a https://online.tableau.com/.
  
  Puede usar la fuente de OData de Samsara en sus libros de trabajo actuales o crear otro desde cero.
2. Seleccione el ícono de cilindro para agregar una nueva fuente de datos de Samsara.
3. Desde la ventana emergente Conectar a datos, haga clic en Conectores, luego seleccione OData.
4. En el formulario, ingrese la URL de OData que creó y sus credenciales y luego Iniciar sesión.
  
  Recuerde seleccionar Nombre de usuario y contraseña como el método de autenticación.
5. Seleccione tablas y configure cualquier relación entre ellas como con cualquier otra fuente de datos de Tableau.
  
  La lista de tablas se extrae del conector y se muestra en el lado izquierdo.
6. Cuando termine, haga clic en Hoja 1 en la parte inferior para extraer datos de Samsara.
  
  Puede tomar tiempo dependiendo de la cantidad de tablas y datos seleccionados.