Mengambil masukan dari aplikasi

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

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

Sebagai EMM, Anda dapat menggunakan data dari status aplikasi yang dikunci agar admin IT selalu mendapatkan info terbaru tentang 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 dikunci per perangkat. Status disertakan dalam laporan perangkat. Untuk mengaktifkan pelaporan perangkat:

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

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

Lihat status aplikasi yang dikunci dalam laporan perangkat

Laporan perangkat tersedia dalam bentuk resource perangkat. Status aplikasi dengan kunci dikelompokkan berdasarkan 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 dengan kunci berisi hal-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 dibuat kueri oleh admin IT di konsol Anda, seperti "beri tahu saya jika data baterai_peringatan < 10".
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 aplikasi ke perusahaan

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

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

Memberi tahu admin IT jika terjadi error

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

Jika status error diperbaiki, aplikasi akan mengirim status tindak lanjut dengan kunci yang sama seperti 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 Anda atau tandai sebagai selesai.