Verwenden von Best Practices Analyzer using-best-practices-analyzer

Wichtige Überlegungen zur Verwendung von Best Practices Analyzer imp-considerations

Im folgenden Abschnitt finden Sie wichtige Überlegungen zur Verwendung von Best Practices Analyzer (BPA):

  • Der BPA-Bericht wird mit der Ausgabe der Adobe Experience Manager (AEM)-Mustererkennung erstellt. Die von BPA verwendete Version der Mustererkennung ist im BPA-Installationspaket enthalten.

  • BPA kann nur vom Administrator oder einem Anwender Administratorgruppe ausgeführt werden.

  • BPA wird in AEM-Instanzen mit Version 6.1 und höher unterstützt.

    note note
    NOTE
    Besondere Anforderungen für die Installation von BPA unter AEM 6.1 finden Sie unter Installieren in AEM 6.1.
  • BPA kann in jeder Umgebung ausgeführt werden, es wird jedoch empfohlen, das Tool in einer Staging-Umgebung auszuführen.

    note note
    NOTE
    Um Auswirkungen auf geschäftskritische Instanzen zu vermeiden, wird empfohlen, BPA auf einer Authoring-Umgebung auszuführen, die der Produktions-Umgebung im Hinblick auf Anpassungen, Konfigurationen, Inhalte und Anwenderprogrammen möglichst nahekommt. Alternativ kann BPA in einem Klon der Autoren-Produktionsumgebung ausgeführt werden.
  • Die Erstellung von BPA-Berichten kann sehr viel Zeit in Anspruch nehmen, von einigen Minuten bis zu einigen Stunden. Die benötigte Zeit hängt in hohem Maße von der Größe und Art des AEM-Repository-Inhalts, der AEM-Version und anderen Faktoren ab.

  • Aufgrund der beträchtlichen Zeit, die zum Generieren des Berichtinhalts erforderlich sein könnte, wird dieser von einem Hintergrundprozess generiert und in einem Cache gespeichert. Der Bericht sollte relativ schnell angezeigt und heruntergeladen werden, da er den Inhalts-Cache nutzt, bis dieser abläuft oder der Bericht explizit aktualisiert wird. Während der Generierung von Berichtinhalten können Sie Ihre Browser-Registerkarte schließen und zu einem späteren Zeitpunkt zur Ansicht des Berichts zurückkehren, sobald der Inhalt im Cache verfügbar ist.

Verfügbarkeit availability

Best Practices Analyzer kann als ZIP-Datei vom Software Distribution-Portal heruntergeladen werden. Sie können das Paket über Package Manager in Ihrer Quellinstanz von Adobe Experience Manager (AEM) installieren.

NOTE
Laden Sie Best Practices Analyzer aus dem Software Distribution-Portal herunter.

Anzeigen des Best Practices Analyzer-Berichts viewing-report

Adobe Experience Manager 6.3.0 und höher aem-later-versions

Folgen Sie diesem Abschnitt, um zu erfahren, wie Sie den Best Practices Analyzer-Bericht anzeigen können:

  1. Wählen Sie Adobe Experience Manager aus und navigieren Sie zu „Tools“ > Vorgänge > Best Practices Analyzer.

    Bild

  2. Klicken Sie auf Bericht generieren, um Best Practices Analyzer auszuführen.

    image

  3. Während BPA den Bericht generiert, können Sie den Fortschritt des Tools auf dem Bildschirm verfolgen. Dabei wird die Anzahl der analysierten Elemente und gefundenen Ergebnisse angezeigt.

    image

  4. Sobald der BPA-Bericht erstellt wurde, werden eine Zusammenfassung sowie die Anzahl der Ergebnisse in tabellarischer Form angezeigt, die nach Ergebnistyp und Wichtigkeitsstufe geordnet sind. Um weitere Details zu einem bestimmten Ergebnis zu erhalten, können Sie die Zahl anklicken, die dem Typ des Ergebnisses in der Tabelle entspricht.

    image

    Mit der oben beschriebenen Aktion wird automatisch ein Bildlauf zur Position des Ergebnisses im Bericht durchgeführt.

    image

  5. Sie haben die Möglichkeit, den Bericht im CSV-Format herunterzuladen, indem Sie auf In CSV exportieren klicken, wie in der folgenden Abbildung dargestellt.

    image

    note note
    NOTE
    Sie können BPA zwingen, seinen Cache zu leeren und den Bericht neu zu generieren, indem Sie auf Bericht aktualisieren klicken.

    image

    note note
    NOTE
    Während der Berichterstellung wird der Fortschritt in Prozent angezeigt, wie in der Abbildung unten dargestellt.

    image

