從應用程式擷取意見回饋

部分應用程式能夠以按鍵應用程式狀態的形式,將意見回饋傳送給 EMM。金鑰的應用程式狀態由唯一識別碼 (鍵)、對應訊息 (選用)、機器可讀取的資料 (選用)、嚴重性狀態和時間戳記組成。如要傳送,應用程式必須整合 Enterprise Jetpack 程式庫

應用程式每分鐘只能傳送第一次即時意見回饋。在等待期結束時,產生的意見回饋會排入佇列,並在等待期結束時全數傳送。例如,如果意見回饋以 [t=0s;10s;15s] 產生 3 次,等待期為 1 分鐘:系統會傳送第一段即時意見回饋給 [t=0s],第二和第三次意見則為 [t=60s]。

在 EMM 中,您可以使用索引鍵應用程式狀態的資料,讓 IT 管理員透過受管理裝置和設定檔中安裝的應用程式隨時更新。如需運作方式範例,請參閱「向企業提供意見回饋」。

啟用裝置報告

應用程式會依個別裝置傳送可鍵的應用程式狀態。狀態資訊會顯示在裝置報表中。如要啟用裝置的回報功能,請按照下列步驟操作:

  1. 按照操作說明為企業設定 Pub/Sub 通知。在步驟 5 中,在 enabledNotificationTypes 中加入 STATUS_REPORT
  2. 針對每個裝置更新裝置政策:將 StatusReportingSettings.applicationReportsEnabled 設為 true

您現在可以使用 Pub/Sub API 取得裝置報告通知。此外,您隨時可以前往 devices.get() 查看裝置的最新報告。

在裝置報告中查看金鑰的應用程式狀態

裝置報表會以裝置資源的形式提供。在「應用程式報表」部分中,已鍵的應用程式狀態會按照套件名稱分組,如以下範例所示:

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

每個金鑰化應用程式狀態都包含以下內容:

欄位 說明
key 識別狀態的專屬金鑰。
severity 狀態的嚴重性:INFO 表示說明訊息。例如受管理的設定是否設定成功。ERROR 表示企業需要採取行動來修正問題。例如無法設置受管理的設定時。
message 選用字串,提供應用程式狀態的詳細資料。我們建議應用程式開發人員將這個欄位視為向使用者顯示的訊息。
data 選用字串,可為 EMM 提供電腦可讀取的應用程式狀態詳細資料。舉例來說,IT 管理員可在控制台中查詢某個值,例如「如果 Battery_warning 資料 < 10 要通知我」。
createTime 指出應用程式狀態在裝置上建立時間的時間戳記。
lastUpdateTime 指出裝置上次更新應用程式狀態的時間戳記。

向企業顯示應用程式意見回饋

應用程式可能會基於多種原因而提供意見。不過,傳送鍵/應用程式狀態的最常見用途,就是提供受管理設定的意見回饋。例如:

  1. IT 管理員會使用您的 EMM 控制台為應用程式進行受管理的設定
  2. 在後端,您會使用 ApplicationPolicy 將設定傳送至應用程式。
  3. 應用程式會嘗試套用設定。針對各項設定,應用程式會傳送含有金鑰的應用程式狀態,例如確認訊息或錯誤通知。
  4. 如要查看這些具有索引鍵的應用程式狀態,您必須擷取裝置報告。
  5. 您的 EMM 控制台會使用索引鍵應用程式狀態中的資訊,以使用者容易理解的方式顯示受管理設定的狀態。

提醒 IT 管理員發生錯誤

嚴重性達 ERROR 的應用程式狀態代表機構必須採取行動才能修正問題。EMM 應「一律」透過 EMM 控制台或其他方式提醒機構發生錯誤。舉例來說,EMM 控制台可能會顯示錯誤資訊主頁,連結至發生錯誤的特定裝置的意見回饋。

如果錯誤狀態修正,應用程式會傳送後續狀態,其金鑰與原始錯誤狀態相同,而更新的嚴重性為 INFO。EMM 應於錯誤修正後立即通知機構。例如,請從控制台的錯誤資訊主頁中移除錯誤,或將其標示為已解決。