DocumentationAEMGuide d’AEM Screens

Questions fréquentes sur AEM Screens aem-screens-faqs

Last update: Tue Apr 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Intermediate
  • Developer

Cette rubrique fournit des réponses aux questions fréquentes relatives à un projet AEM Screens.

Problème d’écran vide blank-screen

NOTE
Liste des contrôles obligatoires qui doivent être testés par l’assistance principale ou l’assistance côté client avant de soulever un problème.

1. Quelles doivent être les étapes de dépannage initiales pour un client rencontrant un problème d’écran noir ou de contenu impossible à lire ? troubleshooting-blank-screen

  • Vérifiez si l’aperçu de canal fonctionne.
  • Vérifiez si l’aperçu d’affichage fonctionne.
  • Essayez d’enregistrer le lecteur en tant qu’extension de navigateur sur votre système pour le même affichage et vérifiez si cela fonctionne.
  • Lorsque le lecteur est en cours d’exécution sur votre système, accédez à http://localhost:24502. Vérifiez si tout le contenu est correctement téléchargé.
  • Vérifiez les ressources afin de vous assurer que les rendus appropriés sont créés et que le rendu correct est en cours de lecture.
  • Recherchez les contenus planifiés et vérifiez si les heures sont correctes. Vérifiez si l’heure configurée dans le lecteur est correcte.
  • Examinez les journaux de la console du lecteur et vérifiez l’existence d’erreurs éventuelles. Cliquez avec le bouton droit de la souris et examinez les journaux de la console. Si vous utilisez le lecteur Windows, appuyez sur CTRL + ALT +I pour afficher la console de développement afin d’afficher les journaux.

2. Comment résoudre le problème des écrans gris dans AEM Screens en créant un canal ou un planning par défaut ?

Pour éviter les écrans vierges ou gris dans le champ, créez un canal ou une planification globale par défaut, affecté à chaque affichage avec la priorité 1 la plus faible. En cas de problème avec les mises à jour de contenu (en raison du réseau, du lecteur, du serveur ou de la réplication), puisque les lecteurs ont déjà mis en cache ce contenu sur le disque qui doit être lu correctement et éviter les écrans gris.

Tout autre contenu, tel que les canaux ou les plannings, a une priorité supérieure à 1. Par conséquent, l’autre contenu a la priorité et le canal global ou le contenu de planification (avec la priorité 1) est lu uniquement comme une option de réduction.

Gestion de canaux channel-management

1. Quelle est la différence entre un canal en ligne et un canal hors ligne ? what-is-the-difference-between-an-online-and-an-offline-channel

Un Canal en ligne affiche le contenu mis à jour dans l’environnement en temps réel, tandis qu’un Canal hors ligne affiche le contenu mis en cache.

2. Comment mettre un canal en ligne ? how-do-i-make-a-channel-online

Cliquez sur le canal et accédez aux propriétés du canal à partir de la barre d’actions. Cochez Mode Développeur (forcer la mise en ligne du canal) sous l’onglet Canal pour mettre le canal en ligne.

3. À quoi le champ Rôle du canal sert-il ? what-is-the-use-of-the-channel-role-field

Le rôle du canal est l’abstraction du canal réel exécuté afin que l’auteur puisse se concentrer directement sur l’expérience générique. Vous pouvez le considérer comme un type de balise qui identifie de manière unique le canal dans son contexte (affichage ou planning).

4. Comment la résolution réelle du canal se produit-elle ? how-does-actual-channel-resolution-happen

Références statiques  : la résolution suit simplement le chemin indiqué.

Références dynamiques  : la résolution se produit une fois le canal affecté à l’affichage (et non au planning). Le chemin de l’affichage devient le contexte du canal et la résolution se produit comme suit (de la priorité la plus élevée à la plus faible) :

  1. L’affichage comporte un nœud enfant qui correspond au nom du canal référencé.
  2. L’affichage comporte un nœud frère qui correspond au nom du canal référencé.
  3. L’emplacement parent de l’affichage comporte un nœud enfant qui correspond au nom du canal référencé.
  4. L’emplacement parent principal de l’affichage comporte un nœud enfant qui correspond au nom du canal référencé.

Etc., jusqu’à ce que vous accédiez au dossier des emplacements et que vous vous arrêtiez là pour le moment (vous ne pouvez donc pas référencer un canal qui se trouverait dans le dossier des canaux, par exemple, uniquement les canaux de la sous-arborescence des emplacements).

5. Comment configurer la configuration hors ligne de la bibliothèque cliente personnalisée dans le canal AEM Screens ?

Lors de l’utilisation d’un code client personnalisé créé clientlib dans un canal AEM Screens, les étapes suivantes sont nécessaires pour s’assurer que la variable clientlib Les fichiers sont chargés correctement dans le canal (manifest.json) et contient le chemin d’accès de la variable clientlib.