Verwenden von Filtern im Bericht „Best Practices Analyzer“ bpa-filters

Gehen Sie wie folgt vor, um Ergebnisse zu ACS Commons herauszufiltern:

  1. Klicken Sie links auf der Seite auf das Symbol in der linken Leiste. Dadurch wird der ACS Commons-Filter angezeigt. Klicken Sie auf den ACS Commons-Filter, um das interaktive Kontrollkästchen anzuzeigen, wie in der nachfolgenden Abbildung dargestellt.

    Bild

    note note
    NOTE
    Das Symbol in der linken Leiste wird nur angezeigt, wenn BPA die Verwendung von ACS Commons erkennt.
  2. Deaktivieren Sie das Kontrollkästchen, um alle Ergebnisse zu ACS Commons herauszufiltern. Im Bericht sollte ein Zähler für die gefilterten Ergebnisse angezeigt werden, wie in der nachfolgenden Abbildung dargestellt. Der Filter wird auch auf den Bericht angewendet, wenn er im CSV-Format (CSV) exportiert wird.

    image

    note note
    NOTE
    Die Ergebnisse von ACS Commons sollten nicht ignoriert werden. Informationen zur Kompatibilität mit AEM as a Cloud Service finden Sie in der Dokumentation.

Interpretieren des Best Practices Analyzer-Berichts cra-report

Wenn das Best Practices Analyzer-Tool in der AEM-Instanz ausgeführt wird, wird der Bericht als Ergebnis im Tool-Fenster angezeigt.

Das Format des Berichts lautet:

  • Berichtsübersicht: Informationen zum Bericht selbst, einschließlich der Folgenden:

    • Berichtszeit: Zeitpunkt der Erstellung und erstmaligen Bereitstellung des Berichtinhalts.
    • Ablaufzeit: Wann der Cache für den Inhalt des Berichts abläuft.
    • Erstellungszeitraum: Die Zeit, die der Prozess des Generierens des Berichtinhalts benötigt hat.
    • Ergebniszähler: Die Gesamtzahl der im Bericht enthaltenen Ergebnisse.
  • Systemübersicht: Informationen zum AEM-System, für das BPA ausgeführt wurde.

  • Suchen von Kategorien: Mehrere Abschnitte, die jeweils eine oder mehrere Ergebnisse derselben Kategorie behandeln. Jeder Abschnitt enthält Folgendes: Name der Kategorie, Untertypen, Anzahl und Wichtigkeit der Ergebnisse, Zusammenfassung, Link zur Dokumentation der Kategorien und individuelle Suchinformationen.

Jedem Ergebnis wird eine Wichtigkeitsstufe zugewiesen, um eine ungefähre Priorität für das Handeln anzugeben.

NOTE
Weitere Informationen zu den einzelnen Kategorien finden Sie unter Musterdetektorkategorien.

Sie finden die Wichtigkeitsstufen in der folgenden Tabelle:

Wichtigkeit
Beschreibung
INFO
Diese Ergebnisse werden zu Informationszwecken bereitgestellt.
ADVISORY
Diese Ergebnisse stellen möglicherweise ein Problem bei der Aktualisierung dar. Weitere Untersuchungen werden empfohlen.
MAJOR
Diese Ergebnisse stellen wahrscheinlich ein Problem bei der Aktualisierung dar, das behoben werden sollte.
CRITICAL
Diese Ergebnisse stellen wahrscheinlich ein Problem bei der Aktualisierung dar, das behoben werden muss, um Funktionsverlust oder Leistungseinbußen zu vermeiden.

