Integration mit Tableau

Der Samsara OData Connector ermöglicht es Ihnen, Samsara-Datensätze und benutzerdefinierte Berichte, die Sie innerhalb von Samsara erstellt haben, in Tableau zu integrieren, um sie in fortgeschrittenen Datenvisualisierungen und weiteren Analysen zu verwenden.

Anforderungen

Tableau: Explorer- oder Creator-Lizenz auf dem E-Mail-Alias, den Sie mit Tableau verwenden.

Samsara: API-Zugriff mit Leseberechtigungen

Implementierung

Samsara hat die Integration entwickelt und wird bei Bedarf bei Implementierungen unterstützen. Folgen Sie den untenstehenden Schritten, um zu beginnen. Wenn es irgendwelche Probleme gibt, kontaktieren Sie bitte Samsara Support.

Generieren Sie den API-Token von Samsara:
1. Melden Sie sich bei Ihrem Samsara-Dashboard an.
2. Wählen Sie unten in Ihrem Flotte Menü das Einstellungssymbol ( ), und klicken Sie dann auf Apps.
3. Klicken Sie auf Beta-Code in der oberen rechten Ecke.
4. Geben Sie für den Eingabecode tableau-beta ein und klicken Sie dann auf Installieren.
5. Stimmen Sie den Bedingungen zu und generieren Sie den Token.
6. Kopieren Sie den generierten API-Token.
  
  Dieser API-Token wird verwendet, um den Tableau Connector zu authentifizieren. Wenn Sie den Token verlieren, können Sie ihn nicht abrufen und müssen einen neuen Token generieren.
Generieren Sie die OData-URL und Anmeldedaten.
Verbinden Sie sich mit Tableau.

OData-URL und Anmeldedaten

Berichte und Datenbereichsumfang werden in OData über die Verbindungs-URL generiert, nicht über einen Datumswähler wie bei anderen Verbindungsprotokollen.

Um eine OData-URL zu generieren, führen Sie den folgenden Workflow aus:

Sammeln Sie die folgenden Informationen:
- Die Region Ihrer Organisation.
  
  Sie können sie identifizieren, indem Sie die Domain in Ihrer Dashboard-URL überprüfen (zum Beispiel cloud.samsara.com, cloud.ca.samsara.com oder cloud.eu.samsara.com).
- Der Datumsbereich für die Daten, mit denen Sie arbeiten möchten.
  
  Stellen Sie sicher, dass der Bereich innerhalb des maximal zulässigen für den Datensatz liegt; andernfalls wird der Extrakt nicht ausgeführt.
- Ihre Organisations-ID.
- Ihr API-Token.
  
  Wenn Sie noch keinen haben, siehe Implementierung.
Erstellen Sie die URL-Verbindung unter Verwendung dieser Vorlage als Referenz:

https://<connector_domain>/data-connectors/odata/v4/<start_date>/<end_date>/
1. Ersetzen Sie <connector_domain> durch die regionale Daten-Connector-Domain, die Ihrer Organisation zugewiesen ist:
  - data-connector.samsara.com
  - data-connector.ca.samsara.com
  - data-connector.eu.samsara.com
2. Ersetzen Sie <start_date> durch das Startdatum des Datumsbereichs im Format JJJJ-MM-TT.
3. Ersetzen Sie <end_date> durch das Enddatum des Datumsbereichs im Format JJJJ-MM-TT.
Zum Beispiel würde eine Organisation, der die EU-Regionale Daten-Connector-Domain mit einem Datumsbereich vom 1. Januar 2025 bis zum 31. Januar 2025 zugewiesen ist, die folgende URL verwenden: https://data-connector.eu.samsara.com/data-connectors/odata/v4/2025-01-01/2025-01-31/.

Die Parameter müssen in der URL bearbeitet werden, das Datum kann nachträglich nicht bearbeitet werden.

Samsara empfiehlt, keinen maximalen Datumsbereich von mehr als 1 Jahr in einem Datensatz zu verwenden. Weitere Informationen finden Sie unter Leistung und Datumsbereiche.
Bewahren Sie Ihre Organisations-ID und Ihren API-Token auf, um sie als Anmeldedaten zu verwenden, wenn Sie Mit Tableau verbinden.

Ihr Benutzername ist Ihre Organisations-ID. Ihr Passwort ist Ihr API-Token.

Leistung und Datumsbereiche

