Data Sharing User Guide
User Guide
0 mins to read
Erfahren Sie mehr über die Extendable Services-Technologie, mit der Benutzer mit vertrauenswürdigen Geschäftspartnern zusammenarbeiten können, indem sie ihre Telematikdaten anderen Benutzern der Fuhrparkmanagement-Anwendung zur Verfügung stellen. Dieses Dokument beschreibt den Prozess des Sendens, Stornierens und Empfangs einer Extendable Services-Anforderung.
Partnerhandbuch
Mai 2024
Inhaltsverzeichnis
Einleitung
Die Datenfreigabe ist eine Technologie zur sicheren Freigabe von Daten für andere Benutzer. Zweck ist es, Benutzern eine Verbindung und Zusammenarbeit mit vertrauenswürdigen Geschäftspartnern zu ermöglichen, indem sie ihre Telematikdaten anderen MyGeotab-Benutzern zur Verfügung stellen. Mit der Datenfreigabe können Benutzer zum Beispiel sicherheits- und leistungsbezogene Daten mit Versicherungen teilen, um günstigere Beiträge zu erhalten, oder Motordiagnosedaten mit Wartungsdienstleistern austauschen, um bei Reparaturen Kosten zu sparen.
✱ HINWEIS: Mit MyGeotab (Softwareversion 2101 oder höher) ist die Datenfreigabe für alle Datenbanken mit den folgenden Standardtarifen verfügbar: Base, Regulatory, Pro, und ProPlus.
Der erste Schritt bei der Datenfreigabe besteht in einer Transaktion zwischen zwei MyGeotab-Benutzern: Ein Datenbankadministrator, der eine Anfrage zur Freigabe von Telematikdiensten an eine andere Datenbank sendet sowie ein Datenbankbenutzer, der die Anfrage je nach den Interessen seines Unternehmens akzeptiert oder ablehnt. Wenn die Datenfreigabe aktiviert ist, werden Daten gleichzeitig an die angegebenen Datenbanken gesendet.
! WICHTIG: Wenn zu diesem Zeitpunkt der Tarif der gemeinsamen Datenbank höher ist als der Tarif der primären Datenbank, erhält die primäre Datenbank Telematikdaten, die im höheren Tarif enthalten sind. Dabei handelt es sich um eine Anomalie, die keine Auswirkungen auf die aktuellen Abrechnungssätze für beide Datenbanken hat. Wenn jedoch der Tarif der gemeinsamen Datenbank niedriger ist als der Tarif der primären Datenbank, werden keine Änderungen an keinem der Tarife vorgenommen, und jede Datenbank erhält die Telematikdaten, die sie abonniert hat. Wir gehen davon aus, dieses Problem in einer demnächst erhältlichen Version zu lösen, in der sowohl primäre als auch gemeinsame Datenbanken Telematikdaten auf der Grundlage ihrer jeweiligen Tarife erhalten.
Darüber hinaus ermöglicht die Datenfreigabe das Senden von Daten an Datenbanken mit unterschiedlichen Tarifen. Beispielsweise können Daten zwischen einer Datenbank im Basis-Tarif und einer anderen Datenbank im ProPlus-Tarif geteilt werden. Um Daten in den MyGeotab-Datenbanken über das MyGeotab-Portal oder die API aufzurufen, muss der Benutzer über ein Konto verfügen. Das folgende Diagramm bietet einen kurzen Überblick über den Datenfreigabeprozess in MyGeotab.
! WICHTIG: Zur Verbesserung unserer Produkte können wir jederzeit und ohne vorherige Ankündigung das Design, die Darstellung oder die Funktionalität der Software ändern. Die hier gezeigten Bilder dienen der Veranschaulichung und können in der Software geringfügig anders aussehen.
Hinweise und Anmerkungen
Lesen Sie die folgenden Informationen sorgfältig durch, bevor Sie beginnen.
✱ VORAUSSETZUNGEN:
- Telematikdienste können nur zwischen aktiven Datenbanken in MyGeotab geteilt werden.
- Um freigegebene Telematikdaten aufzurufen, müssen Benutzer über ein Konto in MyGeotab verfügen.
- Um Anfragen für die Datenfreigabe in MyGeotab anzunehmen/abzulehnen, müssen Benutzer über die Sicherheitsfreigabe SecurityEditDeviceShare verfügen.
- Um die Datenfreigabe in MyGeotab aufzurufen, müssen Benutzer über die Sicherheitsfreigabe SecurityEditDeviceShare verfügen.
- Um die Datenfreigabe in MyAdmin aufzurufen, müssen Benutzer über die Rolle ExtendedServices-View verfügen.
- Um die Datenfreigabe in MyAdmin zu deaktivieren, müssen Benutzer über die Rolle ExtendedServices-Admin verfügen.
✱ DEFINITIONEN:
✱ HINWEISE:
- Gemeinsame Tarife sind für die Kategorien Basis, Regulatory, Pro und ProPlus verfügbar.
- Primäre und gemeinsame Datenbanken müssen nicht den gleichen Tarif abonniert haben, um die Datenfreigabe nutzen zu können.
- Nur jene Daten, die im Tarif enthalten sind, können freigegeben und geteilt werden. Die Abrechnung beginnt, sobald die Anfrage akzeptiert wurde.
- Fahrer-, Gruppen- und Zonennamen sind privat und werden im Rahmen der Datenfreigabe nicht geteilt.
- Die einzige Möglichkeit für Partner, den Tarif in der gemeinsamen Datenbank zu aktualisieren, ist die Deaktivierung der bestehenden Datenfreigabe und der primären Datenbank, um die Anfrage für die Datenfreigabe mit dem neuen gemeinsamen Tarif erneut zu senden.
- Nur Partner können die Datenfreigabe in einer gemeinsamen Datenbank beenden.
MyGeotab SDK
API | Beschreibung |
DeviceShare | Gerätefreigabe bedeutet, dass Streaming-Daten von einem Gerät mit mehreren Datenbanken geteilt werden. Eine Datenbank, die der primäre Geräteabonnent ist, kann die Daten mit einer oder mehreren anderen Datenbanken teilen. |
DeviceShareSearch | Das Objekt, mit dem die Argumente bei der Suche nach DeviceShare(s) angegeben werden. |
DeviceShareStatus | Die verschiedenen Status, die ein DeviceShare haben kann. |
DeviceShareType | Stellt den Datenflusstyp für ein DeviceShare dar. |
Weitere Informationen finden Sie im Abschnitt „DeviceShare“ in MyGeotab SDK.
Datenfreigabe über MyAdmin
Die Datenfreigabe ist direkt in MyAdmin als zentraler Zugriffspunkt für gemeinsam genutzte Telematikdienste von einer primären Datenbank zu einer gemeinsamen Datenbank verfügbar – vom Kunden initiiert. Als Partner sehen Sie datenbankbezogene Informationen in MyAdmin auf der Seite Datenfreigabe-Center an.
Datenbankinformationen einsehen
Um auf die Seite Datenfreigabe-Center zuzugreifen, navigieren Sie im Hauptmenü zu Geräte> Datenfreigabe-Center.
Auf der Seite Datenfreigabe-Center wird eine Liste von Geräten angezeigt, die GO-Geräte für mehrere Datenbanken gemeinsam nutzen. Um Informationen für ein bestimmtes Gerät zu sehen, verwenden Sie zum Eingrenzen der Ergebnisse die Filteroptionen und wählen dann die Option Suche aus. In der Tabelle werden die folgenden Informationen angezeigt:
- Seriennummer (bis zu 500) – gibt die Seriennummer des GO-Geräts an, das Telematikdaten mit der gemeinsamen Datenbank teilt.
- Datenbank – gibt den Namen der gemeinsamen Datenbank an.
- Status – zeigt den Status der Anfrage für die Datenfreigabe an (d. h. Aktiv, Ausstehend, Abgelehnt, Beendet oder Fehler).
- Datum der letzten Aktualisierung – zeigt das Datum an, an dem die Einstellungen für die Datenfreigabe zuletzt aktualisiert wurden.
- Stream-Tarif – zeigt den Tarif des GO-Geräts an, das der gemeinsamen Datenbank angehört.
- Service-ID – gibt die ID-Nummer für den Stream an.
✱ HINWEIS: Die Aktualisierung des Status kann bis zu 30 Minuten dauern.
Geräteabonnement aus primärer Datenbank beenden
Das Geräteabonnement kann über MyAdmin auf der Seite Geräteverwaltung aus der primären Datenbank beendet werden. Sobald der Gerätetarif für das angegebene GO-Gerät beendet wurde, wird das Konto der primären Datenbank nicht mehr in Rechnung gestellt.
! WICHTIG: Das Beenden des Geräteabonnements ist ein separater Prozess und nicht mit dem Deaktivieren des Geräts in der primären Datenbank gleichzusetzen. Das Gerät kann nicht aus der primären Datenbank entfernt werden, während eine Datenfreigabe an eine gemeinsame Datenbank läuft. Die Datenfreigabe muss zuerst aus der/den freigegebenen Datenbank(en) beendet werden, bevor das Gerät aus der primären Datenbank entfernt werden kann.
✱ HINWEIS: Die Änderung des Tarifs des Geräts in der primären Datenbank wirkt sich nicht auf die Abonnements für die Datenfreigabe in den gemeinsamen Datenbanken aus.
Gehen Sie folgendermaßen vor, um das Geräteabonnement in der primären Datenbank zu beenden:
1 | Rufen Sie die MyAdmin-Website auf. |
2 | Navigieren Sie im Hauptmenü zu Geräte > Geräteverwaltung. |
3 | Wählen Sie auf der Seite Geräteverwaltung die Filteroption Seriennummer aus. |
4 | Geben Sie die gewünschte Seriennummer in die Filteroption Seriennummer ein, gefolgt von einem Komma oder Zeilenumbruch (Eingabe- oder Return-Taste), und wählen Sie Anwenden. |
| |
5 | Wählen Sie in der Tabelle die Seriennummer des Geräts aus, um das Gerät zu bearbeiten. Die Seite wird aktualisiert und zeigt detaillierte Informationen zu dem Gerät an. |
6 | Wählen Sie auf der Registerkarte Details unter „Tarif und Abrechnung“ die Option Deaktivieren aus.
|
7 | Wählen Sie im Popup-Fenster einen Grund für Deaktivierung und gegebenenfalls einen Grund für Aufhebung der Zuordnung aus. |
| |
8 | Geben Sie Kommentare ein, und wählen Sie Bestätigen, um mit der Beendigung des Abonnements des Geräts fortzufahren. |
Sie haben das Geräteabonnement erfolgreich beendet.
Das System bestätigt, dass die Änderungsanforderung weitergeleitet wurde und die Anfrage in der Spalte „Ausstehende Änderung(en)“ in der Geräteverwaltung hinzugefügt wird. Die Bearbeitung der Änderungsanforderung kann bis zu 24 Stunden dauern. Sobald die Änderungsanforderung genehmigt wurde, wird der Status in der Spalte aktiver Abrechnungstarif auf Nur Dienstleistungen aktualisiert.
Datenfreigabe für das gemeinsame Abonnement beenden
Die Datenfreigabe kann nur über MyAdmin auf der Seite Datenfreigabe-Center beendet werden. Sobald die Datenfreigabedienste für das angegebene GO-Gerät beendet wurden, wird dem Konto der gemeinsamen Datenbank nichts mehr berechnet.
Gehen Sie folgendermaßen vor, um die Datenfreigabe zu beenden:
1 | Navigieren Sie im Hauptmenü zu Geräte > Datenfreigabe-Center. |
2 | Verwenden Sie auf der Seite Datenfreigabe-Center die Filteroptionen, um die Ergebnisse einzugrenzen, und wählen Sie dann Suchen aus. |
3 | Klicken oder tippen Sie auf das Gerät, für das Sie die Datenfreigabedienste beenden möchten. |
4 | Wählen Sie Deaktivieren. |
5 | Wählen Sie im Popup-Fenster senden, um eine Anfrage zur Deaktivierung der Datenfreigabe einzureichen. |
Nach Deaktivierung ändert sich der Status des gemeinsamen Abonnements von aktiv in deaktiviert, und der gemeinsamen Datenbank wird nichts mehr in Rechnung gestellt.
✱ HINWEIS: Die Aktualisierung des Status kann bis zu 30 Minuten dauern.
Häufig gestellte Fragen (FAQ)
Datenfreigabe über MyGeotab
Welche MyGeotab-Version ist für die Datenfreigabe über MyGeotab erforderlich?
MyGeotab-Version 2101 oder höher ist erforderlich, damit die Datenbank die Datenfreigabe verwenden und Daten mit einer anderen Datenbank teilen kann.
Wie kann ich überprüfen, ob die Datenfreigabe aktiviert wurde?
Gehen Sie folgendermaßen vor, um zu überprüfen, ob die Datenfreigabe aktiviert wurde:
1 | Rufen Sie die MyAdmin-Website auf. |
2 | Gehen Sie im Hauptmenü zu Geräte > Geräteverwaltung. |
3 | Geben Sie auf der Seite Geräteverwaltung den Kontonamen ein. |
4 | Wählen Sie Ansicht anpassen, Gerätekommunikation unter Ansichten und dann Anwenden aus . |
| |
5 | Prüfen Sie in der Spalte gemeinsame Datenbank(en), ob die Datenfreigabe aktiviert wurde. |
Die Spalte gemeinsame Datenbank(en) in der Tabelle gibt an, ob ein GO-Gerät von Datenbanken gemeinsam genutzt wird. Diese Schaltfläche ist nur für Benutzer mit den Rollen Device_Admin und SharedDatabases-View sichtbar.
Alternativ können Kunden den Datenfluss zu den einzelnen MyGeotab-Datenbanken anhand der Tabelle auf der Seite Geräteverwaltung in MyAdmin überprüfen. In den Spalten Primäre Datenbank und Gemeinsame Datenbank(en) in der Tabelle auf der Seite Geräteverwaltung wird der Kommunikationsstatus angezeigt. Wenn in der Tabelle der Name der primären Datenbank und der gemeinsamen Datenbank(en) angezeigt wird, bedeutet dies, dass das Gerät mit beiden Datenbanken kommuniziert.
Wie viel kostet die Nutzung der Datenfreigabe?
Die Datenfreigabe ist innerhalb der Tarife Base, Regulatory, Pro und ProPlus verfügbar. Die Preise für diese Tarife für die Datenfreigabe werden Partnern auf der Seite Tarife in MyAdmin zur Verfügung gestellt.
Was geschieht, wenn das GO-Gerät nicht mit einer primären Datenbank verknüpft ist?
Die Datenfreigabe kann nur aktiviert werden, wenn das GO-Gerät mit einer primären Datenbank verknüpft ist.