Interpretieren des Best Practices Analyzer-CSV-Berichts cra-csv-report

Wenn Sie in Ihrer AEM-Instanz auf die Option CSV klicken, wird das CSV-Format des Best Practices Analyzer-Berichts aus dem Inhalts-Cache erstellt und an Ihren Browser zurückgegeben. Abhängig von Ihren Browser-Einstellungen wird dieser Bericht automatisch als Datei mit dem Standardnamen results.csv heruntergeladen.

Wenn der Cache abgelaufen ist, wird der Bericht erneut generiert, bevor die CSV-Datei erstellt und heruntergeladen wird.

Das CSV-Format des Berichts enthält Informationen, die aus der Mustererkennungsausgabe generiert wurden und nach Kategorie, Untertyp und Wichtigkeitsstufe sortiert und organisiert sind. Sein Format eignet sich zum Anzeigen und Bearbeiten in einem Programm wie Microsoft Excel. Alle Ergebnisinformationen werden in einem wiederholbaren Format bereitgestellt, das beim Vergleich von Berichten im Zeitverlauf zur Messung des Fortschritts hilfreich sein kann.

Die Spalten des Berichts im CSV-Format sind:

  • code: der Code der Kategorie
  • type: der Name der Kategorie
  • subtype: der Untertyp der Kategorie
  • importance: die Wichtigkeitsstufe
  • identifier: die primäre Kennung des Ergebnisses
  • other: zusätzliche Informationen zum Ergebnis
  • message: die für das Ergebnis angegebene Meldung
  • moreInfo: ein Link, über den Sie auf die Online-Hilfe zur Kategorie zugreifen können
  • context: eine JSON-Zeichenfolge von Ergebnisdaten

Der Wert „\N“ in einer Spalte für ein einzelnes Ergebnis zeigt an, dass keine Daten bereitgestellt wurden.

HTTP-Schnittstelle http-interface

BPA bietet eine HTTP-Schnittstelle, die als Alternative zur AEM-Benutzeroberfläche verwendet werden kann. Die Schnittstelle unterstützt sowohl HEAD- als auch GET-Befehle. Sie kann zum Generieren des BPA-Berichts und zur Rückgabe in einem der drei folgenden Formate verwendet werden: JSON-, CSV- und tabulatorgetrennte Werte (TSV).

Die folgenden URLs stehen für den HTTP-Zugriff zur Verfügung, wobei <host> der Host-Name und gegebenenfalls der Port des Servers ist, auf dem BPA installiert ist:

  • http://<host>/apps/best-practices-analyzer/analysis/report.json für das JSON-Format
  • http://<host>/apps/best-practices-analyzer/analysis/report.csv für das CSV-Format
  • http://<host>/apps/best-practices-analyzer/analysis/report.tsv für das TSV-Format

Ausführen einer HTTP-Anfrage executing-http-request

Die HTTP-Schnittstelle kann auf verschiedene Weise verwendet werden.

Eine einfache Möglichkeit besteht darin, eine Browser-Registerkarte im selben Browser zu öffnen, in dem Sie sich bereits als Administrator bei AEM angemeldet haben. Sie können die URL in der Browser-Registerkarte eingeben und die Ergebnisse vom Browser anzeigen oder herunterladen lassen.

Sie können auch ein Befehlszeilen-Tool wie curl oder wget oder eine beliebige HTTP-Client-Anwendung verwenden. Wenn Sie keine Browser-Registerkarte mit einer authentifizierten Sitzung verwenden, müssen Sie als Teil des Kommentars einen Administrator-Benutzernamen und ein Kennwort angeben.

Im Folgenden ein Beispiel:
curl -u admin:admin 'http://localhost:4502/apps/best-practices-analyzer/analysis/report.csv' > report.csv.

Kopfzeilen und Parameter http-headers-and-parameters

