Utilizzo di Best Practices Analyzer

Considerazioni importanti sull’utilizzo di Best Practices Analyzer

Leggi la sezione seguente per comprendere le considerazioni importanti sull’esecuzione di Best Practices Analyzer (BPA):

• Il rapporto BPA viene generato utilizzando l’output di Adobe Experience Manager (AEM) Rilevatore pattern. La versione del rilevatore pattern utilizzata da BPA è inclusa nel pacchetto di installazione BPA.

• BPA può essere eseguito solo da admin o un utente nella amministratori gruppo.

• BPA è supportato nelle istanze AEM con versione 6.1 e successive.

  NOTA

  Vedi Installazione in AEM 6.1 per l'installazione di BPA sulla AEM 6.1.

• BPA può essere eseguito su qualsiasi ambiente, ma è preferibile eseguirlo su un Stage ambiente.

  NOTA

  Per evitare un impatto sulle istanze business critical, si consiglia di eseguire BPA su un Autore ambiente il più vicino possibile Produzione ambiente nelle aree di personalizzazioni, configurazioni, contenuti e applicazioni utente. In alternativa, può essere eseguito su un clone dell’ambiente di authoring di produzione.

• La generazione dei contenuti dei rapporti BPA può richiedere molto tempo, da diversi minuti a poche ore. Il tempo richiesto dipende in larga misura dalle dimensioni e dalla natura del contenuto dell’archivio AEM, dalla versione di AEM e da altri fattori.

• A causa del tempo significativo che potrebbe essere necessario per generare il contenuto del rapporto, il processo avviene in background e viene mantenuto nella cache. La visualizzazione e il download del rapporto dovrebbero essere relativamente veloci poiché viene utilizzata la cache del contenuto fino alla scadenza o all’aggiornamento esplicito del rapporto. Durante la generazione del contenuto del rapporto puoi chiudere la scheda del browser e tornare in un secondo momento per visualizzare il rapporto una volta che il relativo contenuto è disponibile nella cache.

Disponibilità

È possibile scaricare Best Practices Analyzer come file zip dal portale di distribuzione software. Puoi installare il pacchetto tramite Gestione pacchetti sull’istanza Adobe Experience Manager (AEM) sorgente.

Visualizzazione del rapporto di Best practice Analyzer

Adobe Experience Manager 6.3.0 e versioni successive

Leggi questa sezione per scoprire come visualizzare il rapporto di Best Practices Analyzer (Analisi di best practice):

1. Seleziona Adobe Experience Manager e passa a Strumenti -> Operazioni -> Analisi delle best practice.

   

2. Fai clic su Genera report per eseguire Best Practices Analyzer.

   

3. Durante la generazione del rapporto da parte del BPA, puoi vedere lo stato di avanzamento dello strumento sullo schermo. Mostra il numero di elementi analizzati e mostra anche il numero di risultati rilevati.

   

4. Una volta generato il rapporto BPA, questo visualizza un riepilogo e il numero dei risultati in un formato tabulare organizzato in base al tipo di risultato e al livello di importanza. Per ottenere ulteriori dettagli su un particolare risultato, puoi fare clic sul numero corrispondente al tipo di risultato nella tabella.

   

   L’azione precedente scorre automaticamente fino alla posizione del risultato nel rapporto.

   

5. Puoi scaricare il rapporto in formato CSV facendo clic su Esportazione in formato CSV, come illustrato nella figura seguente.

   

   NOTA

   È possibile forzare il BPA a cancellare la cache e rigenerare il rapporto facendo clic su Aggiorna rapporto.

   

   NOTA

   Durante la rigenerazione del rapporto, mostra l’avanzamento in termini di percentuale completata come mostrato nell’immagine seguente.

   

Utilizzo dei filtri nel rapporto di Best practice Analyzer

Per filtrare i risultati relativi a ACS Commons, segui i passaggi seguenti:

