DokumentationAEMAEM Screens-Anleitung

Häufig gestellte Fragen zu AEM Screens aem-screens-faqs

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Fortgeschrittener
  • Entwickler

Dieses Thema enthält Antworten auf häufig gestellte Fragen zu einem AEM Screens-Projekt.

Problem mit leerem Bildschirm blank-screen

NOTE
Die Liste der obligatorischen Überprüfungen, die der primäre Support oder der kundenseitige Support durchführen sollte, bevor ein Problem gemeldet wird.

1. Was sollten die Erste-Hilfe-Schritte zur Fehlerbehebung sein, wenn ein Kunde mit einem schwarzen Bildschirm oder nicht wiedergegebenen Inhalten konfrontiert wird? troubleshooting-blank-screen

  • Überprüfen Sie, ob die Kanalvorschau funktioniert.
  • Überprüfen Sie, ob die Anzeigenvorschau funktioniert.
  • Versuchen Sie, den Player als Browser-Erweiterung auf Ihrem System für dieselbe Anzeige zu registrieren und überprüfen Sie, ob dies funktioniert.
  • Wenn der Player auf Ihrem System läuft, navigieren Sie zu http://localhost:24502. Überprüfen Sie, ob der gesamte Inhalt korrekt heruntergeladen wurde.
  • Überprüfen Sie die Assets, um sicherzustellen, dass die entsprechenden Ausgabedarstellungen erstellt wurden und die richtige Ausgabedarstellung wiedergegeben wird.
  • Überprüfen Sie, ob es geplante Inhalte gibt und ob die Zeiten korrekt sind. Überprüfen Sie, ob die im Player eingestellte Zeit korrekt ist.
  • Überprüfen Sie die Protokolle der Player-Konsole und überprüfen Sie sie auf Fehler. Klicken Sie mit der rechten Maustaste und überprüfen Sie die Konsolenprotokolle. Wenn Sie den Windows-Player verwenden, drücken Sie CTRL + ALT +I, um die Entwicklungskonsole aufzurufen und die Protokolle anzuzeigen.

2. Wie lässt sich das Problem der grauen Bildschirme in AEM Screens beim Erstellen eines Standardkanals oder -zeitplans beheben?

Um die leeren oder grauen Bildschirme im Feld zu vermeiden, erstellen Sie einen globalen Standardkanal oder -zeitplan, der jeder Anzeige mit der geringsten Priorität 1 zugewiesen ist. Falls bei Inhaltsaktualisierungen etwas fehlschlägt, weil die Player diesen Inhalt bereits auf der Festplatte zwischengespeichert haben. Die Wiedergabe sollte einwandfrei funktionieren und die grauen Bildschirme sollten vermieden werden.

Alle anderen Inhalte, wie Kanäle oder Zeitpläne, haben eine Priorität größer als 1, sodass die anderen Inhalte Priorität haben und der globale Kanal- oder Zeitplaninhalt (mit Priorität 1) nur als Fallback-Option wiedergegeben wird.

Kanalverwaltung channel-management

1. Was ist der Unterschied zwischen einem Online- und einem Offline-Kanal? what-is-the-difference-between-an-online-and-an-offline-channel

Ein Online-Kanal zeigt den aktualisierten Inhalt in der Echtzeitumgebung, während ein Offline-Kanal den im Cache gespeicherten Inhalt zeigt.

2. Wie schalte ich einen Kanal online? how-do-i-make-a-channel-online

Wählen Sie den Kanal aus und navigieren Sie in der Aktionsleiste zu den Kanaleigenschaften. Aktivieren Sie Entwicklermodus (Kanal erzwingen, um online zu sein) auf der Registerkarte Kanal, um den Kanal online zu schalten.

3. Was ermöglicht das Feld „Kanalrolle“? what-is-the-use-of-the-channel-role-field

Die Kanalrolle ist eine Abstraktion des tatsächlichen Kanals, die ausgeführt wird, damit sich die Autorin bzw. der Autor direkt auf das generische Erlebnis konzentrieren kann. Sie können sich die Rolle als eine Art Tag vorstellen, das den Kanal in seinem Kontext (Anzeige oder Zeitplan) eindeutig identifiziert.

4. Wie erfolgt die tatsächliche Kanalauflösung? how-does-actual-channel-resolution-happen

Bei statischen Verweisen folgt die Auflösung einfach dem angegebenen Pfad.

