Mengambil masukan dari aplikasi

Beberapa aplikasi dapat mengirim masukan ke EMM dalam bentuk aplikasi yang dilengkapi kunci negara bagian. Status aplikasi yang terkunci terdiri dari ID unik (kunci), pesan yang sesuai (opsional), data yang dapat dibaca mesin (opsional), tingkat keparahan status, dan stempel waktu. Untuk mengirimkannya, aplikasi perlu berintegrasi dengan Library Jetpack Enterprise.

Aplikasi hanya dapat mengirim masukan langsung pertama satu kali setiap menit. Masukan yang dihasilkan selama periode tunggu akan dimasukkan ke dalam antrean dan akan dikirimkan sepenuhnya saat periode tunggu berakhir. Misalnya, ketika umpan balik dihasilkan 3 kali pada [t=0 s; 10 s; 15 s] dengan periode tunggu 1 menit: umpan balik langsung pertama akan dikirim pada [t=0 s], umpan balik kedua dan ketiga pada [t=60 s].

Sebagai EMM, Anda dapat menggunakan data dari status aplikasi yang terkunci untuk menjaga admin IT selalu mendapatkan update terbaru terkait aplikasi yang diinstal di profil dan perangkat terkelola. Contoh tentang cara kerjanya dijelaskan dalam Menampilkan masukan kepada perusahaan.

Aktifkan laporan perangkat

Aplikasi mengirim status aplikasi dengan kunci per perangkat. Negara bagian termasuk dalam laporan perangkat. Untuk mengaktifkan pelaporan perangkat:

  1. Ikuti petunjuk untuk menyiapkan notifikasi Pub/Sub untuk suatu perusahaan. Pada Langkah 5, sertakan STATUS_REPORT di enabledNotificationTypes.
  2. Untuk setiap perangkat, perbarui kebijakan perangkat: setel StatusReportingSettings.applicationReportsEnabled ke true.

Anda sekarang dapat menggunakan Pub/Sub API untuk mendapatkan notifikasi laporan perangkat. Atau, untuk meninjau laporan terbaru perangkat kapan saja, panggil devices.get().

Melihat status aplikasi dengan kunci di laporan perangkat

Laporan perangkat tersedia dalam bentuk resource perangkat. Status aplikasi dengan kunci dikelompokkan menurut nama paket di bagian laporan aplikasi, seperti yang ditunjukkan dalam contoh di bawah:

{
   "applicationReports":[
      {
         "packageName": "pkg1",
         "versionCode": 101,
         "keyedAppStates":[
            {
               "key": "key1",
               "severity": INFO,
               "message": "message1",
               "data": "data1",
               "createTime": "2018-10-01T15:01:22.027623745Z",
               "lastUpdateTime": "2018-10-02T15:01:23.045123456Z"
            }
         ]
      }
   ]
}

Setiap status aplikasi yang dikunci berisi hal berikut:

Kolom Deskripsi
key Kunci unik yang mengidentifikasi status.
severity Tingkat keparahan status: INFO menunjukkan pesan yang informatif. Misalnya, jika konfigurasi terkelola berhasil disetel. ERROR menunjukkan bahwa perusahaan perlu mengambil tindakan untuk memperbaiki masalah. Misalnya, jika konfigurasi terkelola gagal ditetapkan.
message String opsional yang memberikan detail tentang status aplikasi. Developer aplikasi disarankan untuk memperlakukan kolom ini sebagai pesan yang ditampilkan kepada pengguna.
data String opsional yang memberikan detail yang dapat dibaca komputer ke EMM tentang status aplikasi. Misalnya, nilai yang dapat dikueri oleh admin IT di konsol Anda, seperti "beri tahu saya jika data baterai_peringatan < 10 inci.
createTime Stempel waktu yang menunjukkan kapan status aplikasi dibuat di perangkat.
lastUpdateTime Stempel waktu yang menunjukkan kapan status aplikasi terakhir diperbarui di perangkat.

Menampilkan masukan tentang aplikasi ke perusahaan

Aplikasi dapat mengirim masukan karena berbagai alasan. Namun, penggunaan yang paling umum kasus pengiriman status aplikasi dengan kunci adalah memberikan masukan tentang status aplikasi konfigurasi standar. Contoh:

  1. Admin IT menggunakan konsol EMM untuk menetapkan konfigurasi terkelola untuk aplikasi.
  2. Pada backend, Anda menggunakan ApplicationPolicy untuk mengirim konfigurasi ke aplikasi.
  3. Aplikasi akan mencoba menerapkan konfigurasi. Untuk setiap konfigurasi, aplikasi mengirimkan status aplikasi berkunci yang menunjukkan statusnya (misalnya, pesan atau notifikasi error).
  4. Untuk melihat status aplikasi dengan kunci ini, Anda mengambil laporan perangkat.
  5. Dengan menggunakan informasi dari status aplikasi yang terkunci, konsol EMM akan menampilkan konfigurasi terkelola yang mudah digunakan.

Memberi tahu admin IT tentang error

Status aplikasi terkunci dengan tingkat keparahan ERROR menunjukkan bahwa organisasi perlu melakukan tindakan untuk memperbaiki masalah. EMM harus selalu memberi tahu organisasi terhadap error, baik melalui konsol EMM atau cara lainnya. Misalnya, Konsol EMM dapat menampilkan dasbor error yang menautkan ke masukan untuk perangkat tertentu yang {i>error<i}.

Jika status error diperbaiki, aplikasi akan mengirimkan status tindak lanjut dengan kunci yang sama dengan status error asli dan tingkat keparahan INFO yang diperbarui. EMM harus selalu memberi tahu organisasi segera setelah error diperbaiki. Sebagai misalnya, hapus error dari dasbor error konsol Anda atau tandai sebagai diselesaikan.