Datensatz-Zeitraumbeschränkungen gelten sowohl für Power BI als auch für Tableau-Connectoren. Samsara empfiehlt, dass der maximale Bereich eines Datensatzes nicht mehr als 1 Jahr beträgt. Besonders große und komplexe Datenabfragen, wie die in der folgenden Tabelle aufgeführten, können ablaufen, wenn Sie Anfragen stellen, die länger als der empfohlene maximale Bereich sind. Wenn Sie einen Datenbereich in Ihrer URL eingeben, beachten Sie Folgendes:

Datensatz	Empfohlener maximaler Datumsbereich
Asset-Aktivitäten	6 Monate
Asset-Diagnosen	6 Monate
Assets	1 Jahr
Fahrer	1 Jahr
Fahrzeugkontrollen	3 Monate
Formular-Einreichungen	6 Monate
Dienstzeit-Protokolle	3 Monate
Dienstzeit-Unzugeordnete Segmente	3 Monate
Dienstzeit-Verstöße	3 Monate
Leerlaufereignisse	3 Monate
Aufgaben	6 Monate
Kilometerzähler-Sprünge	6 Monate
Umkehrereignisse	1 Woche
Sicherheitsereignisse	6 Monate
Geschwindigkeitsüberschreitungsintervalle	3 Monate
Tachograph-Protokolle	3 Monate
Ausbildung	6 Monate
Fahrten	3 Monate

Die Datumsauswahl erfolgt über URL-Parameter, nicht über einen Datumswähler in der Benutzeroberfläche. Für weitere Informationen zur Erstellung Ihres Datumsbereichs siehe OData-URL und Anmeldedaten.

Wenn Sie einen benutzerdefinierten Bericht als Datenquelle verwenden, überschreibt der URL-Datenbereich, den Sie bei der Erstellung Ihrer OData-URL angeben, den Bereich, den Sie im benutzerdefinierten Bericht festgelegt haben. Sie können nur Daten für den Datumsbereich sehen, den Sie in der OData-URL festgelegt haben. Dieser Datumsbereich kann dennoch ablaufen, wenn Sie einen Datumsbereich anfordern, der größer ist, als der Datensatz unterstützen kann.

Mit Tableau verbinden

Nachdem Sie den API-Token generiert, Ihre OData-URL generiert und Ihre Anmeldedaten haben, können Sie sich mit Tableau verbinden.

Führen Sie die Tableau-Desktop-App aus.
1. Wählen Sie im Menü "Verbinden" Mehr... > OData aus.
2. Im Formular geben Sie Ihre erstellte OData-URL und Ihre Anmeldedaten ein und melden Sie sich an.
3. Aus der Liste der verfügbaren Tabellen erstellen Sie Ihren Bericht.
  
  Sie können ausgewählte Tabellen im rechten Bereich per Drag & Drop verschieben, um ein Datenmodell zu erstellen.
4. Wenn Sie fertig sind, klicken Sie unten auf Blatt 1, um Daten von Samsara abzurufen.
  
  Es kann je nach Anzahl der ausgewählten Tabellen und Daten Zeit in Anspruch nehmen.
  
  Nachdem die Extraktionsdatenbank erstellt wurde, können Sie nun die Quellen auf der linken Seite verwenden, um einen Bericht zu erstellen.
Führen Sie es in Tableau Cloud aus
1. Gehen Sie zu https://online.tableau.com/.
  
  Sie können die Samsara OData-Quelle in Ihren aktuellen Arbeitsmappen verwenden oder eine neue von Grund auf neu erstellen.
2. Wählen Sie das Zylindersymbol, um eine neue Samsara-Datenquelle hinzuzufügen.
3. Klicken Sie im Pop-up „Mit Daten verbinden“ auf Connectors und wählen Sie dann OData aus.
4. Im Formular geben Sie Ihre erstellte OData-URL und Ihre Anmeldedaten ein und melden Sie sich an.
  
  Denken Sie daran, Benutzername und Passwort als Authentifizierungsmethode auszuwählen.
5. Wählen Sie Tabellen aus und richten Sie Beziehungen zwischen ihnen ein, wie bei jeder anderen Tableau-Datenquelle.
  
  Die Tabellenliste wird vom Connector abgerufen und auf der linken Seite angezeigt.
6. Wenn Sie fertig sind, klicken Sie unten auf Blatt 1, um Daten von Samsara abzurufen.
  
  Es kann je nach Anzahl der ausgewählten Tabellen und Daten Zeit in Anspruch nehmen.