1. Fai clic sull’icona della barra a sinistra sul lato sinistro della pagina. Verrà visualizzata la Filtro ACS Commons. Fai clic sul pulsante Filtro ACS Commons per visualizzare la casella di controllo interattiva, come illustrato nell'immagine seguente.

   

   NOTA

   L’icona della barra a sinistra viene visualizzata solo se il BPA rileva l’utilizzo di ACS Commons.

2. Deseleziona la casella per filtrare tutti i risultati relativi a ACS Commons. Dovresti visualizzare un Conteggio risultati filtrati nel rapporto, come illustrato nell’immagine seguente. Il filtro viene applicato anche al rapporto quando viene esportato in formato CSV.

   

   NOTA

   I risultati di ACS Commons non devono essere ignorati. Fai riferimento a documentazione per determinare la compatibilità con AEM as a Cloud Service.

Interpretazione del rapporto di Best Practices Analyzer

Quando lo strumento Best Practices Analyzer viene eseguito nell'istanza AEM, il rapporto viene visualizzato come risultato nella finestra dello strumento.

Il rapporto si presenta con questo formato:

• Panoramica rapporto: informazioni sul rapporto stesso, tra cui:
  • Data del rapporto: quando il contenuto del rapporto è stato generato e reso disponibile per la prima volta.
  • Data di scadenza: quando scade la cache del contenuto del rapporto.
  • Tempo di generazione: tempo impiegato dal processo di generazione del contenuto del rapporto.
  • Conteggio risultati: numero totale di risultati inclusi nel rapporto.
• Panoramica del sistema: Informazioni sul sistema AEM su cui è stato eseguito il BPA.
• Categorie dei risultati: diverse sezioni che riguardano ciascuna uno o più risultati della stessa categoria. Ogni sezione include quanto segue: nome della categoria, sottotipi, conteggio e importanza dei risultati, riepilogo, collegamento alla documentazione della categoria e informazioni su singoli risultati.

A ciascun risultato viene assegnato un livello di importanza per dare un’indicazione approssimativa del grado di priorità dell’intervento richiesto.

La tabella seguente descrive i livelli di importanza:

Interpretazione del rapporto CSV di Best Practices Analyzer

Quando fai clic sul pulsante CSV dall’istanza AEM, il formato CSV del rapporto Best Practices Analyzer (Analisi di best practice) viene creato dalla cache del contenuto e restituito al browser. A seconda delle impostazioni del browser, è possibile che venga scaricato automaticamente come file con il nome predefinito results.csv.

Se la cache è scaduta, il rapporto verrà generato nuovamente prima che il file CSV venga creato e scaricato.

Il formato CSV del rapporto include informazioni generate dall’output del rilevatore pattern, ordinate e organizzate per tipo di categoria, sottotipo e livello di importanza. Il formato è adatto alla visualizzazione e la modifica in un’applicazione come Microsoft Excel. È stato progettato per fornire tutte le informazioni sui risultati in un formato ripetibile che può essere utile quando si confrontano i rapporti nel tempo per misurare l’avanzamento.

Le colonne del rapporto in formato CSV sono:

• code (codice): codice della categoria
• type (tipo): nome della categoria
• subtype (sottotipo): sottotipo della categoria
• importance (importanza): livello di importanza
• identifier (identificatore): identificatore principale del risultato
• other (altro): ulteriori informazioni sul risultato
• message (messaggio): messaggio fornito per il risultato
• moreInfo (ulteriori informazioni): collegamento che consente di accedere alla sezione sulla categoria in oggetto nella guida online
• context (contesto): una stringa JSON contenente dati sul risultato

Un valore “\N” in una colonna di un singolo risultato indica che non sono stati forniti dati.

Interfaccia HTTP

Il BPA fornisce un’interfaccia HTTP che può essere utilizzata come alternativa all’interfaccia utente in AEM. L’interfaccia supporta sia i comandi HEAD che GET. Può essere utilizzato per generare il rapporto BPA e restituirlo in uno dei tre formati seguenti: Valori JSON, CSV e separati da tabulazioni (TSV).

