Niektóre aplikacje mogą wysyłać do dostawców usług EMM opinie w formie stanów aplikacji z kluczem. Stan aplikacji z kluczem składa się z unikalnego identyfikatora (klucza), odpowiadającego mu komunikatu (opcjonalnie), danych czytelnych dla komputera (opcjonalnie), stanu ważności i sygnatury czasowej. Aby je wysłać, aplikacja musi się zintegrować z biblioteką Enterprise Jetpack.
Dostawcy usług EMM mogą używać danych ze stanów aplikacji objętych kluczem, aby przekazywać administratorom IT aktualne informacje o aplikacjach zainstalowanych na zarządzanych urządzeniach i w profilach. Przykład, jak to działa, znajdziesz w artykule Wyświetlanie opinii dla firm.
Włącz raporty o urządzeniach
Aplikacje wysyłają ważne stany aplikacji w zależności od urządzenia. Zanim jakiekolwiek aplikacje na urządzeniu zostaną zaakceptowane z uwzględnieniem klucza, musisz włączyć raporty o urządzeniu. Dopóki zasada nie zostanie zaktualizowana na urządzeniu, wszystkie stany aplikacji powiązane z kluczem będą ignorowane i utracone na zawsze. Włącz raporty o urządzeniach przed ukończeniem rejestracji, jak najszybciej w trakcie procesu rejestracji. Dzięki temu otrzymasz opinie o aplikacji wygenerowane podczas rejestracji urządzenia i żadne stany aplikacji nie zostaną utracone.
- Zadzwoń pod numer
devices.update()
. Ustawiampolicy.deviceReportPolicy
na"deviceReportEnabled"
.
Pobieranie raportów o urządzeniach
Raport o urządzeniach możesz pobrać na kilka sposobów:
- Aby pobrać raporty o urządzeniach wraz z innymi powiadomieniami, zadzwoń pod numer
enterprises.pullNotificationSet()
. Każdy elementdeviceReportUpdateEvent
w odpowiedzi oznacza raport o urządzeniu. - Aby pobrać raport o urządzeniu zaktualizowanym o najnowsze stany aplikacji z zapisanym kluczem dla określonego urządzenia, wywołaj metodę
devices.get()
. - Aby wymusić na urządzeniu przesłanie najnowszych stanów aplikacji, wywołaj metodę
devices.forceReportUpload()
. Ta metoda przesyła raport zawierający wszelkie zmiany stanów aplikacji na urządzeniu od momentu wygenerowania ostatniego raportu.
Wyświetl stany aplikacji z kluczem
Raporty o urządzeniach są częścią zasobów dotyczących urządzeń. Raporty zawierają obiekt appState
dla każdej aplikacji (pakietu) zainstalowanej na urządzeniu lub w jej profilu służbowym.
Stany aplikacji z kluczem (keyedAppState
) w przypadku danego pakietu są wymienione w obiekcie appState
, jak w tym przykładzie:
{
"result":{
"kind":"androidenterprise#device",
"report":{
"appState":[
{
"keyedAppState":[
{
"severity":"severityError",
"data":"user",
"message":"Username or password are incorrect",
"key":"account",
"stateTimestampMillis":"1556206406926"
}
],
"packageName":"com.google.android.feedbacktestapp"
}
],
"lastUpdatedTimestampMillis":"1556206407685"
},
"androidId":"32714368a0ad8ad5",
"managementType":"managedProfile",
"policy":{
"deviceReportPolicy":"deviceReportEnabled"
}
}
}
Każdy stan aplikacji z kluczem obejmuje te elementy:
Pole | Opis |
---|---|
key |
Unikalny klucz identyfikujący stan. |
severity |
Poziom ważności stanu: INFO wskazuje komunikat informacyjny. np. jeśli udało się ustawić konfigurację zarządzaną. ERROR oznacza, że aby rozwiązać problem, firma musi podjąć działanie. na przykład jeśli nie udało się ustawić konfiguracji zarządzanej. |
message |
Opcjonalny ciąg znaków zawierający szczegółowe informacje o stanie aplikacji. Deweloperzy aplikacji powinni traktować to pole jako wiadomość widoczną dla użytkowników. |
data |
Opcjonalny ciąg tekstowy zawierający czytelne dla dostawców usług EMM informacje o stanie aplikacji. Na przykład wartość, do której administrator IT może wysyłać zapytanie w konsoli, na przykład „powiadom mnie, jeśli dane dotyczące baterii: < 10”. |
stateTimestampMillis |
Sygnatura czasowa (w milisekundach) wskazująca, kiedy stan aplikacji był ostatnio aktualizowany na urządzeniu. |
lastUpdatedTimestampMillis |
Sygnatura czasowa (w milisekundach) wskazująca, kiedy urządzenie ostatnio przesłało stany aplikacji z kluczem. |
Wyświetlanie opinii o aplikacjach firmom
Aplikacje mogą przesyłać opinie z różnych powodów. Najczęściej przydaje się to jednak do przesyłania opinii o konfiguracjach zarządzanych. Na przykład:
- Administrator IT używa konsoli EMM do ustawiania zarządzanych konfiguracji aplikacji.
- Backend możesz wysłać konfiguracje do aplikacji.
- Aplikacja próbuje zastosować konfiguracje. W przypadku każdej konfiguracji aplikacja wysyła stan aplikacji z kluczem wskazującym jej stan (np. wiadomość z potwierdzeniem lub powiadomienie o błędzie).
- Aby wyświetlić te stany aplikacji z kluczem, pobierz raport o urządzeniach.
- Korzystając z informacji ze stanów aplikacji objętych kluczem, konsola EMM wyświetla stan konfiguracji zarządzanych w przyjazny dla użytkownika sposób.
Informuj administratorów IT o błędach
Stan aplikacji z kluczem o poziomie ważności ERROR
wskazuje, że organizacja musi podjąć działanie, aby rozwiązać problem. Dostawcy usług EMM powinni zawsze powiadamiać organizacje o błędach za pomocą konsoli EMM lub w inny sposób. Na przykład konsola EMM może wyświetlić panel błędów z linkiem do opinii na temat danego urządzenia.
Jeśli stan błędu zostanie poprawiony, aplikacja wyśle stan realizacji z tym samym kluczem co pierwotny stan błędu i zaktualizowanym stanem błędu INFO
. Dostawcy usług EMM powinni zawsze informować organizacje po naprawieniu błędu. Możesz na przykład usunąć błąd z panelu błędów konsoli lub oznaczyć go jako rozwiązany.