Bei dynamischen Verweisen erfolgt die Auflösung, sobald der Kanal der Anzeige zugewiesen wird (nicht dem Zeitplan). Der Anzeigepfad wird zum Kontext des Kanals und die Auflösung wird wie folgt durchgeführt (höchste zu niedrigster Priorität):

  1. Die Anzeige hat einen untergeordneten Knoten, der mit dem Namen des referenzierten Kanals übereinstimmt
  2. Die Anzeige verfügt über einen gleichrangigen Knoten, der mit dem Namen des referenzierten Kanals übereinstimmt
  3. Der übergeordnete Standort der Anzeige hat einen untergeordneten Knoten, der mit dem Namen des referenzierten Kanals übereinstimmt
  4. Der über-übergeordnete Standort der Anzeige hat einen untergeordneten Knoten, der mit dem Namen des referenzierten Kanals übereinstimmt

Und so weiter, bis Sie den Standortordner erreichen. Halten Sie dort vorerst an (Sie können also nicht auf einen Kanal verweisen, der sich zum Beispiel im Kanalordner befindet, sondern nur auf Kanäle in der Unterstruktur der Standorte).

5. Wie wird die benutzerdefinierte clientlib-Offline-Konfiguration im AEM Screens-Kanal eingerichtet?

Bei Verwendung eines erstellten, benutzerdefinierten Client-seitigen Codes clientlib in einem AEM Screens-Kanal sind die folgenden Schritte erforderlich. Die Schritte stellen sicher, dass die clientlib-Dateien erfolgreich in den Kanal (manifest.json) geladen werden und den Pfad der clientlib enthalten.

Gehen Sie im Kanaleditor wie folgt vor:

  1. Klicken Sie auf einen Kanal und dann in der Aktionsleiste auf Bearbeiten.
  2. Klicken Sie auf die Komponente, zu der Sie die benutzerdefinierte clientlib hinzufügen möchten.
  3. Klicken Sie auf die Schaltfläche „Konfigurieren“ (das Schraubenschlüsselsymbol).
  4. Gehen Sie zur Registerkarte Offline-Konfiguration und fügen Sie den Pfad zu Ihrer benutzerdefinierten clientlib unter Client-seitige Bibliotheken hinzu.

Geräteregistrierung device-registration

1. Bei der Ermittlung von Endpunkten (z. B. Anfragen zum Onboarding und Registrieren von Geräten) kann ich Skripte für eine große Zahl von Geräten verfassen, um die Geräte zu registrieren. Ist es möglich, diese Anfragen zu schützen und fest mit dem WLAN einer Zweigstelle zu verknüpfen? 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

Derzeit ist eine Registrierung nur in der Autoreninstanz möglich. Obwohl der Registrierungsdienst nicht authentifiziert ist, erstellt er in AEM nur ein ausstehendes Gerät, das jedoch weder registriert noch einer Anzeige zugewiesen wird.

Um ein Gerät zu registrieren (indem Sie in AEM eine Benutzerin oder einen Benutzer für das Gerät erstellen), authentifizieren Sie sich bei AEM und folgen Sie dem Registrierungsassistenten, um die Registrierung abzuschließen. Theoretisch kann eine böswillige Person mehrere ausstehende Geräte erstellen, jedoch ohne Anmeldung in AEM keines von ihnen registrieren.

2. Ist es möglich, mit einer bestimmten Form von Authentifizierung HTTP GET-Anfragen in HTTP POST umzuwandeln? is-there-a-way-to-transform-http-get-requests-into-http-post-with-some-form-of-authentication

Die Registrierungsanfrage ist eine POST-Anfrage.

Es wird empfohlen, die Geräte-ID aus der Sitzung abzurufen, anstatt sie als Parameter zu übernehmen. Dadurch werden die Server-Protokolle, der Browsercache usw. bereinigt. Es handelt sich dabei nicht um ein Sicherheitsproblem. Semantisch. wird GET verwendet, wenn keine Statusänderung auf dem Server erfolgt; POST kommt zum Einsatz, wenn eine Statusänderung vorhanden ist.

3. Ist es möglich, eine Anfrage zur Geräteregistrierung abzulehnen? is-there-a-way-to-decline-a-device-registration-request