Suivez les étapes ci-dessous à partir de l’éditeur de canal :

  1. Cliquez sur un canal, puis sur Modifier dans la barre d’actions.
  2. Cliquez sur le composant dans lequel vous souhaitez ajouter le clientlib.
  3. Cliquez sur le bouton de configuration (icône de clé à molette).
  4. Accédez à l’onglet Configuration hors ligne et ajoutez le chemin d’accès à votre bibliothèque cliente personnalisée dans Bibliothèques côté client.

Enregistrement d’appareils device-registration

1. Si je découvre des points de terminaison tels que des demandes d’intégration et d’enregistrement d’appareils, je peux créer un script pour de nombreux appareils et les enregistrer. Outre le verrouillage sur la connexion Wi-Fi d’une succursale, la sécurisation de ces requêtes est-elle possible ? if-i-discover-endpoints-such-as-requests-for-device-onboarding-and-registration-i-can-script-a-large-number-of-devices-and-register-these-devices-besides-locking-this-to-a-branch-wi-fi-is-it-possible-to-secure-these-requests

L’enregistrement n’est actuellement possible que sur l’instance d’auteur. Bien que le service d’enregistrement ne soit pas authentifié, il crée uniquement un périphérique en attente dans AEM et n’enregistre pas réellement le périphérique ni n’affecte aucun affichage.

Pour enregistrer un périphérique (création d’un utilisateur pour le périphérique dans AEM), authentifiez-vous sur AEM et suivez actuellement manuellement l’assistant d’enregistrement pour terminer l’enregistrement. En théorie, un utilisateur malveillant peut créer plusieurs appareils en attente, mais il ne peut pas les enregistrer sans connexion à AEM.

2. Existe-t-il un moyen de transformer les requêtes HTTP GET en requêtes HTTP POST avec un type d’authentification donné ? is-there-a-way-to-transform-http-get-requests-into-http-post-with-some-form-of-authentication

La requête d’enregistrement consiste dans une requête POST.

Il est recommandé d’obtenir l’ID de l’appareil de la session au lieu de le transmettre en tant que paramètre. Ainsi, vous pouvez nettoyer les journaux du serveur, la mémoire cache du navigateur, etc. Ce n'est pas un problème de sécurité. sémantique. GET est utilisé lorsqu’il n’y a aucune modification d’état sur le serveur et POST est utilisé en cas de modification d’état.

3. Existe-t-il un moyen de refuser une requête d’enregistrement d’appareil ? is-there-a-way-to-decline-a-device-registration-request

Vous ne pouvez pas refuser les requêtes d’enregistrement. Au lieu de cela, les demandes d’enregistrement doivent expirer au-delà d’un délai configuré dans Adobe Experience Manager Web Console. Par défaut, cette valeur est définie sur un jour et mise en mémoire cache.

Rapports de surveillance et d’intégrité des appareils device-monitoring-and-health-reports

1. Comment résoudre le problème si mon lecteur AEM Screens affiche un écran noir ?

Recherchez les possibilités suivantes pour résoudre le problème d’écran vide :

  • AEM ne peut pas diffuser le contenu hors ligne.
  • Le canal ne comporte aucun contenu.
  • Les ressources ne sont pas programmées pour apparaître à la date du jour.

2. Que faire si je ne peux pas enregistrer le lecteur AEM Screens et qu’il présente le statut d’échec ?

Activez l’option Allow Empty d’Apache Sling Referrer Filter. Cette activation est nécessaire pour optimiser le fonctionnement du protocole de contrôle entre le lecteur et le serveur AEM Screens.

  1. Accédez à Configuration de la console web Adobe Experience Manager.
  2. Cochez l’option allow.empty.
  3. Cliquez sur Enregistrer.

3. Comment résoudre le problème si l’appareil et les journaux de la console affichent respectivement les messages d’erreur « ÉCHEC » et « ENAME_NOT_FOUND » pendant l’enregistrement du lecteur AEM Screens ?

Ce problème peut se produire si le lecteur ne parvient pas à trouver le nom DNS du serveur AEM Screens. Vous pouvez essayer d’utiliser l’adresse IP pour vous connecter. Pour obtenir l’adresse IP du serveur, utilisez la syntaxe suivante : arp <nom_dns_serveur>.

4. AMS recommande-t-il de mettre en oeuvre un outil de surveillance Android™ sur tous les périphériques ? Le module de surveillance (Cordova) est-il fourni dans le kit de package Android (APK) ? does-ams-recommend-implementing-an-android-watchdog-on-all-devices-is-the-watchdog-cordova-plugin-included-as-part-of-the-apk

