Integratie met Tableau

De Samsara OData Connector stelt u in staat om Samsara datasets en aangepaste rapporten die u binnen Samsara heeft gemaakt, naar Tableau te brengen voor gebruik in geavanceerde datavisualisaties en verdere analyse.

Vereisten

Tableau: Explorer- of Creator-licentie op het e-mailalias dat u gebruikt met Tableau.

Samsara: API-toegang met leesrechten

Implementatie

Samsara heeft de integratie gebouwd en zal indien nodig helpen met implementaties. Volg de onderstaande stappen om te beginnen. Als er problemen zijn, neem dan contact op met Samsara Support.

Genereer de API-token van Samsara:
1. Log in op uw Samsara-dashboard.
2. Selecteer het pictogram Instellingen ( ) onderaan uw Vloot menu en klik vervolgens op Apps.
3. Klik op Bèta Code in de rechterbovenhoek.
4. Voor de invoercode, typ tableau-bèta in, en klik vervolgens op Installeren.
5. Ga akkoord met de algemene voorwaarden en klik vervolgens op Token Genereren.
6. Kopieer de gegenereerde API-token.
  
  Deze API-token zal worden gebruikt om de Tableau Connector te authenticeren. Als u de token verliest, kunt u deze niet ophalen en moet u een nieuwe token genereren.
Genereer OData-URL en inloggegevens.
Verbind met Tableau.

OData-URL en inloggegevens

Rapporten en gegevensbereik worden gegenereerd in OData via de verbindings-URL, niet via een datumkiezer zoals bij andere verbindingsprotocollen.

Om een OData-URL te genereren, voert u de volgende workflow uit:

Verzamel de volgende informatie:
- De regio van uw organisatie.
  
  U kunt deze identificeren door het domein in uw dashboard-URL te controleren (bijvoorbeeld cloud.samsara.com, cloud.ca.samsara.com of cloud.eu.samsara.com).
- Het datumbereik voor de gegevens waarmee u wilt werken.
  
  Zorg ervoor dat het bereik binnen het maximaal toegestane voor de dataset valt; anders zal het extract niet worden uitgevoerd.
- Uw organisatie-ID.
- Uw API-token.
  
  Als u er nog geen heeft, zie Implementatie.
Maak de URL-verbinding met behulp van dit sjabloon als referentie:

https:///data-connectors/odata/v4///
1. Vervang <connector_domain> door het regionale dataverbindingsdomein dat aan uw organisatie is toegewezen:
  - data-connector.samsara.com
  - data-connector.ca.samsara.com
  - data-connector.eu.samsara.com
2. Vervang door de startdatum van het datumbereik, in het formaat JJJJ-MM-DD.
3. Vervang door de einddatum van het datumbereik, in het formaat JJJJ-MM-DD.
Een organisatie die het EU regionale dataverbindingsdomein toegewezen heeft gekregen met een datumbereik van 1 januari 2025 tot en met 31 januari 2025, zou bijvoorbeeld de volgende URL gebruiken: https://data-connector.eu.samsara.com/data-connectors/odata/v4/2025-01-01/2025-01-31/.

De parameters moeten in de URL worden bewerkt, de datum kan achteraf niet worden bewerkt.

Samsara raadt aan om niet meer dan 1 jaar maximaal datumbereik op een dataset te gebruiken. Voor meer informatie, zie Prestaties en datumbereiken.
Bewaar uw organisatie-ID en API-token om te gebruiken als inloggegevens wanneer u Verbinding maken met Tableau.

Uw gebruikersnaam is uw organisatie-ID. Uw wachtwoord is uw API-token.

Prestaties en datumbereiken

Dataset tijdsbereiklimieten zijn van toepassing voor zowel Power BI als Tableau-connectoren. Samsara raadt aan om niet meer dan een maximaal bereik van 1 jaar op een dataset te hanteren. Bijzonder grote en complexe gegevensopvragingen, zoals die in de volgende tabel worden vermeld, kunnen verlopen als u verzoeken doet die langer zijn dan het voorgestelde maximale bereik. Houd bij het invoeren van een gegevensbereik in uw URL rekening met het volgende:

Dataset	Aanbevolen maximaal datumbereik
Assetactiviteiten	6 maanden
Assetdiagnostiek	6 maanden
Assets	1 jaar
Chauffeurs	1 jaar
Voertuiginspecties	3 maanden
Formuliersubmissies	6 maanden
Diensturenlogbestanden	3 maanden
Diensturen niet-toegewezen segmenten	3 maanden
Diensturenovertredingen	3 maanden
Stationair draaigebeurtenissen	3 maanden
Problemen	6 maanden
Kilometerteller sprongen	6 maanden
Omkering gebeurtenissen	1 week
Veiligheidsgebeurtenissen	6 maanden
Snelheidsovertreding Intervallen	3 maanden
Tachograaflogbestanden	3 maanden
Training	6 maanden
Reizen	3 maanden

Datumselectie wordt gedaan via URL-parameters, niet via een datumselector in de gebruikersinterface. Voor meer informatie over het genereren van uw datumbereik, zie OData-URL en inloggegevens.

Als u een aangepast rapport als gegevensbron gebruikt, overschrijft het datumbereik van de URL dat u opgeeft bij het genereren van uw OData-URL het bereik dat u in het aangepaste rapport hebt ingesteld. U kunt alleen gegevens zien voor het datumbereik dat u in de OData-URL hebt ingesteld. Dit datumbereik kan nog steeds verlopen als u een datumbereik aanvraagt dat groter is dan de dataset kan ondersteunen.

Verbinding maken met Tableau

Nadat u het API-token hebt gegenereerd , uw OData-URL hebt gegenereerd en over uw inloggegevens beschikt, kunt u verbinding maken met Tableau.

Start de Tableau desktop app.
1. In het menu Verbinden, selecteert u Meer... > OData.
2. Voer in het formulier uw OData-URL die u heeft aangemaakt en uw inloggegevens in en log in.
3. Bouw uw rapport vanuit de lijst met beschikbare tabellen.
  
  U kunt geselecteerde tabellen naar het rechterpaneel slepen om een datamodel te creëren.
4. Wanneer u klaar bent, klikt u onderaan op Blad 1 om gegevens van Samsara op te halen.
  
  Het kan enige tijd duren, afhankelijk van het aantal geselecteerde tabellen en gegevens.
  
  Nadat de extractdatabase is aangemaakt, kunt u nu de bronnen aan de linkerkant gebruiken om een rapport te maken.
Voer uit in Tableau Cloud
1. Ga naar https://online.tableau.com/.
  
  U kunt de Samsara OData-bron in uw huidige werkboeken gebruiken, of een nieuwe vanaf nul creëren.
2. Selecteer het cilinderpictogram om een nieuwe Samsara-gegevensbron toe te voegen.
3. Klik in de Connect to Data-pop-up op Connectors en selecteer vervolgens OData.
4. Voer in het formulier uw OData-URL die u heeft aangemaakt en uw inloggegevens in en log in.
  
  Vergeet niet de Gebruikersnaam en Wachtwoord als authenticatiemethode te selecteren.
5. Selecteer tabellen en stel eventuele relaties tussen hen in zoals bij elke andere Tableau-gegevensbron.
  
  De tabel lijst wordt uit de Connector gehaald en aan de linkerkant weergegeven.
6. Wanneer u klaar bent, klikt u onderaan op Blad 1 om gegevens van Samsara op te halen.
  
  Het kan enige tijd duren, afhankelijk van het aantal geselecteerde tabellen en gegevens.