Sie können Registrierungsanfragen nicht ablehnen. Stattdessen sollten Registrierungsanfragen nach einer Zeitüberschreitung ablaufen, die in Adobe Experience Manager Web Console konfiguriert ist. Standardmäßig ist dieser Wert auf einen Tag festgelegt und wird in einem Arbeitsspeicher-Cache gespeichert.

Geräteüberwachung und Statusberichte device-monitoring-and-health-reports

1. Wie kann ich eine Fehlerbehebung vornehmen, wenn der AEM Screens-Player einen leeren Bildschirm anzeigt?

Prüfen Sie folgende Möglichkeiten, um Probleme mit einem leeren Bildschirm zu beheben:

  • AEM kann die Offline-Inhalte nicht im Push-Verfahren übertragen
  • Der Kanal weist keinen Inhalt auf
  • Keines der Assets ist zum jetzigen Zeitpunkt für die Anzeige vorgesehen

2. Was kann ich tun, wenn der AEM Screens-Player nicht registriert werden kann und den Status „Failure“ aufweist?

Aktivieren Sie im Dialogfeld für den Apache Sling Referrer-Filter die Option „Allow Empty“ (Leeres Feld zulassen). Dies ist erforderlich, um eine optimale Funktionsweise des Steuerungsprotokolls zwischen dem AEM Screens-Player und dem AEM Screens-Server zu ermöglichen.

  1. Navigieren Sie zur  Konfiguration der Adobe Experience Manager-Web-Konsole.
  2. Aktivieren Sie die Option allow.empty.
  3. Klicken Sie auf Speichern.

3. Wie lässt sich das Problem beheben, wenn beim Registrieren eines AEM Screens-Players auf dem Gerät „FAILURE“ und in den Protokollen der Konsole der Fehler „ENAME_NOT_FOUND“ angezeigt wird?

Das Problem kann auftreten, wenn der Player das DNS des AEM Screens-Servers nicht finden kann. Sie können versuchen, eine Verbindung über die IP-Adresse herzustellen. Um die IP des Servers abzurufen, verwenden Sie arp <server_dns_name>.

4. Empfiehlt AMS, Android™ Watchdog auf allen Geräten zu implementieren? Ist das Watchdog-Plug-in (Cordova) Teil des APK? does-ams-recommend-implementing-an-android-watchdog-on-all-devices-is-the-watchdog-cordova-plugin-included-as-part-of-the-apk

Ein plattformübergreifender Android™-Watchdog, der reine Android™-APIs nutzt, ist bereits Bestandteil des APK. Es ist keine zusätzliche Software erforderlich. Je nach dem von Ihnen verwendeten Gerät können Sie das APK jedoch zurücksetzen, um ggf. Systemberechtigungen für einen vollständigen Aus- und Einschaltvorgang des Geräts zu erhalten (Powermanager-API). Falls es nicht mit den Herstellerschlüsseln neu signiert wird, wird das APK beendet und die Anwendung neu gestartet, aber nicht das Gerät aus- und wieder eingeschaltet.

Weitere Informationen zur Implementierung des Android™-Players finden Sie unter Implementieren des Android™-Players.

5. Welche Remote-Überwachungs- und Warnmeldungs-Tools (Software) von Drittanbietern empfiehlt Adobe/AMS zur Überwachung einzelner Geräte? what-third-party-remote-monitoring-and-alerting-tools-software-does-adobe-ams-recommend-for-monitoring-each-device

Je nachdem, welches Ergebnis Sie von der Überwachung und den Warnmeldungen wünschen, benachrichtigt Sie der AEM Screens-Benachrichtigungsdienst, wenn ein Gerät länger nicht mehr gepingt hat. Geeignete Tools von Drittanbietern hängen vom jeweiligen Betriebssystem, seinen Funktionen und den spezifischen Anforderungen der Kundinnen und Kunden ab.

Weitere Informationen dazu, wie Sie die Geräteaktivität überwachen können, finden Sie unter AEM Screens-Benachrichtigungsdienst.

AEM Screens-Player

1. Wie installiere ich den ChromeOS-Player als Plug-in des Chrome-Browsers? how-to-install-chromeos-player-as-chrome-browser-plugin