I seguenti URL sono disponibili per l’accesso HTTP, dove <host> è il nome host e, se necessario, la porta del server in cui è installato il BPA:

• http://<host>/apps/best-practices-analyzer/analysis/report.json per il formato JSON
• http://<host>/apps/best-practices-analyzer/analysis/report.csv per il formato CSV
• http://<host>/apps/best-practices-analyzer/analysis/report.tsv per il formato TSV

Esecuzione di una richiesta HTTP

L’interfaccia HTTP può essere utilizzata in diversi modi.

Un modo semplice consiste nell’aprire una scheda del browser nello stesso browser in cui hai già effettuato l’accesso ad AEM come amministratore. Puoi inserire l’URL nella scheda del browser e visualizzare o scaricare i risultati dal browser.

Puoi inoltre utilizzare uno strumento della riga di comando, ad esempio curl o wget, nonché qualsiasi applicazione client HTTP. Se non utilizzi una scheda del browser con una sessione autenticata, devi fornire nel commento un nome utente e una password amministratore.

Il seguente è un esempio di come eseguire questa operazione:
curl -u admin:admin 'http://localhost:4502/apps/best-practices-analyzer/analysis/report.csv' > report.csv.

Intestazioni e parametri

Le seguenti intestazioni HTTP sono utilizzate da questa interfaccia:

• Cache-Control: max-age=<seconds>: Specifica l’intervallo di aggiornamento della cache in secondi. (consulta RFC 7234).
• Prefer: respond-async: Specifica che il server deve rispondere in modo asincrono. (consulta RFC 7240).
• Prefer: return=minimal: Specifica che il server deve restituire una risposta minima. (consulta RFC 7240).

I seguenti parametri di query HTTP sono disponibili per comodità nei casi in cui le intestazioni HTTP potrebbero non essere facilmente utilizzate:

• max-age (numero, facoltativo): Specifica l’intervallo di aggiornamento della cache in secondi. Questo numero deve essere maggiore o uguale a 0. L’intervallo di aggiornamento predefinito è di 86400 secondi. Senza questo parametro o l’intestazione corrispondente verrà utilizzata una nuova cache per servire le richieste per 24 ore, a cui deve essere rigenerata la cache. Utilizzo max-age=0 forza la cancellazione della cache e avvia una rigenerazione del rapporto, utilizzando l’intervallo di aggiornamento precedente diverso da zero per la cache appena generata.
• respond-async (booleano, facoltativo): Specifica che la risposta deve essere fornita in modo asincrono. Utilizzo respond-async=true quando la cache non è aggiornata, il server restituirà una risposta di 202 Accepted senza attendere l’aggiornamento della cache e la generazione del rapporto. Se la cache è aggiornata, questo parametro non ha alcun effetto. Il valore predefinito è false. Senza questo parametro o l'intestazione corrispondente il server risponderà in modo sincrono, il che potrebbe richiedere molto tempo e una regolazione del tempo di risposta massimo per il client HTTP.
• may-refresh-cache (booleano, facoltativo): Specifica che il server può aggiornare la cache in risposta a una richiesta se la cache corrente è vuota, obsoleta o presto obsoleta. Se may-refresh-cache=trueoppure, se non è specificato, il server potrebbe avviare un'attività in background che richiamerà il rilevatore pattern e aggiornerà la cache. Se may-refresh-cache=false il server non avvierà alcuna attività di aggiornamento che altrimenti sarebbe stata eseguita se la cache è vuota o obsoleta, nel qual caso il report sarà vuoto. Questo parametro non influisce sulle attività di aggiornamento già in corso.
• return-minimal (booleano, facoltativo): Specifica che la risposta dal server deve includere solo lo stato contenente l'indicazione di avanzamento e lo stato della cache nel formato JSON. Se return-minimal=true, il corpo della risposta sarà quindi limitato all'oggetto stato . Se return-minimal=falseoppure, se non è specificato, verrà fornita una risposta completa.
• log-findings (booleano, facoltativo): Specifica che il server deve registrare il contenuto della cache quando viene generato o aggiornato per la prima volta. Ogni risultato della cache verrà registrato come stringa JSON. Questa registrazione si verifica solo se log-findings=true e la richiesta genera una nuova cache.

