Récupérer les commentaires des applications

Certaines applications peuvent envoyer des commentaires aux EMM sous la forme d'états d'application appariés. Un état d'application à clé est composé d'un identifiant unique (clé), du message correspondant (facultatif), de données lisibles par un ordinateur (facultatif), de l'état de gravité et de l'horodatage. Pour les envoyer, une application doit s'intégrer à la bibliothèque Enterprise Jetpack.

Une application ne peut envoyer les premiers commentaires immédiats qu'une fois par minute. Les commentaires générés pendant la période d'attente seront mis en file d'attente et envoyés dans son intégralité à la fin de celle-ci. Par exemple, lorsque le feedback est généré 3 fois à [t=0s;10s;15s] avec une période d'attente d'une minute: le premier feedback immédiat est envoyé à [t=0s], le deuxième et le troisième feedback à [t=60s].

En tant qu'EMM, vous pouvez utiliser les données des états d'application associés pour tenir les administrateurs informatiques informés des applications installées sur les appareils et les profils gérés. Pour en savoir plus, consultez la section Envoyer des commentaires aux entreprises.

Activer les rapports sur les appareils

Les applications envoient des états d'application appariés par appareil. Les états sont inclus dans les rapports sur les appareils. Pour activer la création de rapports sur un appareil:

  1. Suivez les instructions pour configurer les notifications Pub/Sub pour une entreprise. À l'étape 5, incluez STATUS_REPORT dans enabledNotificationTypes.
  2. Pour chaque appareil, mettez à jour la règle relative aux appareils: définissez StatusReportingSettings.applicationReportsEnabled sur true.

Vous pouvez désormais utiliser l'API Pub/Sub pour recevoir des notifications de rapports sur les appareils. Vous pouvez également consulter à tout moment le dernier rapport concernant un appareil en appelant devices.get().

Afficher les états de l'application appariée dans les rapports sur les appareils

Les rapports sur les appareils sont disponibles sous la forme de ressources relatives aux appareils. Les états d'application appariés sont regroupés par nom de package dans la section rapport sur les applications, comme illustré dans l'exemple ci-dessous:

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

Chaque état d'application associé à une clé contient les éléments suivants:

Champ Description
key Clé unique identifiant l'état.
severity Gravité de l'état: INFO indique un message informatif. (par exemple, si une configuration gérée est correctement définie). ERROR indique que l'entreprise doit prendre des mesures pour corriger un problème. (par exemple, si une configuration gérée n'a pas pu être définie).
message Chaîne facultative fournissant des détails sur l'état de l'application. Nous recommandons aux développeurs d'applications de traiter ce champ comme un message destiné aux utilisateurs.
data Chaîne facultative fournissant aux EMM des informations lisibles par ordinateur sur l'état de l'application. Par exemple, il peut s'agir d'une valeur qu'un administrateur informatique peut interroger dans votre console, telle que "M'avertir si les données Battery_warning – < 10".
createTime Code temporel indiquant le moment où l'état de l'application a été créé sur l'appareil.
lastUpdateTime Horodatage indiquant la dernière mise à jour de l'état de l'application sur l'appareil.

Présenter aux entreprises des commentaires sur l'application

Les applications peuvent envoyer des commentaires pour diverses raisons. Toutefois, le cas d'utilisation le plus courant pour envoyer des états d'application à clé consiste à fournir des commentaires sur les configurations gérées. Exemple :

  1. Un administrateur informatique utilise votre console EMM pour définir les configurations gérées d'une application.
  2. Dans le backend, vous utilisez ApplicationPolicy pour envoyer les configurations à l'application.
  3. L'application tente d'appliquer les configurations. Pour chaque configuration, l'application envoie un état associé à l'application indiquant son état (par exemple, un message de confirmation ou une notification d'erreur).
  4. Pour afficher ces états d'application appariés, vous devez récupérer un rapport sur les appareils.
  5. À l'aide des informations provenant des états de l'application à clé, votre console EMM affiche l'état des configurations gérées de manière conviviale.

Alerter les administrateurs informatiques en cas d'erreurs

Un état d'application associé à une gravité ERROR indique que l'organisation doit prendre des mesures pour corriger un problème. Les EMM doivent toujours alerter les organisations en cas d'erreur, via leur console EMM ou par d'autres moyens. Par exemple, votre console EMM peut afficher un tableau de bord des erreurs qui renvoie aux commentaires d'un appareil donné comportant des erreurs.

Si un état d'erreur est corrigé, l'application envoie un état de suivi avec la même clé que l'état d'erreur d'origine et une nouvelle gravité (INFO). Les EMM doivent toujours informer les organisations dès qu'une erreur est corrigée. Par exemple, supprimez l'erreur du tableau de bord des erreurs de votre console ou marquez-la comme résolue.