Un watchdog Android™ multiplateforme utilisant des API Android™ pures fait déjà partie du kit. Aucun logiciel supplémentaire n’est nécessaire. Cependant, en fonction de l’appareil que vous utilisez, vous pouvez signer à nouveau le fichier apk afin d’obtenir des privilèges système pour un cycle d’alimentation complet (Powermanager api), le cas échéant. S'il n'est pas démissionné à l'aide des clés du fabricant, il quitte et redémarre l'application, mais ne met pas le cycle d'alimentation en marche.

Pour plus d’informations sur la mise en oeuvre d’Android™ Player, voir Mise en oeuvre d’Android™ Player.

5. Quels outils (logiciels) tiers de surveillance et d’alerte à distance Adobe/AMS recommande-t-il d’utiliser pour surveiller chaque appareil ? what-third-party-remote-monitoring-and-alerting-tools-software-does-adobe-ams-recommend-for-monitoring-each-device

Selon les résultats que vous souhaitez obtenir en dehors de la surveillance et des alertes, un nouveau service de notifications AEM Screens vous informe si un appareil n’a pas envoyé de commande ping depuis longtemps. Les outils tiers dépendent de votre système d’exploitation, de ses fonctionnalités et des besoins spécifiques du client.

Pour plus d’informations sur l’emplacement où vous pouvez surveiller l’activité des périphériques, voir Service de notifications AEM Screens ns.

Lecteur AEM Screens

1. Comment installer le lecteur Chrome OS en tant que module du navigateur Chrome ? how-to-install-chromeos-player-as-chrome-browser-plugin

Le lecteur Chrome OS peut être installé en tant que module du navigateur Chrome en mode Développeur sans que vous ayez à utiliser de lecteur Chrome réel. Pour l’installer, procédez comme suit :

  1. Cliquez ici pour télécharger la dernière version du lecteur Chrome.
  2. Décompressez et enregistrez le fichier d’installation sur le disque.
  3. Ouvrez le navigateur Chrome et cliquez sur Extensions ou accédez directement à chrome://extensions.
  4. Activez l’option Mode Développeur dans le coin supérieur droit.
  5. Cliquez sur Chargement décompressé dans le coin supérieur gauche et chargez le lecteur Chrome décompressé.
  6. Si elle est disponible dans la liste des extensions, cochez Lecteur AEM Screens Chrome module externe
  7. Ouvrez un nouvel onglet et cliquez sur le bouton Applications dans le coin supérieur gauche ou accédez directement à chrome://apps.
  8. Cliquez sur le bouton AEM Screens module externe. Par défaut, le lecteur est lancé en mode plein écran. Presse Échap pour quitter le mode plein écran.

2. Comment résoudre le problème si le lecteur Screens ne parvient pas à s’authentifier par le biais d’une instance de publication avec un gestionnaire d’erreurs personnalisé ?

Le lecteur AEM Screens envoie une requête à /content/screens/svc.ping.json au démarrage et lorsqu’il affiche un message d’erreur 404. Le lecteur lance une demande d’authentification auprès de l’instance de publication. S’il existe un gestionnaire d’erreurs personnalisé dans l’instance de publication, veillez à renvoyer le code d’état 404 pour l’utilisateur anonyme sur /content/screens/svc.ping.json.

3. Comment configurer l’écran de l’appareil pour qu’il reste actif dans un lecteur Android™ ? how-to-set-the-device-screen-stay-on-in-an-android-player

Pour activer l’option Rester éveillé sur un lecteur Android™, procédez comme suit :

  1. Accédez aux paramètres du lecteur Android™ > A propos.
  2. Appuyez sept fois sur le numéro de build pour activer Options de développement in Paramètres.
  3. Accédez à Options de développement.
  4. Activer Restez éveillé.

4. Comment activer le mode fenêtre dans le lecteur Windows ? enable-player

Il n’existe pas de mode fenêtre dans le lecteur Windows. Celui-ci est toujours en mode Plein écran.

5. Comment résoudre le problème d’un lecteur AEM Screens qui envoie en continu des demandes de connexion ?