Diese Schnittstelle verwendet die folgenden HTTP-Kopfzeilen:

  • Cache-Control: max-age=<seconds>: Gibt die Lebensdauer der Cache-Aktualisierung in Sekunden an. (Siehe RFC 7234.)
  • Prefer: respond-async: Gibt an, dass der Server asynchron reagieren soll. (Siehe RFC 7240.)
  • Prefer: return=minimal: Gibt an, dass der Server eine minimale Antwort zurückgeben soll. (Siehe RFC 7240.)

Die folgenden HTTP-Abfrageparameter stehen zur Verfügung, wenn HTTP-Kopfzeilen möglicherweise nicht einfach verwendet werden können:

  • max-age (Zahl, optional): Gibt die Lebensdauer der Cache-Aktualisierung in Sekunden an. Diese Zahl muss 0 oder höher sein. Die Standardlebensdauer für die Aktualisierung beträgt 86400 Sekunden. Ohne diesen Parameter oder den entsprechenden Header wird ein Aktualisierungs-Cache verwendet, um Anfragen 24 Stunden lang zu verarbeiten, bevor der Bericht neu generiert werden muss. Durch die Verwendung von max-age=0 wird das Löschen des Caches erzwungen und eine Neuerstellung des Berichts eingeleitet. Dazu wird die zuvor festgelegte Lebensdauer für die Aktualisierung mit einem Wert, der ungleich null ist, für den neu generierten Cache verwendet.
  • respond-async (boolesch, optional): Gibt an, dass die Antwort asynchron bereitgestellt werden soll. Die Verwendung von respond-async=true, wenn der Cache veraltet ist, führt dazu, dass der Server die Antwort 202 Accepted zurückgibt und den Cache verarbeitet, ohne darauf zu warten, dass der Cache aktualisiert und der Bericht generiert wird. Wenn der Cache aktualisiert ist, hat dieser Parameter keine Auswirkung. Der Standardwert ist false. Ohne diesen Parameter oder den entsprechenden Header reagiert der Server synchron. Dies kann viel Zeit und eine Anpassung der maximalen Antwortzeit für den HTTP-Client erfordern.
  • may-refresh-cache (boolesch, optional): Gibt an, dass der Server den Cache bei einer Anfrage aktualisieren kann, wenn der aktuelle Cache leer oder veraltet ist bzw. in Kürze veraltet sein wird. Wenn may-refresh-cache=true oder wenn dieser Wert nicht angegeben wird, dann kann der Server eine Hintergrundaufgabe initiieren, die den Musterdetektor aufruft und den Cache aktualisiert. Wenn may-refresh-cache=false, dann initiiert der Server keine Aktualisierungsaufgabe, die andernfalls ausgeführt worden wäre, wenn der Cache leer oder veraltet ist. In diesem Fall ist der Bericht leer. Auf eine Aktualisierungsaufgabe, die bereits in Bearbeitung ist, hat dieser Parameter keine Auswirkung.
  • return-minimal (boolesch, optional): Gibt an, dass die Antwort des Servers nur den Status mit der Fortschrittsanzeige und dem Cache-Status im JSON-Format enthalten sollte. Wenn return-minimal=true, dann ist der Antworttext auf das Statusobjekt beschränkt. Wenn return-minimal=false oder der Wert nicht angegeben wird, wird eine vollständige Antwort bereitgestellt.
  • log-findings (boolesch, optional): Gibt an, dass der Server den Inhalt des Caches beim ersten Erstellen oder Aktualisieren protokollieren soll. Jedes Ergebnis aus dem Cache wird als JSON-Zeichenfolge protokolliert. Diese Protokollierung erfolgt nur, wenn log-findings=true und die Anfrage einen neuen Cache generiert.

Wenn sowohl eine HTTP-Kopfzeile als auch ein entsprechender Abfrageparameter vorhanden sind, hat der Abfrageparameter Vorrang.

Mit dem folgenden Befehl können Sie die Generierung des Berichts einfach über die HTTP-Schnittstelle starten:
curl -u admin:admin 'http://localhost:4502/apps/best-practices-analyzer/analysis/report.json?max-age=0&respond-async=true'.