Im Entwicklermodus kann der ChromeOS-Player als Plug-in des Chrome-Browsers installiert werden, ohne dass ein echtes Chrome-Player-Gerät erforderlich ist. Gehen Sie zur Installation wie folgt vor:

  1. Klicken Sie hier, um den neuesten Chrome-Player herunterzuladen.
  2. Entpacken Sie die Datei und speichern Sie sie auf der Festplatte.
  3. Öffnen Sie den Chrome-Browser und wählen Sie im Menü die Option Erweiterungen oder navigieren Sie direkt zu chrome://extensions.
  4. Aktivieren Sie oben rechts den Entwicklermodus.
  5. Klicken Sie oben links auf Entpackte Erweiterung laden und laden Sie den entpackten Chrome-Player.
  6. Wenn in der Liste der Erweiterungen verfügbar, aktivieren Sie das AEM Screens Chrome-Player-Plug-in.
  7. Öffnen Sie eine neue Registerkarte und klicken Sie oben links auf das Symbol Apps oder navigieren Sie direkt zu chrome://apps.
  8. Wählen Sie das AEM Screens-Plug-in. Standardmäßig wird der Player im Vollbildmodus gestartet. Drücken Sie Esc, um den Vollbildmodus zu beenden.

2. Wie kann ich das Problem beheben, wenn der Screens-Player bei einer Veröffentlichungsinstanz, die einen benutzerdefinierten Fehler-Handler aufweist, nicht authentifiziert werden kann?

Wenn der AEM Screens-Player beim Starten einen 404-Fehler erhält, stellt er eine Anfrage an /content/screens/svc.ping.json. Der Player initiiert eine Authentifizierungsanforderung, um sich bei der Veröffentlichungsinstanz zu authentifizieren. Wenn es in der Veröffentlichungsinstanz einen benutzerdefinierten Fehler-Handler gibt, sorgen Sie dafür, dass Sie in  /content/screens/svc.ping.json den 404-Status-Code für eine anonyme Person zurückgeben.

3. Wie lässt sich der Gerätebildschirm in einem Android™-Player dauerhaft einschalten? how-to-set-the-device-screen-stay-on-in-an-android-player

Führen Sie folgende Schritte durch, um „Stay Awake“ in einem beliebigen Android™-Player zu aktivieren:

  1. Navigieren Sie zu den Einstellungen des Android™-Players > Über.
  2. Tippen Sie siebenmal auf die Build-Nummer, um die Entwickleroptionen in den Einstellungen zu aktivieren.
  3. Navigieren Sie zu den Entwickleroptionen.
  4. Aktivieren Sie Stay Awake.

4. Wie lässt sich der Fenstermodus für den Windows-Player aktivieren? enable-player

Der Windows-Player verfügt über keinen Fenstermodus. Er befindet sich immer im Vollbildmodus.

5. Wie kann ich das Problem beheben, wenn ein AEM Screens-Player ständig Login-Anfragen sendet?

Gehen Sie wie folgt vor, um eine Fehlerbehebung bei einem AEM Screens-Player durchzuführen, der fortlaufend Anfragen an /content/screens/svc.json und /libs/granite/core/content/login.validate/j_security_check sendet:

  1. Wenn der AEM Screens-Player gestartet wird, sendet er eine Anfrage an /content/screens/svc.json. Wenn der Player daraufhin eine Antwort mit einem 404-Status-Code erhält, startet er eine Authentifizierungsanfrage mit /libs/granite/core/content/login.validate/j_security_check bei der Veröffentlichungsinstanz. Wenn es in der Veröffentlichungsinstanz einen benutzerdefinierten Fehler-Handler gibt, stellen Sie sicher, dass Sie in /content/screens/svc.json bzw. /content/screens/svc.ping.json den 404-Status-Code für eine anonyme Benutzerin oder einen anonymen Benutzer zurückgeben.

  2. Überprüfen Sie, ob Ihre Dispatcher-Konfiguration diese Anfragen in /filters zulässt.

    Weitere Informationen finden Sie unter Konfigurieren von Screens-Filtern.

  3. Überprüfen Sie, ob die Umschreibungsregeln des Dispatchers einen Bildschirmpfad in einen anderen Pfad umschreiben.

  4. Überprüfen Sie, ob Sie /etc/map-Regeln in der Autoren- oder Veröffentlichungsinstanz verwenden und ob die Bildschirmpfade mit sling:match übereinstimmen und intern zu einem anderen Pfad umgeleitet werden. Die Auflösung der exakten URL in /system/console/jcrresolver hilft dabei herauszufinden, ob die Veröffentlichungsinstanz diese URLs in einen anderen Pfad umschreibt.

  5. Überprüfen Sie, ob die Apache Sling Resource Resolver Factory-Konfiguration interne Neuschreibungen verursacht.