Procédez comme suit pour résoudre les problèmes d’un lecteur AEM Screens qui envoie continuellement des requêtes à /content/screens/svc.json et /libs/granite/core/content/login.validate/j_security_check :

  1. Lorsque le lecteur AEM Screens démarre, il le demande à /content/screens/svc.json. Lorsque le lecteur reçoit un code d’état 404 dans la réponse, il lance une demande d’authentification à l’aide de la fonction /libs/granite/core/content/login.validate/j_security_check par rapport à publier instance. Si l’instance de publication comporte un gestionnaire d’erreur personnalisé, veillez à retourner le code d’état 404 pour l’utilisateur anonyme sur /content/screens/svc.json ou /content/screens/svc.ping.json.

  2. Vérifiez si votre configuration de Dispatcher autorise ces requêtes dans la variable /filters.

    Pour plus d’informations, voir la section Configuration des filtres Screens.

  3. Vérifiez si les règles de réécriture de Dispatcher réécrivent les chemins d’accès à l’écran vers un autre chemin.

  4. Vérifiez si vous avez des règles /etc/map sur l’instance d’auteur ou de publication et si les chemins Screens correspondent à sling:match et sont redirigés en interne vers un autre chemin. La résolution de l’URL exacte dans /system/console/jcrresolver permet d’identifier si l’instance de publication réécrit ces URL vers un autre chemin d’accès.

  5. Vérifiez si la configuration Apache Sling Resource Resolver Factory provoque des réécritures internes.

6. Comment obtenir les informations concernant l’affichage et l’appareil à partir de l’API du lecteur ?

Vous pouvez obtenir les informations sur l’affichage et l’appareil via :

  • une API JS interne  ;

  • une boutique ContextHub  : Trois magasins ContextHub sont définis dans /libs/screens/clientlibs/contexthub pour exposer les canaux, les appareils et les informations d’affichage.

    Suivez les étapes ci-dessous pour utiliser ces valeurs de stockage ContentHub :

    • Modifiez les propriétés du canal et définissez le chemin ContextHub dans l’onglet de personnalisation sur la valeur (comme mentionné ci-dessus)

    • Dans le canal JS, vous pouvez utiliser :

      code language-shell 
         ContextHub.getStore('screens-device');
   ContextHub.getStore('screens-display');
   ContextHub.getStore('screens-channels');

Conseils pratiques de dépannage general-troubleshooting-tips

1. Comment désactiver Livefyre pour éviter de recevoir un message d’erreur d’instance d’auteur et/ou de publication dans Screens ?

Désactivez Livefyre pour éviter les erreurs de journal en procédant comme suit.

  1. Désactivez le lot Livefyre :

    • Accédez à https://<host>:<port>/system/console/bundles.
    • Recherchez le lot AEM Livefyre : com.adobe.cq.social.cq-social-livefyre.
    • Cliquez sur Arrêter.

  2. Désactivez l’interrogateur Livefyre :

    • Dans CRXDE Lite, accédez à /etc/importers/polling/livefyre-poller/jcr:content.
    • Ajout d’une propriété enabled type Booléen.
    • Définir propriété activée to false.

2. Comment ajouter des informations d’index Oak ? add-oak-index-info

AEM Screens crée des définitions d’index pour les requêtes utilisées par le produit.
Si des AVERTISSEMENTS de requête de traversée apparaissent dans error.log, créez un index personnalisé pour votre requête. Voir Configuration des index pour plus d’informations.

Vous pouvez également voir une ressource supplémentaire sur Documentation Oak.

3. Que faut-il faire pour configurer des manifestes v3 ? configure-v3

Pour activer le manifeste v3, procédez comme suit :

  • Mettre à jour Dispatcher.
    Pour plus d’informations, consultez Configuration de Dispatcher pour les manifestes v3.

  • Mettre à jour le composant personnalisé.
    Voir Modèle pour les gestionnaires personnalisés pour plus d’informations.

  • Désactiver ContentSync dans /system/console/configMgr/configMgr/com.adobe.cq.screens.offlinecontent.impl.ContentSyncCacheFeatureFlag.

  • Activer SmartSync dans /system/console/configMgr/com.adobe.cq.screens.offlinecontent.impl.OfflineContentServiceImpl.

  • Modifier channel/experience fragment/page components.

  • Accéder à l’onglet Configuration hors ligne.

  • Entrée clientlibs et les dossiers pour les fichiers statiques qui doivent être ajoutés au manifeste.

4. Que devez-vous faire si, après avoir installé le package screens-cloud-ams-pkg-0.0.20, screens-cloud-ams-pkg-0.0.16 et les lots de base de Screens ne sont pas actifs ?

Installez une version minimale d’AEM 6.5 Feature Pack 8 pour que le connecteur AMS fonctionne. Voir Disponibilité pour obtenir la version minimale d’AEM Screens Feature Pack.

5. Comment configurer le service d’externaliseur de liens CQ dans Screens ?

Le service est utilisé pour définir le nom d’hôte public pour les instances d’auteur et de publication, et les valeurs sont ensuite utilisées pour mettre à jour les URL du serveur d’appareils ainsi que pour le ciblage ContextHub.

Le service CQ Link Externalizer dans Screens peut être configuré par ce biais :

  1. Accédez à http://localhost:4502/system/console/configMgr.
  2. Day CQ Link Externalizer
  3. Modifiez le nom d’hôte pour les entrées author/publish si nécessaire.
recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053