Mengambil masukan dari aplikasi

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

Sebagai EMM, Anda dapat menggunakan data dari status aplikasi dengan kunci agar admin IT selalu mendapatkan info terbaru terkait aplikasi yang diinstal di perangkat dan profil terkelola. Contoh cara kerjanya dijelaskan dalam Menampilkan masukan kepada perusahaan.

Aktifkan laporan perangkat

Aplikasi mengirim status aplikasi yang terkunci per perangkat. Sebelum status aplikasi yang terkunci diterima dari salah satu aplikasi di perangkat, Anda harus mengaktifkan laporan perangkat untuk perangkat. Hingga kebijakan diperbarui di perangkat, status aplikasi yang terkunci akan diabaikan dan hilang selamanya. Aktifkan laporan perangkat sebelum menyelesaikan pendaftaran perangkat, sedini mungkin dalam proses pendaftaran. Hal ini memastikan bahwa Anda menerima masukan aplikasi yang dibuat selama pendaftaran perangkat dan tidak ada status aplikasi yang terkunci yang hilang.

  • Panggil devices.update(), menyetel policy.deviceReportPolicy ke "deviceReportEnabled".

Mengambil laporan perangkat

Ada beberapa cara untuk mengambil laporan perangkat:

  • Untuk mengambil laporan perangkat beserta notifikasi lainnya, panggil enterprises.pullNotificationSet(). Dalam respons, setiap deviceReportUpdateEvent menunjukkan laporan perangkat.
  • Untuk mengambil laporan perangkat yang diperbarui dengan status aplikasi dengan kunci terbaru untuk perangkat yang ditentukan, panggil devices.get().
  • Untuk memaksa perangkat mengupload status aplikasi terbaru, panggil devices.forceReportUpload(). Metode ini mengupload laporan yang berisi perubahan apa pun dalam status aplikasi di perangkat sejak laporan terakhir dibuat.

Melihat status aplikasi dengan kunci

Laporan perangkat adalah bagian dari resource perangkat. Laporan menyertakan objek appState untuk setiap aplikasi (paket) yang diinstal di perangkat atau di profil kerjanya. Status aplikasi dengan kunci (keyedAppState) untuk paket tertentu tercantum dalam objek appState, seperti dalam contoh di bawah:

{
   "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"
      }
   }
}

Setiap status aplikasi yang dikunci berisi hal berikut:

Kolom Deskripsi
key Kunci unik yang mengidentifikasi status.
severity Tingkat keparahan status: INFO menunjukkan pesan 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".
stateTimestampMillis Stempel waktu (dalam milidetik) yang menunjukkan kapan status aplikasi terakhir kali diupdate di perangkat.
lastUpdatedTimestampMillis Stempel waktu (dalam milidetik) yang menunjukkan kapan perangkat terakhir kali mengupload status aplikasi dengan kunci.

Menampilkan masukan aplikasi ke perusahaan

Aplikasi dapat mengirim masukan karena berbagai alasan. Namun, kasus penggunaan yang paling umum untuk mengirim status aplikasi yang terkunci adalah memberikan masukan tentang konfigurasi terkelola. Contoh:

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

Memberi tahu admin IT jika terjadi error

Status aplikasi yang dikunci dengan tingkat keparahan ERROR menunjukkan bahwa organisasi perlu mengambil tindakan untuk memperbaiki masalah. EMM harus selalu memberi tahu organisasi tentang error, baik melalui konsol EMM atau cara lainnya. Misalnya, konsol EMM Anda dapat menampilkan dasbor error yang menautkan ke masukan untuk perangkat tertentu yang memiliki error.

Jika status error diperbaiki, aplikasi akan mengirim 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. Misalnya, hapus error dari dasbor error konsol atau tandai sebagai terselesaikan.