Usługi rozszerzalne
User Guide
8 mins to read
Dowiedz się więcej o technologii usług rozszerzalnych, która umożliwia użytkownikom bezpieczne udostępnianie danych i współpracę z zaufanymi partnerami biznesowymi poprzez udostępnienie ich danych telematycznych innym użytkownikom aplikacji do zarządzania flotą. Niniejszy dokument opisuje proces wysyłania, anulowania i otrzymywania żądań usług rozszerzalnych.
Podręcznik dla partnerów
Maj 2024 r.
Spis treści
Wprowadzenie
Udostępnianie danych to technologia, która umożliwia łączenie się i współpracę z zaufanymi partnerami biznesowymi poprzez bezpieczne udostępnienie danych telematycznych innym użytkownikom MyGeotab. Dzięki tej technologii użytkownicy mogą na przykład udostępniać dane dotyczące bezpieczeństwa i wydajności dostawcom usług ubezpieczeniowych lub diagnostyczne dane z silnika dostawcom usług serwisowych, aby zaoszczędzić na ubezpieczeniach i naprawach.
✱ PAMIĘTAJ: W przypadku MyGeotab (wersja oprogramowania 2101 lub nowsza) udostępnianie danych będzie dostępne dla wszystkich baz danych w następujących standardowych planach taryfowych: Base, Regulatory, Pro i ProPlus.
Udostępnianie danych rozpoczyna się od transakcji między dwoma użytkownikami MyGeotab: administratorem bazy danych, który składa żądanie udostępniania usług telematycznych innej bazie danych, oraz użytkownikiem bazy danych, który akceptuje lub odrzuca żądanie w oparciu o potrzeby swojej firmy. Po włączeniu udostępniania danych dane są jednocześnie wysyłane do określonych baz danych.
! WAŻNE: Jeśli w danej chwili plan taryfowy w udostępnionej bazie danych jest na wyższym poziomie niż plan taryfowy w głównej bazie danych, główna baza danych otrzymuje dane telematyczne związane z planem taryfowym wyższego poziomu. Jest to anomalia, która nie będzie miała wpływu na bieżące stawki rozliczeniowe dla żadnej z tych baz danych. Jeśli jednak plan taryfowy w udostępnionej bazie danych jest niższy od planu taryfowego w głównej bazie danych, nie ma zmian w żadnym z planów taryfowych i każda baza danych otrzymuje dane telematyczne, które zostały wykupione. Planujemy rozwiązać ten problem w nadchodzącej wersji, w której zarówno główna, jak i udostępniona baza danych będą otrzymywać dane telematyczne w oparciu o ich plany taryfowe we wszystkich przypadkach.
Dodatkowo udostępnianie danych umożliwia przesyłanie danych do baz danych w ramach różnych planów taryfowych. Na przykład dane mogą być udostępniane między bazą danych znajdującą się w planie taryfowym Base a inną bazą danych znajdującą się w planie taryfowym ProPlus. Aby przeglądać dane w bazach danych MyGeotab — albo przez portal MyGeotab, albo za pomocą interfejsu API — użytkownik musi mieć założone konto. Poniższy schemat przedstawia procedurę korzystania z udostępniania danych w MyGeotab.
! WAŻNE: W ramach doskonalenia naszych produktów możemy w dowolnym momencie i bez ostrzeżenia zmienić konstrukcję, prezentację lub funkcjonalność oprogramowania. Przedstawione ilustracje mają jedynie charakter poglądowy i mogą wyglądać nieco inaczej w oprogramowaniu.
Uwagi i przemyślenia
Przed rozpoczęciem dokładnie zapoznaj się z poniższymi informacjami.
✱ WARUNKI WSTĘPNE:
- Usługi telematyczne można udostępniać tylko pomiędzy bazami danych widniejącymi jako aktywne bazy danych w MyGeotab.
- Aby wyświetlać udostępnione dane telematyczne, użytkownicy muszą mieć założone konto w MyGeotab.
- Aby akceptować/odrzucać żądania udostępniania danych w MyGeotab, użytkownicy muszą mieć uprawnienia SecurityEditDeviceShare.
- Aby wyświetlać udostępnianie danych w MyGeotab, użytkownicy muszą mieć uprawnienia SecurityViewDeviceShare.
- Aby wyświetlać udostępnianie danych w MyAdmin, użytkownicy muszą mieć przypisaną rolę ExtendedServices-View.
- Aby zakończyć działanie udostępniania danych w MyAdmin, użytkownicy muszą mieć przypisaną rolę ExtendedServices-Admin.
✱ DEFINICJE:
✱ PAMIĘTAJ:
- Udostępnione plany taryfowe są dostępne w wersjach Base, Regulatory, Pro i ProPlus.
- Główne i udostępnione bazy danych nie muszą używać tego samego planu taryfowego, aby można było korzystać z udostępniania danych.
- Można udostępniać tylko dane powiązane z planem taryfowym. Proces rozliczenia rozpoczyna się natychmiast po zaakceptowaniu żądania.
- Imiona i nazwiska kierowców, nazwy grup i stref są prywatne i nie są wyświetlane w udostępnionym strumieniu danych.
- Jedynym sposobem na zaktualizowanie planu taryfowego w udostępnionej bazie danych przez partnerów jest zakończenie istniejącego udostępniania i głównej bazy danych w celu ponownego wysłania żądania udostępnienia z nowym udostępnionym planem taryfowym.
- Usługę udostępniania w udostępnionej bazie danych mogą zakończyć jedynie partnerzy.
SDK MyGeotab
API | Opis |
DeviceShare | Udostępnianie urządzenia oznacza strumieniowe przesyłanie danych z urządzenia do wielu baz danych. Baza danych, która jest głównym subskrybentem urządzenia, może udostępniać dane jednej lub wielu innym bazom danych. |
DeviceShareSearch | Obiekt używany do określania argumentów podczas wyszukiwania DeviceShare. |
DeviceShareStatus | Różne statusy, jakie może posiadać DeviceShare. |
DeviceShareType | Reprezentuje typ przepływu danych dla DeviceShare. |
Więcej informacji można znaleźć w sekcji DeviceShare w zestawie MyGeotab SDK.
Udostępnianie danych przez MyAdmin
Udostępnianie danych jest dostępne bezpośrednio w MyAdmin jako pojedynczy punkt dostępu do udostępnionej usługi telematycznej z głównej bazy danych na udostępnioną bazę danych — zainicjowaną przez klienta. Jako partner możesz przeglądać informacje dotyczące bazy danych w MyAdmin na stronie Centrum udostępniania danych.
Wyświetlanie informacji o bazie danych
Aby wyświetlić stronę Centrum udostępniania danych, przejdź do opcji Urządzenia > Centrum udostępniania danych w menu głównym.
Na stronie Centrum udostępniania danych wyświetlana jest lista urządzeń, które udostępniają urządzenia GO między wieloma bazami danych. Aby wyświetlić informacje dotyczące określonego urządzenia, użyj opcji filtrowania pozwalających na zawężenie wyników, a następnie wybierz opcję Wyszukaj. W tabeli wyświetlane są następujące informacje:
- Numer seryjny (do 500) — określa numer seryjny urządzenia GO, które udostępniło dane telematyczne udostępnionej bazie danych.
- Baza danych — określa nazwę udostępnionej bazy danych.
- Status — wskazuje status żądania udostępniania danych (tj. aktywne, oczekujące, odrzucone, zakończone lub błąd).
- Ostatnia aktualizacja — wskazuje datę ostatniej aktualizacji ustawień dotyczących udostępniania danych.
- Plan strumienia — określa plan taryfowy urządzenia GO należącego do udostępnionej bazy danych.
- Identyfikator usługi — określa numer identyfikacyjny strumienia.
✱ PAMIĘTAJ: Aktualizacja statusu może potrwać do 30 minut.
Zakończ subskrypcję urządzenia z głównej bazy danych
Subskrypcję urządzenia można zakończyć z głównej bazy danych za pośrednictwem MyAdmin na stronie Zarządzanie urządzeniami. Po zakończeniu planu urządzenia dla określonego urządzenia GO konto głównej bazy danych nie jest już obciążane opłatami.
! WAŻNE: Zakończenie subskrypcji urządzenia i zakończenie działania urządzenia w głównej bazie danych to dwa odrębne procesy. Urządzenia nie można usunąć z głównej bazy danych podczas udostępniania usług udostępnionej bazie danych. Przed usunięciem urządzenia z głównej bazy danych należy najpierw zakończyć każde wystąpienie udostępniania danych udostępnionej bazie danych.
✱ PAMIĘTAJ: Zmiana planu taryfowego urządzenia w głównej bazie danych nie ma wpływu na subskrypcje udostępniania danych w udostępnionych bazach danych.
Aby zakończyć subskrypcję urządzenia w głównej bazie danych, wykonaj następujące czynności:
1 | Przejdź do witryny MyAdmin. |
2 | W menu głównym przejdź do opcji Urządzenia > Zarządzanie urządzeniami. |
3 | Na stronie Zarządzanie urządzeniami wybierz filtr Numer seryjny. |
4 | Wprowadź żądany numer seryjny w filtrze Numer seryjny, wprowadź przecinek lub podział wiersza (klawisz Enter lub Return), a następnie wybierz opcję Zastosuj. |
|
|
5 | W tabeli wybierz numer seryjny urządzenia, aby edytować urządzenie. Strona zostanie odświeżona, aby wyświetlić szczegółowe informacje o urządzeniu. |
6 | Na karcie Szczegóły wybierz opcję Zakończ w sekcji Plan i rozliczenia.
|
7 | W razie potrzeby w wyskakującym oknie wybierz Powód zakończenia i Powód zastąpienia. |
|
|
8 | Wprowadź komentarze, a następnie wybierz opcję Potwierdź, aby kontynuować zakończenie subskrypcji urządzenia. |
Subskrypcja urządzenia została zakończona pomyślnie.
System potwierdzi, że żądanie zmiany planu zostało wysłane, a żądanie zostanie dodane do kolumny Oczekujące zmiany w sekcji Zarządzanie urządzeniami. Przetworzenie żądania zmiany planu może potrwać do 24 godzin. Po zatwierdzeniu żądania zmiany planu status w kolumnie Aktywny plan rozliczeniowy zmienia się na Tylko usługi.
Zakończenie udostępniania danych dla udostępnionej subskrypcji
Udostępnianie danych można zakończyć tylko za pośrednictwem MyAdmin na stronie Centrum udostępniania danych. Po zakończeniu udostępniania danych dla określonego urządzenia GO konto udostępnionej bazy danych nie jest już obciążane opłatami.
Aby zakończyć udostępnianie danych, wykonaj następujące czynności:
1 | W menu głównym przejdź do opcji Urządzenia > Centrum udostępniania danych. |
2 | Na stronie Centrum udostępniania danych użyj filtra, aby zawęzić wyniki, a następnie wybierz opcję Wyszukaj. |
| |
3 | Kliknij lub dotknij urządzenie, dla którego chcesz zakończyć usługi udostępniania danych. |
4 | Wybierz opcję Zakończ. |
5 | W wyskakującym oknie wybierz opcję Wyślij, aby wysłać żądanie zakończenia. |
Po zakończeniu usługi stan udostępnionej subskrypcji zmienia się z Aktywna na Zakończona, a Udostępniona baza danych nie jest już obciążana opłatami.
✱ PAMIĘTAJ: Aktualizacja statusu może potrwać do 30 minut.
Często zadawane pytania
Udostępnianie danych poprzez MyGeotab
Od której wersji MyGeotab można korzystać z udostępniania danych za pośrednictwem MyGeotab?
Aby baza danych mogła korzystać z udostępniania danych i udostępniać dane innej bazie danych, trzeba dysponować wersją 2101 lub nowszą MyGeotab.
Jak sprawdzić, czy udostępnianie danych zostało włączone?
Aby sprawdzić, czy udostępnianie danych jest włączone, wykonaj następujące czynności:
1 | Przejdź do witryny MyAdmin. |
2 | Z menu głównego wybierz kolejno Urządzenia > Zarządzanie urządzeniami. |
3 | Na stronie Zarządzanie urządzeniami wprowadź nazwę konta. |
4 | Wybierz opcję Dostosuj widok i Komunikacja z urządzeniem w sekcji Widoki, a następnie wybierz opcję Zastosuj. |
|
|
5 | Przejrzyj kolumnę Udostępnione bazy danych, aby sprawdzić, czy usługi udostępniania danych zostały włączone. |
Kolumna Udostępnione bazy danych w tabeli wskazuje, czy urządzenie GO jest udostępniane bazom danych. Kolumna jest widoczna tylko dla użytkowników z rolami Device_Admin i SharedDatabases-View.
Przepływ danych do indywidualnych baz danych MyGeotab klienci mogą też zweryfikować, używając tabeli na stronie Zarządzanie urządzeniami w MyAdmin. W kolumnach Główna baza danych i Udostępnione bazy danych w tabeli na stronie Zarządzanie urządzeniami wyświetlany jest status komunikacji. Jeśli w tabeli wyświetlana jest nazwa głównej i udostępnionej bazy danych, oznacza to, że urządzenie komunikuje się z obiema bazami danych.
Jak wygląda cennik udostępniania danych?
Plany taryfowe dostępne dla udostępnionej bazy danych to: Base, Regulatory, Pro i ProPlus. Ceny planów taryfowych dotyczących udostępniania danych będą dostępne dla partnerów na stronie Plany taryfowe w MyAdmin.
Co się stanie, jeśli urządzenie GO nie jest powiązane z główną bazą danych?
Udostępnianie danych nie może być włączone, jeśli urządzenie GO nie jest powiązane z główną bazą danych.
