Portal sieci Web operatora sieci Komórkowej
Przegląd
W tym temacie opisano portal internetowy, który umożliwia operatorom komórkowym udostępnianie rozwiązań łączności bezpośrednio użytkownikom systemu Windows za pośrednictwem wyselekcjonowanych środowisk internetowych hostowanych w aplikacji Mobile Plans. Operatorzy urządzeń przenośnych muszą tworzyć swoje środowiska internetowe zgodnie z tymi zasadami projektowania, aby zapewnić użytkownikom wysoką jakość środowiska podczas nawigowania po portalu. Portal sieci Web operatora sieci Komórkowej jest używany we wszystkich scenariuszach obsługiwanych w rozwiązaniu Mobile Plans i dlatego jest jednym z najważniejszych składników programu.
Aby uzyskać więcej informacji na temat przepływu i projektowania referencyjnego portalu internetowego, zobacz przepływ portalu internetowego i projekt referencyjny.
Interfejs portalu internetowego dla urządzeń z obsługą karty eSIM
Aplikacja Mobile Plans używa kontrolki WebView do hostowania i prezentowania środowiska portalu internetowego operatora sieci Komórkowej. Portal jest wywoływany przez aplikację wywołującą bezpośrednio punkty końcowe usługi hostowanej przez operatora komórkowego, a zwracana zawartość jest renderowana bezpośrednio w kontrolce
Podczas uruchamiania WebViewkilka parametrów jest przekazywanych do portalu w ramach wywołania. Jeśli istnieje co najmniej jeden profil karty eSIM skojarzony z operatorem sieci komórkowej, identyfikatory ICCID są również przekazywane do portalu.
Poniższy przykład pokazuje te parametry uruchamiania dla urządzeń obsługujących eSIM, osadzone w wywołaniu do MyWebView.Navigate().
MyWebView.ScriptNotify += MyWebView_ScriptNotify;
List<Uri> allowedUris = new List<Uri>();
allowedUris.AddRange(AllowedNotifyUris);
MyWebView.AllowedScriptNotifyUris = allowedUris;
MyWebView.Navigate(“https://moportal.com?market=US&location=US&transactionId=%2F7RBTuSJt02OZbX8.4&eid=89033023422130000000000199055797&imei=001102000315468&iccids=8988247000101867183,8988247000103824828”);
Aby zapewnić zgodność wsteczną z aktualizacjami aplikacji, portal musi zignorować wszelkie dodatkowe parametry, które mogą być również przekazywane w żądaniu. Zapewnia to elastyczność i możliwość wprowadzenia nowych funkcji w aplikacji bez zakłócania integracji operatora sieci komórkowej.
W poniższej tabeli opisano parametry uruchamiania dostępne dla karty eSIM.
| Nazwa parametru | Opis | Przykład |
|---|---|---|
| eid | Identyfikator karty eSIM. To jest wysyłane tylko wtedy, gdy karta eSIM jest obecna. | eid= 89033024010400000100000000009136 |
| ICCIDs | Opcjonalny parametr. Określa listę identyfikatorów ICCID z profilu dostępnego wyłącznie na karcie eSIM. Jeśli na karcie eSIM nie ma żadnych identyfikatorów ICCID pasujących do MO, parametr ten nie jest wysyłany. Jeśli identyfikator ICCID ma końcową literę "F", zostanie ona usunięta. | iccids=8988247000100003319, 988247000100003555 |
| imei | Numer IMEI urządzenia. | imei=001201234567890 |
| lokalizacja | Dwuliterowy kod ISO bieżącej lokalizacji fizycznej użytkownika z poziomem szczegółowości na poziomie kraju. | location=us |
| transactionId | Identyfikator transakcji używany do debugowania sesji. Dostawcy powinni to zarejestrować i wysłać to w ładunku powiadomień. Maksymalny rozmiar to 64 znaki. | transactionId=waoigFfX00yGH3Vb.1 |
| rynek | Dwuliterowy kod ISO ustawień regionu na komputerze. | market=us |
Preferencja języka użytkownika jest wysyłana przy użyciu nagłówka Accept-Language opisanego w poniższej tabeli. Ponadto, jeśli podczas pobierania profilu wystąpiły jakiekolwiek błędy, są one przekazywane jako nagłówki w następnym żądaniu.
| Nazwa nagłówka | Opis | Przykład |
|---|---|---|
| Accept-Language | Bieżące ustawienia języka użytkownika. Jeśli to możliwe, portal MO powinien renderować zawartość w określonym języku. Aby uzyskać więcej informacji, zobacz RFC 7231, sekcja 5.3.5: Accept-Language. | Accept-Language: en-us |
| X-MP-LPAError-Codes | To pole zawiera kod błędu przechwycony w systemie LPA. Jeśli występuje wiele błędów, kody błędów są przekazywane na liście rozdzielanej przecinkami. Aby uzyskać listę możliwych kodów błędów, zapoznaj się z wyliczeniem ESimOperationStatus. |
X-MP-LPAError-Codes: Błąd serwera, Serwer niedostępny |
| X-MP-LPAError-TimeStamps | To pole zawiera znacznik czasu wystąpienia błędu. Format znacznika czasu to przesunięcie daty i godziny UTC. Jeśli występuje wiele błędów, znaczniki czasu są przekazywane jako lista rozdzielona przecinkami. | X-MP-LPAError-TimeStamps: 5/18/2018 11:17:23 PM,5/18/2018 11:27:33 PM |
| X-MP-LPAError-ICCIDs | To pole zawiera identyfikator ICCID profilu karty eSIM, który użytkownik próbował pobrać i zainstalować. Ten identyfikator ICCID został zwrócony do aplikacji Plany Mobilne po przekazaniu kontroli. Przekazywany jest tylko jeden identyfikator ICCID. | X-MP-LPAError-ICCIDs: 8988247000101997790 |
Interfejs portalu webowego dla fizycznych kart SIM
Interfejs wywoływania portalu operatora sieci komórkowej przy użyciu starszego fizycznego UICC jest taki sam jak w przypadku eSIM. Jednak parametry przekazywane do portalu są inne.
MyWebView.Navigate(“https://moportal.com?iccid=8988247000100003319&imei=001102000311608&market=us&transactionId=waoigFfX00yGH3Vb.1&location=us”);
W poniższej tabeli opisano parametry uruchamiania dostępne dla fizycznej karty SIM.
| Nazwa parametru | Opis | Przykład |
|---|---|---|
| iccid | Wymagany parametr dla fizycznej karty SIM. Określa identyfikator ICCID na fizycznej sim. Jeśli identyfikator ICCID ma końcowe „F”, to zostaje ono usunięte. | iccid=8988247000100003319 |
| imei | Numer IMEI urządzenia. | imei=001201234567890 |
| lokalizacja | Dwuliterowy kod ISO bieżącej lokalizacji fizycznej użytkownika z poziomem szczegółowości na poziomie kraju. | location=us |
| transactionId | Identyfikator transakcji używany do debugowania sesji. Dostawcy powinni to zarejestrować i wysłać w treści powiadomienia. Maksymalny rozmiar to 64 znaki. | transactionId=waoigFfX00yGH3Vb.1 |
| rynek | Dwuliterowy kod ISO ustawień regionu na komputerze. | market=us |
Preferencja języka użytkownika jest wysyłana przy użyciu nagłówka Accept-Language opisanego w poniższej tabeli.
| Nazwa nagłówka | Opis | Przykład |
|---|---|---|
| Accept-Language | Bieżące ustawienia języka użytkownika. Jeśli to możliwe, portal MO powinien renderować zawartość w określonym języku. Aby uzyskać więcej informacji, zobacz RFC 7231, sekcja 5.3.5: Accept-Language. | Accept-Language: en-us |
Zasady projektowania portalu internetowego
Aby zapewnić najlepsze środowisko użytkownika w systemie Windows, operatorzy urządzeń przenośnych są zachęcani do przestrzegania zasad i wytycznych w tej sekcji podczas tworzenia portalu internetowego.
Funkcje biznesowe
| Polityka | Wymagane lub zalecane |
|---|---|
| Środowisko portalu internetowego musi spełniać wszystkie obowiązujące wymagania prawne i regulacyjne w oferowanych krajach. Każda zawartość wyświetlana w portalu internetowym musi być zgodna ze wszystkimi obowiązującymi przepisami. | Wymagane |
| Produkty oferowane za pośrednictwem środowiska portalu internetowego muszą być ofertą łączności sieciowej. | Wymagane |
| Produkty łączności sieciowej oferowane za pośrednictwem portalu internetowego muszą zawierać jasne opisy ofert i warunków. Określone warunki korzystania muszą być dostępne do wglądu dla użytkowników w ramach korzystania z portalu internetowego. | Wymagane |
| Informacje kontaktowe działu pomocy technicznej klienta muszą być dostępne dla użytkowników z poziomu środowiska portalu internetowego. | Wymagane |
| Zasady ochrony prywatności operatora sieci komórkowej muszą być dostępne dla użytkowników, aby mogli przeglądać je z poziomu środowiska portalu internetowego. | Wymagane |
| Środowisko zarządzania kontami udostępniane przez operatora sieci komórkowej musi umożliwić użytkownikom wykonywanie akcji dotyczących bieżących planów danych, takich jak anulowanie subskrypcji. | Wymagane |
| Użytkownicy muszą otrzymać potwierdzenie zamówienia po pomyślnym ukończeniu zakupu lub aktywacji planu w środowisku portalu internetowego. | Zalecane |
Bezpieczeństwo
| Polityka | Wymagane lub zalecane |
|---|---|
| Środowisko portalu internetowego nie może dostarczać ani instalować żadnych aplikacji lub modułów należących do podmiotów trzecich lub oznaczonych marką innej firmy. | Wymagane |
| Zanim użytkownicy wyjdą ze środowiska portalu internetowego operatora sieci Komórkowej, użytkownicy muszą być bezpiecznie wylogowani z portalu internetowego. | Wymagane |
| Identyfikator URI portalu i wszystkie żądania lub powiadomienia wysyłane do i z portalu internetowego muszą używać bezpiecznego protokołu HTTPS. | Wymagane |
| Wszystkie zasoby i odwołania do portalu internetowego muszą używać bezpiecznego protokołu HTTPS. | Wymagane |
Reklama
| Polityka | Wymagane lub zalecane |
|---|---|
| Portal internetowy nie może wyświetlać ani udostępniać do pobrania reklam, zawartości sponsorowanej, filmów wideo, plików dźwiękowych, animacji ani innych dużych plików multimedialnych ani obrazów. | Wymagane |
Możliwości
| Polityka | Wymagane lub zalecane |
|---|---|
| Wymagana minimalna funkcjonalność środowiska portalu internetowego polega na umożliwieniu użytkownikowi zakupu planu danych przy użyciu konta zarejestrowanego w operatorze sieci komórkowej. | Wymagane |
| Portal internetowy musi zostać uruchomiony szybko i zachować czas reakcji na dane wejściowe użytkownika, dopóki użytkownik nie opuści środowiska portalu internetowego. | Wymagane |
Po wywołaniu portal internetowy musi mieć uwagę użytkownika i zachować ją do czasu:
LUB
|
Wymagane |
| Portal internetowy nie może wyświetlać żadnych okien podręcznych, otwierać żadnych dodatkowych okien ani przekierowywać użytkownika do innych witryn internetowych lub aplikacji, z wyjątkiem sytuacji, gdy jest to wymagane do ukończenia przepływu aktywacji. | Wymagane |
| Portal internetowy musi obsługiwać wszystkie uzasadnione błędy i wyjątki, takie jak odrzucenie formy płatności, awaria zaplecza itp. Po obsłużeniu błędu lub wyjątku portal internetowy musi odpowiadać użytkownikom, aby zakończyć działanie i wrócić do aplikacji Plany mobilne. | Wymagane |
| Jeśli użytkownicy napotkają błąd, który można naprawić za pomocą akcji użytkownika, zaleca się wyświetlenie informacji o pomocy technicznej operatora sieci komórkowej z komunikatem o błędzie. | Zalecane |
Użyteczność
| Polityka | Wymagane lub zalecane |
|---|---|
| Domyślny rozmiar ramki dla portalu internetowego to 800x600. Operatorzy urządzeń przenośnych powinni przyjąć dynamiczny projekt internetowy, aby zawartość w portalu internetowym mogła zostać automatycznie dopasowana do ramki sterowania sieci Web, gdy użytkownicy będą zmieniać rozmiar aplikacji Plany mobilne dla większych i mniejszych ekranów. | Wymagane |
| Należy zoptymalizować czas ładowania i zużycie danych na potrzeby ładowania środowiska portalu internetowego. | Wymagane |
| Środowisko portalu internetowego powinno być proste i łatwe w nawigacji z niezbędnymi wytycznymi wyświetlanymi na ekranie. | Wymagane |
| Elementy interfejsu użytkownika w portalu internetowym powinny zapewniać spójną obsługę zintegrowaną z aplikacją Mobile Plans, nie myląc użytkowników ani przypominając użytkownikom, że jest to osadzona kontrolka sieci Web. Na przykład w portalu internetowym nie powinno być przycisku zamknij/maksimum/min. | Wymagane |
| Układ stron w portalu internetowym powinien być czysty i łatwy w nawigacji. Użytkownicy mogą przechodzić do tyłu i do przodu za pośrednictwem stron w portalu internetowym przy użyciu elementów interfejsu użytkownika w środowisku portalu. Aby uzyskać więcej informacji, zobacz przepływ pracy portalu internetowego i wzorzec projektu. | Wymagane |
| Portal internetowy musi działać w ramce kontrolki WebView i po wywołaniu nie może zakłócać interakcji użytkowników z aplikacją Mobile Plans w dowolnym momencie. | Wymagane |
| Portal internetowy nie może być zaśmiecony zbyt wieloma obrazami, transparentami, długim tekstem, linkami zewnętrznymi itp. | Wymagane |
| Przycisk anulowania na ekranie w środowisku internetowym powinien być dostępny dla użytkowników, aby w razie potrzeby zakończyć przepływ. | Zalecane |
| Operatorzy urządzeń przenośnych mogą wybrać schemat kolorów i czcionki, które najlepiej reprezentują swoją markę. Należy zadbać o to, aby wszystkie elementy wizualne działały dobrze i wzmacniały markę. | Zalecane |
Lokalizacja
| Polityka | Wymagane lub zalecane |
|---|---|
| Portal internetowy powinien mieć możliwość odbierania i zrozumienia ustawień regionalnych użytkowników przekazanych przez aplikację Mobile Plans w celu wyświetlania zawartości w preferowanym języku użytkownika. | Wymagane |
| Operatorzy urządzeń przenośnych mogą lokalizować swój portal internetowy w językach, które chcą obsługiwać. | Zalecane |
| Środowisko zapewniane przez portal internetowy powinno być stosunkowo podobne we wszystkich obsługiwanych językach, chociaż dostępność planu danych może się różnić w zależności od regionu. | Zalecane |
Dostępność
| Polityka | Wymagane lub zalecane |
|---|---|
| Portal internetowy powinien zapewniać ułatwienia dostępu użytkownikom niepełnosprawnym i przestrzegać wytycznych dotyczących ułatwień dostępu mających zastosowanie w jurysdykcjach, w których operator sieci komórkowej świadczy usługę. | Zalecane |