Analysator van best practices gebruiken using-best-practices-analyzer
Belangrijke overwegingen voor het Gebruiken van Analyzer van Beste praktijken imp-considerations
Volg de sectie hieronder om de belangrijke overwegingen voor het runnen van de Analysator van Beste praktijken (BPA) te begrijpen:
-
Het BPA- rapport wordt gebouwd gebruikend de output van de Detector van het Patroon van Adobe Experience Manager (AEM) 🔗. De versie van de Detector van het Patroon die door BPA wordt gebruikt is inbegrepen in het BPA installatiepakket.
-
BPA kan slechts door de admin gebruiker of een gebruiker in de beheerders groep worden in werking gesteld.
-
BPA wordt ondersteund op AEM instanties met versie 6.1 en hoger.
note note NOTE Zie Installerend op AEM 6.1voor speciale vereisten voor het installeren van BPA op AEM 6.1. -
BPA kan op om het even welk milieu in werking stellen, maar het heeft de voorkeur om het op het milieu van het a Stadium te hebben.
note note NOTE Om een effect op bedrijfskritieke instanties te vermijden, adviseert men dat u BPA op een milieu van het Stadium in werking stelt dat zo dicht mogelijk aan het milieu van de Productie op de gebieden van aanpassingen, configuraties, inhoud en gebruikerstoepassingen is. CRA kan ook worden uitgevoerd op een kloon van de auteur laag van de productieomgeving. -
Het genereren van de inhoud van het BPA-rapport kan een aanzienlijke hoeveelheid tijd in beslag nemen, van enkele minuten tot een paar uur. De benodigde tijd is in hoge mate afhankelijk van de grootte en aard van de AEM-repository-content, de AEM-versie en andere factoren.
-
Vanwege de tijd die nodig is om de rapportcontent te produceren, gebeurt dit in een achtergrondproces, waarbij de data in cache worden opgeslagen. Het bekijken en downloaden van het rapport gaat relatief snel, omdat hierbij de content in het cachegeheugen wordt opgehaald, totdat het geheugen verloopt of het rapport uitdrukkelijk wordt vernieuwd. Tijdens de generatie van de rapportcontent kunt u uw browsertabblad sluiten en later terugkeren om het rapport te bekijken zodra de content in het cachegeheugen beschikbaar is.
Beschikbaarheid availability
De Analysator van Beste praktijken kan als zip dossier van het portaal van de Distributie van de Software worden gedownload. U kunt het pakket via Manager van het Pakketop uw bronAdobe Experience Manager (AEM) instantie installeren.
Connectiviteit Source-omgeving source-environment-connectivity
De bron AEM instantie kan achter een firewall lopen waar het slechts bepaalde gastheren kan bereiken die aan een Lijst van gewenste personen zijn toegevoegd. Als u het BPA-gegenereerde rapport automatisch naar Cloud Acceleration Manager wilt uploaden, moeten de volgende eindpunten toegankelijk zijn vanaf de instantie die AEM uitvoert:
- De Azure-opslagservice:
casstorageprod.blob.core.windows.net
Het Rapport van de Analysator van Beste praktijken bekijken viewing-report
Adobe Experience Manager 6.3.0 en hoger aem-later-versions
Volg deze sectie om te leren hoe te om het rapport van de Analysator van Beste praktijken te bekijken:
-
Selecteer Adobe Experience Manager en navigeer aan hulpmiddelen > Verrichtingen > Analysator van Beste praktijken.
-
Klik produceren Rapport om de Analysator van Beste praktijken uit te voeren.
-
Verstrek BPA upload sleutel om het geproduceerde BPA- rapport aan Cloud Acceleration Manager (CAM)automatisch te uploaden. Om uploadt sleutel te krijgen, navigeer aan de Analyse van Beste praktijken in CAM
-
produceer knoop actief wordt wanneer een geldige sleutel wordt verstrekt. Klik op produceren om rapportgeneratie in werking te stellen.
-
Terwijl BPA het rapport produceert, kunt u de vooruitgang zien die door het hulpmiddel op het scherm wordt gemaakt. De voortgang wordt weergegeven in procenten dat is voltooid. Ook wordt het aantal geanalyseerde items weergegeven en wordt het aantal gevonden bevindingen weergegeven.
-
Nadat het BPA-rapport is gegenereerd, worden een samenvatting en het aantal bevindingen weergegeven in een tabelvorm die is ingedeeld op basis van het type bevinding en het belangrijkste niveau. Voor meer informatie over een bepaalde bevinding kunt u op het nummer klikken dat overeenkomt met het type bevinding in de tabel.
-
U hebt de optie om het rapport in een komma-gescheiden waarden (CSV) formaat te downloaden door op Uitvoer naar CSV te klikken. U hebt ook de optie om het rapport in CAM te bekijken door op te klikken gaat naar CAM. Dit zal u aan de pagina van de Analyse van Beste praktijkenin CAM nemen.
U kunt BPA dwingen om zijn geheime voorgeheugen te ontruimen en het rapport opnieuw te produceren door te klikken verfrist Rapport.
- Als het geheime voorgeheugen verloopt, hebt u de optie om het laatste geproduceerde rapport in CAM te bekijken door op te klikken Mening het laatste geproduceerde rapport in CAM of een nieuwe rapportgeneratie in werking te stellen door op te klikken produceert Nieuw Rapport.
Het gebruiken van Filters in het Rapport van de Analysator van Beste praktijken bpa-filters
Om bevindingen met betrekking tot ACS Commonsuit te filtreren, volg de stappen hieronder:
-
Klik op het linkerspoorpictogram aan de linkerkant van de pagina. Dit zal de filter van de Bevelen ACS tonen. Klik de filter van Bevelen ACS om interactieve checkbox zoals aangetoond in het hieronder beeld te tonen.
note note NOTE Het linkerspoorpictogram zal verschijnen slechts als BPA het gebruik van ACSCommons ontdekt. -
Schakel het selectievakje uit om alle bevindingen met betrekking tot ACS-opdrachten uit te filteren. U zou a Gefilterde het Vinden Aantal op het rapport zoals aangetoond in het beeld hieronder moeten zien. Het filter wordt ook toegepast op het rapport wanneer het in een komma-gescheiden-waarde (CSV) formaat wordt uitgevoerd.
note note NOTE De bevindingen van de ACS-Gemeenschappelijke Gemeenschap moeten niet worden genegeerd. Zie documentatieom verenigbaarheid met AEM as a Cloud Service te bepalen.
Het rapport met de analyse van best practices interpreteren cra-report
Wanneer het hulpmiddel van de Analysator van Beste praktijken in de AEM instantie in werking wordt gesteld, wordt het rapport getoond als resultaten in het hulpmiddelvenster.
Het rapport is als volgt ingedeeld:
-
Overzicht van rapport: Informatie over het rapport zelf. het overzicht biedt de volgende gegevens:
- Tijd van rapport: Tijdstip waarop de rapportcontent is gegenereerd en voor het eerst beschikbaar gesteld.
- Vervaltijd: Tijdstip waarop de cachecontent verloopt.
- Tijdsperiode voor genereren: De benodigde tijd om de rapportcontent te genereren.
- Aantal bevindingen: Het totale aantal bevindingen in het rapport.
-
Overzicht van het Systeem: Informatie over het AEM systeem waarop BPA in werking werd gesteld.
-
Categorieën voor bevindingen: Meerdere secties waarin elk een of meer bevindingen van dezelfde categorie worden behandeld. Elke sectie bevat de volgende items: categorienaam, subtypen, aantal en belang, samenvatting, koppeling naar categoriedocumentatie en individuele informatie over de bevindingen.
Aan elke bevinding wordt een belangniveau toegewezen als ruwe prioriteit voor de benodigde actie.
Bekijk de onderstaande tabel om inzicht te krijgen in de belangniveaus:
Het CSV-rapport van de Analysator van best practices interpreteren cra-csv-report
Wanneer u de CSV optie van uw AEM instantie klikt, wordt het formaat CSV van het rapport van de Analysator van Beste praktijken gebouwd van het inhoudsgeheime voorgeheugen en teruggekeerd aan uw browser. Afhankelijk van de browserinstellingen wordt dit rapport automatisch gedownload als een bestand met de standaardnaam results.csv .
Als het geheime voorgeheugen is verlopen, dan wordt het rapport opnieuw geproduceerd alvorens het Csv- dossier wordt gebouwd en gedownload.
De CSV-indeling van het rapport bevat informatie die wordt gegenereerd op basis van de Pattern Detector-uitvoer. Deze informatie is gesorteerd en ingedeeld op categorietype, subtype en belang. De indeling is geschikt voor weergave en bewerking in een applicatie zoals Microsoft Excel. Het is bedoeld om alle vindingsinformatie in een herhaalbare formaat te verstrekken dat wanneer het vergelijken van rapporten in tijd kan nuttig zijn om vooruitgang te meten.
Het CSV-indelingsrapport bevat de volgende kolommen:
- code: De categoriecode
- type: De categorienaam
- subtype: Het subtype van de categorie
- importance: Het belang van de bevinding
- identifier: De primaire id van de bevinding
- other: Aanvullende informatie over de bevinding
- message: Het bericht dat voor de bevinding wordt verstrekt
- moreInfo: Een koppeling voor toegang tot online hulp over de categorie
- context: Een JSON-tekenreeks voor het zoeken naar data
De waarde "\N" in een kolom voor een individuele bevinding geeft aan dat er geen data zijn opgegeven.
HTTP-interface http-interface
BPA verstrekt een interface van HTTP die als alternatief aan zijn gebruikersinterface binnen AEM kan worden gebruikt. Deze interface ondersteunt zowel HEAD- als GET-opdrachten. Het kan worden gebruikt om het BPA- rapport te produceren en het in één van drie formaten terug te keren: JSON, CSV, en lusje-gescheiden waarden (TSV).
De volgende URL's zijn beschikbaar voor HTTP-toegang, waarbij <host> de hostnaam en poort is, indien nodig, van de server waarop de BPA is geïnstalleerd:
http://<host>/apps/best-practices-analyzer/analysis/report.jsonvoor de JSON-indelinghttp://<host>/apps/best-practices-analyzer/analysis/report.csvvoor de CSV-indelinghttp://<host>/apps/best-practices-analyzer/analysis/report.tsvvoor de TSV-indeling
Een HTTP-aanvraag uitvoeren executing-http-request
De HTTP-interface kan op een aantal manieren worden gebruikt.
Een eenvoudige manier is om een browsertabblad te openen in dezelfde browser waarin u zich al als beheerder hebt aangemeld bij AEM. U kunt de URL invoeren op het browsertabblad en de resultaten laten weergeven of downloaden door de browser.
U kunt ook een opdrachtregelprogramma gebruiken, zoals curl of wget , en elke HTTP-clienttoepassing. Wanneer u geen browsertabblad gebruikt met een geverifieerde sessie, moet u de naam en wachtwoord van een beheerder-gebruiker opgeven als onderdeel van de opmerking.
Hieronder ziet u hoe u dit kunt doen:curl -u admin:admin 'http://localhost:4502/apps/best-practices-analyzer/analysis/report.csv' > report.csv.
Kopteksten en parameters http-headers-and-parameters
De volgende HTTP-headers worden door deze interface gebruikt:
Cache-Control: max-age=<seconds>- Geeft de levensduur van de cache-versheid op in seconden. (Zie RFC 7234.)Prefer: respond-async- Geeft op dat de server asynchroon moet reageren. (Zie RFC 7240.)Prefer: return=minimal- Geeft op dat de server een minimale reactie moet retourneren. (Zie RFC 7240.)
De volgende handige HTTP-queryparameters zijn beschikbaar wanneer HTTP-headers niet gemakkelijk kunnen worden gebruikt:
max-age(getal, optioneel): geeft de levensduur van de cache-versheid op in seconden. Dit getal moet 0 of hoger zijn. De standaard versheidslevensduur is 86400 seconden. Zonder deze parameter of de overeenkomstige kopbal, wordt een vers geheime voorgeheugen gebruikt om verzoeken voor 24 uren te dienen, waarbij het geheime voorgeheugen moet worden opnieuw geproduceerd. Het gebruiken vanmax-age=0zal dwingen het geheime voorgeheugen wordt ontruimd en zal een regeneratie van het rapport in werking stellen, gebruikend het vorige niet-nul freshness leven voor het onlangs geproduceerde geheime voorgeheugen.respond-async(Boolean, optioneel): geeft op dat de reactie asynchroon moet worden opgegeven. Als urespond-async=truegebruikt wanneer de cache leeg is, retourneert de server een reactie van202 Acceptedzonder te wachten tot de cache is vernieuwd en tot het rapport is gegenereerd. Als de cache vernieuwd is, heeft deze parameter geen effect. De standaardwaarde isfalse. Zonder deze parameter of de overeenkomstige kopbal zal de server synchroon antwoorden, die een significante hoeveelheid tijd kan vereisen en een aanpassing van de maximumreactietijd voor de cliënt van HTTP vereisen.may-refresh-cache(Booleaans, optioneel): Geeft aan dat de server de cache kan vernieuwen als reactie op een aanvraag als de huidige cache leeg, leeg of verouderd is of binnenkort zal zijn. Alsmay-refresh-cache=trueis, of als dit niet is opgegeven, kan de server een achtergrondtaak starten die de Patroondetector oproept en de cache vernieuwt. Alsmay-refresh-cache=falsedan zal de server geen verfrissingstaak in werking stellen die anders zou gedaan zijn als het geheime voorgeheugen leeg of verouderd is, in welk geval het rapport leeg is. Deze parameter heeft geen invloed op vernieuwingstaken die al in uitvoering zijn.return-minimal(Booleaans, optioneel): geeft aan dat de reactie van de server alleen de status mag bevatten die de voortgangsindicatie en cachestatus in de JSON-indeling bevat. Alsreturn-minimal=true, is de hoofdtekst van de reactie beperkt tot het statusobject. Alsreturn-minimal=falseis opgegeven of als deze niet is opgegeven, wordt een volledige reactie gegeven.log-findings(Boolean, optioneel): geeft aan dat de server de inhoud van de cache moet vastleggen wanneer deze voor het eerst wordt gemaakt of vernieuwd. Elke bevinding via de cache wordt geregistreerd als een JSON-tekenreeks. Deze logboekregistratie vindt alleen plaats alslog-findings=trueen de aanvraag een nieuwe cache genereren.
Wanneer zowel de HTTP-header en de overeenkomstige queryparameter aanwezig zijn, heeft de queryparameter prioriteit.
De volgende opdracht vormt een eenvoudige manier om de productie van het rapport via de HTTP-interface te starten:curl -u admin:admin 'http://localhost:4502/apps/best-practices-analyzer/analysis/report.json?max-age=0&respond-async=true'.
Zodra een aanvraag is ingediend, hoeft de client niet actief te zijn voor het produceren van het rapport. De rapportgeneratie zou met één cliënt kunnen in werking worden gesteld gebruikend een verzoek van de GET van HTTP en, zodra het rapport is geproduceerd, bekeken van het geheime voorgeheugen met een andere cliënt of met het hulpmiddel BPA in het AEM gebruikersinterface.
Reacties http-responses
De volgende responswaarden zijn mogelijk:
200 OK: geeft aan dat de reactie bevindingen van de patroondetector bevat die zijn gegenereerd binnen de frissheidsperiode van de cache.202 Accepted: wordt gebruikt om aan te geven dat de cache leeg is. Alsrespond-async=trueenmay-refresh-cache=truedit antwoord aangeeft dat een vernieuwingstaak wordt uitgevoerd. Alsmay-refresh-cache=falsedeze reactie alleen maar aangeeft dat de cache leeg is.400 Bad Request: Geeft aan dat er een fout is opgetreden met de aanvraag. Een bericht in het formaat van de Details van het Probleem (zie RFC 7807) verstrekt meer details.401 Unauthorized: geeft aan dat de aanvraag niet is geautoriseerd.500 Internal Server Error: Geeft aan dat er een interne serverfout is opgetreden. Een bericht in de indeling voor probleemdetails biedt meer informatie.503 Service Unavailable: Geeft aan dat de server bezig is met een andere respons en deze aanvraag niet tijdig kan uitvoeren. Dit gebeurt alleen bij synchrone aanvragen. Een bericht in de indeling voor probleemdetails biedt meer informatie.
Beheerdersinformatie
Aanpassing van levensduur cache cache-adjustment
De standaardlevensduur van de BPA-cache is 24 uur. Met de optie om een rapport te verfrissen, en het geheime voorgeheugen, in zowel de AEM instantie als de interface van HTTP te regenereren, zal deze standaardwaarde waarschijnlijk voor de meeste toepassingen van BPA aangewezen zijn. Als de tijd van de rapportgeneratie voor uw AEM instantie bijzonder lang is, kunt u het geheim voorgeheugenleven willen aanpassen om de regeneratie van het rapport te minimaliseren.
De langetermijnwaarde is opgeslagen als de eigenschap maxCacheAge op de volgende repository-node:/apps/best-practices-analyzer/content/BestPracticesReport/jcr:content
De waarde van deze eigenschap is de levensduur van de cache in seconden. Een beheerder kan de levensduur aanpassen met CRX/DE Lite.
Installeren op AEM 6.1 installing-on-aem61
BPA gebruikt een gebruikersaccount voor systeemservices met de naam repository-reader-service om de Patroondetector uit te voeren. Dit account is beschikbaar op AEM 6.2 en hoger. Op AEM 6.1, moet deze rekening voorafgaand aan installatie van BPA worden gecreeerd door de volgende stappen te nemen:
-
Volg de instructies bij het Nieuwe servicegebruiker maken om een gebruiker te maken. Stel de UserID in op
repository-reader-serviceen laat het tussenpad leeg en klik op het groene vinkje. -
Volg de instructies bij Gebruikers en groepen beheren, met name de instructies voor het toevoegen van gebruikers aan een groep om de
repository-reader-service-gebruiker aan de groepadministratorstoe te voegen. -
Installeer het BPA-pakket via Package Manager op de bron-AEM. (Dit zal de noodzakelijke configuratiewijziging toevoegen aan de ServiceUserMapper-configuratie voor de gebruiker van de
repository-reader-service-systeemservicegebruiker.)