Se sono presenti sia un’intestazione HTTP che il parametro di query corrispondente, il parametro di query avrà la priorità.

Un modo semplice per avviare la generazione del rapporto tramite l’interfaccia HTTP è l’utilizzo del seguente comando:
curl -u admin:admin 'http://localhost:4502/apps/best-practices-analyzer/analysis/report.json?max-age=0&respond-async=true'.

Una volta effettuata la richiesta, non c’è bisogno che il client rimanga attivo affinché venga generato il rapporto. La generazione del rapporto può essere avviata con un client utilizzando una richiesta HTTP GET e, una volta generato, può essere visualizzata dalla cache con un altro client o con lo strumento BPA nell’interfaccia utente AEM.

Risposte

Sono possibili i seguenti valori di risposta:

• 200 OK: Indica che la risposta contiene i risultati del rilevatore pattern generati nell’intervallo di aggiornamento della cache.
• 202 Accepted: Utilizzato per indicare che la cache non è aggiornata. Quando respond-async=true e may-refresh-cache=true questa risposta indica che è in corso un'attività di aggiornamento. Quando may-refresh-cache=false questa risposta indica semplicemente che la cache è obsoleta.
• 400 Bad Request: indica che la richiesta ha restituito un errore. Un messaggio nel formato Dettagli del problema (vedi RFC 7807) fornisce ulteriori dettagli.
• 401 Unauthorized: Indica che la richiesta non è stata autorizzata.
• 500 Internal Server Error: indica che si è verificato un errore interno del server. Un messaggio nel formato Dettagli del problema fornisce ulteriori dettagli.
• 503 Service Unavailable: indica che il server è occupato con un’altra risposta e non può soddisfare questa richiesta in modo tempestivo. È probabile che ciò si verifichi solo quando vengono effettuate richieste sincrone. Un messaggio nel formato Dettagli del problema fornisce ulteriori dettagli.

Informazioni per l’amministratore

Regolazione della durata della cache

La durata predefinita della cache BPA è di 24 ore. Con l’opzione per aggiornare un rapporto e rigenerare la cache, sia nell’istanza AEM che nell’interfaccia HTTP, è probabile che questo valore predefinito sia appropriato per la maggior parte degli usi del BPA. Se la generazione del rapporto richiede tempi particolarmente lunghi per la tua istanza di AEM, puoi regolare la durata della cache al fine di ridurre al minimo la rigenerazione del rapporto.

Il valore della durata della cache viene memorizzato come la proprietà maxCacheAge nel seguente nodo di archivio:
/apps/best-practices-analyzer/content/BestPracticesReport/jcr:content

Il valore di questa proprietà corrisponde alla durata della cache, in secondi. Un amministratore può regolare la durata della cache utilizzando CRX/DE Lite.

Installazione in AEM 6.1

BPA utilizza un account utente di servizio di sistema denominato repository-reader-service per eseguire il rilevatore pattern. Questo account è disponibile in AEM 6.2 e versioni successive. Al AEM 6.1, questo account deve essere creato prima installazione del BPA mediante le seguenti misure:

1. Per creare un utente segui le istruzioni in Creazione di un nuovo utente di servizio. Imposta UserID su repository-reader-service e lascia vuoto il Percorso intermedio, quindi fai clic sul segno di spunta verde.

2. Segui le istruzioni riportate nella sezione Gestione di utenti e gruppi, in particolare Aggiunta di utenti a un gruppo, per aggiungere l’utente repository-reader-service al gruppo administrators.

3. Installa il pacchetto BPA tramite Gestione pacchetti nell'istanza di AEM sorgente. Questa azione aggiunge la necessaria modifica alla configurazione ServiceUserMapper per l’utente di servizio del sistema repository-reader-service.)

Risorse Business.Adobe.com