Nachdem eine Anfrage gestellt wurde, muss der Client nicht aktiv bleiben, damit der Bericht generiert wird. Die Berichterstellung kann mit einem Client mithilfe einer HTTP-GET-Anfrage initiiert und nach der Erstellung des Berichts aus dem Cache mit einem anderen Client oder dem BPA-Tool in der AEM-Benutzeroberfläche angezeigt werden.

Antworten http-responses

Die folgenden Antwortwerte sind möglich:

  • 200 OK: Gibt an, dass die Antwort Ergebnisse des Musterdetektors enthält, die während der Lebensdauer für die Aktualisierung des Caches generiert wurden.
  • 202 Accepted: Wird verwendet, um anzugeben, dass der Cache veraltet ist. Wenn respond-async=true und may-refresh-cache=true, dann weist diese Antwort darauf hin, dass eine Aktualisierungsaufgabe ausgeführt wird. Wenn may-refresh-cache=false, gibt diese Antwort einfach an, dass der Cache veraltet ist.
  • 400 Bad Request: Gibt an, dass bei der Anfrage ein Fehler aufgetreten ist. Eine Meldung im Format für Problemdetails (siehe RFC 7807) enthält weitere Details.
  • 401 Unauthorized: Gibt an, dass die Anfrage nicht genehmigt wurde.
  • 500 Internal Server Error: Gibt an, dass ein interner Server-Fehler aufgetreten ist. Eine Meldung im Format für Problemdetails enthält weitere Details.
  • 503 Service Unavailable: Zeigt an, dass der Server mit einer anderen Antwort beschäftigt ist und diese Anfrage nicht rechtzeitig bearbeiten kann. Dies tritt aller Wahrscheinlichkeit nach nur dann auf, wenn synchrone Anfragen gestellt werden. Eine Meldung im Format für Problemdetails enthält weitere Details.

Administratorinformationen

Anpassung der Cache-Lebensdauer cache-adjustment

Die standardmäßige BPA-Cache-Lebensdauer beträgt 24 Stunden. Mit der Option zum Aktualisieren eines Berichts und zum erneuten Generieren des Caches sowohl in der AEM-Instanz als auch in der HTTP-Schnittstelle ist dieser Standardwert wahrscheinlich für die meisten Verwendungen von BPA geeignet. Wenn die Zeit für die Berichterstellung für Ihre AEM-Instanz besonders lang ist, möchten Sie möglicherweise die Cache-Lebensdauer anpassen, um das erneute Generieren des Berichts zu minimieren.

Der Wert für die Cache-Lebensdauer wird als maxCacheAge-Eigenschaft im folgenden Repository-Knoten gespeichert:
/apps/best-practices-analyzer/content/BestPracticesReport/jcr:content

Der Wert dieser Eigenschaft ist die Cache-Lebensdauer in Sekunden. Ein Administrator kann die Cache-Lebensdauer mit CRX/DE Lite anpassen.

Installieren in AEM 6.1 installing-on-aem61

BPA verwendet ein System-Service-Anwenderkonto mit dem Namen repository-reader-service zum Ausführen der Mustererkennung. Dieses Konto ist auf AEM 6.2 und höher verfügbar. In AEM 6.1 muss dieses Konto vor der Installation von BPA wie folgt erstellt werden:

  1. Befolgen Sie die Anweisungen unter Erstellen eines neuen Service-Benutzers, um einen Benutzer zu erstellen. Legen Sie die UserID als repository-reader-service fest, lassen Sie den Zwischenpfad leer und klicken Sie dann auf das grüne Häkchen.

  2. Befolgen Sie die Anweisungen unter Verwalten von Benutzern und Gruppen, insbesondere die Anweisungen zum Hinzufügen von Benutzern zu einer Gruppe, um den repository-reader-service-Benutzer zur administrators-Gruppe hinzuzufügen.

  3. Installieren Sie das BPA-Paket über den Package Manager auf Ihrer AEM-Quellinstanz. (Dadurch wird die erforderliche Konfigurationsänderung zur ServiceUserMapper-Konfiguration für den repository-reader-service-System-Service-Anwender hinzugefügt.)

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab