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

La section suivante permet de répondre à une partie des questions fréquemment posées concernant 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 lu.
  • 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. Effectuez un clic droit et inspectez pour afficher 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 vides ou gris du champ, créez un canal ou un planning global par défaut, affecté à chaque affichage avec la priorité la moins élevée (1). Au cas où un problème se produirait 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à ce contenu mis en cache sur le disque qui devrait fonctionner correctement et éviter les écrans gris.

Tous les autres contenus, tels que les canaux ou les plannings, ont une priorité supérieure à 1, de sorte que l’autre contenu est prioritaire et que le contenu de canal ou de planning global (avec la priorité 1) n’est lu qu’en dernier recours.

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

Une Canal en ligne affiche le contenu mis à jour dans l’environnement en temps réel alors qu’une Canal hors ligne affiche le contenu mis en cache.

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

Sélectionnez le canal, puis accédez aux propriétés correspondantes depuis 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 qui est 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é.

Et ainsi de suite, jusqu’à ce que vous atteigniez le dossier des emplacements et que vous vous arrêtiez là pour le moment (de sorte que vous ne puissiez 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é clientlib dans un canal AEM Screens, les étapes suivantes sont nécessaires pour s’assurer que le clientlib les fichiers sont chargés correctement dans le canal (manifest.json) et contient le chemin du . clientlib.

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

  1. Sélectionnez un canal, puis sélectionnez Modifier à partir de la barre d’actions.
  2. Sélectionnez le composant où vous souhaitez ajouter la clientlib personnalisée.
  3. Sélectionnez le bouton de configuration (icône 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étecte des points d’entrée tels que des demandes d’intégration et d’enregistrement d’appareils, je peux créer des scripts 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 ne crée qu’un appareil en attente dans AEM et n’enregistre pas réellement l’appareil ni n’attribue d’affichage.

Pour enregistrer un appareil (création d’un utilisateur pour l’appareil dans AEM), authentifiez-vous auprès d’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 une question de sécurité. Sémantiquement. Le GET est utilisé lorsqu’il n’y a aucun changement d’état sur le serveur et le POST est utilisé lorsqu’il y a un changement 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 Filtre de référent Apache Sling Autoriser vide. 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 œuvre un chien de garde Android™ sur tous les appareils ? 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 chien de garde Android™ multi-plateformes utilisant des API Android™ pures fait déjà partie de l'apk. Aucun logiciel supplémentaire n'est nécessaire. Cependant, en fonction du périphérique que vous utilisez, vous pouvez résigner l'apk pour obtenir les privilèges système pour une mise hors tension complète (Powermanager api), si nécessaire. S'il n'est pas résigné à l'aide des clés du fabricant, il quitte et redémarre l'application, mais ne redémarre pas.

Pour plus d’informations sur la mise en œuvre d’Android™ Player, voir Mise en œuvre 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 (SE), 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 appareils, voir Service de notifications AEM Screens.

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 sélectionnez Extensions dans le menu ou accédez directement à chrome://extensions.
  4. Activer le Mode Développeur depuis le coin supérieur droit.
  5. Sélectionner Charger décompressé dans le coin supérieur gauche et chargez le lecteur Chrome décompressé.
  6. Si disponible dans la liste des extensions, cochez Lecteur AEM Screens Chrome Plug-in.
  7. Ouvrez un nouvel onglet et cliquez sur Applications dans le coin supérieur gauche ou accédez directement à chrome://apps.
  8. Sélectionner le AEM Screens Plug-in. 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 via l’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 pour l’authentification sur 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 activé dans un lecteur Android™ ? how-to-set-the-device-screen-stay-on-in-an-android-player

Suivez les étapes ci-dessous pour activer Rester éveillé dans sur n’importe quel lecteur Android™ :

  1. Accédez à Paramètres du lecteur Android™ > À propos de.
  2. Appuyez sept fois sur le numéro de version pour activer Options du développeur dans Paramètres.
  3. Accéder à Options du développeur.
  4. Activer Reste É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 obtient un code d’état 404 dans la réponse, il lance une requête d’authentification à l’aide de . /libs/granite/core/content/login.validate/j_security_check contre le publication 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 la configuration de Dispatcher autorise ces requêtes dans le /filters.

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

  3. Vérifiez si vos règles de réécriture du Dispatcher réécrivent l’un des chemins d’écran vers un chemin différent.

  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 d’usine de résolveur de ressource Apache Sling 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 l’offre groupée AEM Livefyre : com.adobe.cq.social.cq-social-livefyre.
    • Sélectionner 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é activé type Booléen.
    • Définir propriété activée vers faux.

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. Pour en savoir plus, consultez Configuration des index.

Vous pouvez également consulter une ressource supplémentaire dans la documentation Oak.

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

Pour activer les manifestes v3, vous devez effectuer les actions suivantes :

  • 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.

  • Enter 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é vous pouvez ainsi obtenir la version minimale du pack de fonctionnalités AEM 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