6. Wie lassen sich Details zu Anzeige und Gerät von der Player-API abrufen?

Die Details zu Anzeige und Gerät erhalten Sie über:

  • eine interne JS-API

  • einen ContextHub-Store: Drei ContextHub-Stores sind in /libs/screens/clientlibs/contexthub definiert, um Informationen zu Kanal, Geräte und Anzeige anzuzeigen.

    Gehen Sie wie folgt vor, um diese ContentHub-Speicherwerte zu verwenden:

    • Bearbeiten Sie die Eigenschaften des Kanals und legen Sie auf der Registerkarte „Personalisierung“ den ContextHub-Pfad auf den Wert fest (wie oben erläutert)

    • Im Kanal-JS können Sie Folgendes verwenden:

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

Allgemeine Tipps zur Problembehebung general-troubleshooting-tips

1. Wie kann ich Livefyre deaktivieren, um A/P-Screens-Fehler zu vermeiden?

Deaktivieren Sie Livefyre, um Protokollfehler zu vermeiden, indem Sie wie folgt vorgehen.

  1. Livefyre-Bundle deaktivieren:

    • Navigieren Sie zu https://<host>:<port>/system/console/bundles.
    • Suchen Sie nach dem AEM Livefyre-Bundle: com.adobe.cq.social.cq-social-livefyre.
    • Klicken Sie auf die Option zum Anhalten.

  2. So deaktivieren Sie den Livefyre-Poller:

    • Navigieren Sie in CRXDE Lite zu /etc/importers/polling/livefyre-poller/jcr:content.
    • Fügen Sie eine aktivierte Eigenschaft vom Typ Boolesch hinzu
    • Setzen Sie die Eigenschaft Enabled auf false.

2. Wie fügt man Oak-Index-Informationen hinzu? add-oak-index-info

AEM Screens erstellt Indexdefinitionen für die vom Produkt verwendeten Abfragen.
Wenn es im error.log abfrageübergreifende Warnhinweise (WARN) gibt, erstellen Sie einen benutzerdefinierten Index für Ihre Abfrage. Weitere Informationen finden Sie unter Konfigurieren der Indizes.

Eine zusätzliche Ressource finden Sie in der Oak-Dokumentation.

3. Was ist erforderlich, um v3-Manifeste zu konfigurieren? configure-v3

Gehen Sie wie folgt vor, um das v3-Manifest zu aktivieren:

  • Dispatcher aktualisieren.
    Weitere Informationen finden Sie unter Konfigurieren des Dispatchers für Manifest Version 3.

  • Benutzerdefinierte Komponente aktualisieren.
    Weitere Informationen finden Sie unter Vorlage für benutzerdefinierte Handler.

  • ContentSync in /system/console/configMgr/configMgr/com.adobe.cq.screens.offlinecontent.impl.ContentSyncCacheFeatureFlag deaktivieren.

  • SmartSync in /system/console/configMgr/com.adobe.cq.screens.offlinecontent.impl.OfflineContentServiceImpl aktivieren.

  • channel/experience fragment/page components bearbeiten.

  • Navigieren Sie zur Registerkarte Offline-Konfiguration.

  • Geben Sie clientlibs und die Ordner für statische Dateien ein, die zum Manifest hinzugefügt werden müssen.

4. Was sollten Sie tun, wenn nach dem Paket „screens-cloud-ams-pkg-0.0.20“ zwar „screens-cloud-ams-pkg-0.0.16“ und die Screens-Core-Bundles installiert, aber nicht aktiv sind?

Sie müssen mindestens die Version AEM 6.5 Feature Pack 8 installieren, damit der AMS-Connector funktioniert. Unter Verfügbarkeit finden Sie Informationen zur Mindestversion des AEM Screens Feature Packs.

Der Service wird verwendet, um den öffentlichen Host-Namen für die Autoren- und Veröffentlichungsinstanz zu definieren. Die Werte werden dann zum Aktualisieren der Geräte-Server-URLs und auch für das ContextHub-Targeting verwendet.

Der CQ Link Externalizer-Dienst in Screens kann wie folgt konfiguriert werden:

  1. Navigieren Sie zu http://localhost:4502/system/console/configMgr
  2. Day CQ Link Externalizer
  3. Ändern Sie den Host-Namen für die author/publish-Einträge nach Bedarf
recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053