Configurazione della verifica preliminare

Ultimo aggiornamento: 1 dicembre 2025

Per eseguire la verifica preliminare è necessario configurarla nell’ambiente di authoring. È possibile impostare la verifica preliminare per l’editor universale, l’authoring basato su documenti, l’editor pagina di AEM Sites o Adobe Managed Services, in modo da poter eseguire i controlli di verifica preliminare sulle pagine prima che vengano pubblicate.

Abilitare l’accesso degli utenti

Per utilizzare Verifica preliminare, accertati che l’utente sia assegnato ad almeno uno dei seguenti profili di prodotto AEM Sites Optimizer in Adobe Admin Console:

AEM Sites Optimizer - Suggerimento automatico utente
AEM Sites Optimizer - Ottimizzazione automatica utente

Abilita verifica preliminare

Editor universale

Per impostare la verifica preliminare nell’editor universale, segui questi passaggi:

Apri Extension Manager in:
https://experience.adobe.com/#/@org/aem/extension-manager/universal-editor
Individua l’estensione Verifica preliminare per AEM Sites Optimizer.
L’amministratore di sistema dell’organizzazione dovrà abilitare questa estensione.
Dopo aver abilitato l’estensione, apri una pagina nell’editor universale, ad esempio:
https://author-p12345-e123456.adobeaemcloud.com/ui#/@org/aem/universal-editor/canvas/author-p12345-e123456.adobeaemcloud.com/content/en/example/home.html
L’estensione Verifica preliminare viene visualizzata nella barra laterale.
Selezionare l’estensione Verifica preliminare dalla barra laterale per aprire Verifica preliminare per la pagina corrente.

Authoring basato su documenti

Per impostare la verifica preliminare per l’authoring basato su documenti, segui questi passaggi:

Aggiungi la seguente configurazione a /tools/sidekick/config.json nell’archivio GitHub del progetto Edge Delivery Services:

code language-json
`{ "plugins": [ { "id": "preflight", "titleI18n": { "en": "Preflight" }, "environments": ["preview"], "event": "preflight" } ] }`

Crea un nuovo file /tools/sidekick/aem-sites-optimizer-preflight.js e aggiungi il contenuto seguente:

code language-javascript

(function () {
  let isAEMSitesOptimizerPreflightAppLoaded = false;
  function loadAEMSitesOptimizerPreflightApp() {
    const script = document.createElement('script');
    script.src = 'https://experience.adobe.com/solutions/OneAdobe-aem-sites-optimizer-preflight-mfe/static-assets/resources/sidekick/client.js?source=plugin';
    script.onload = function () {
      isAEMSitesOptimizerPreflightAppLoaded = true;
    };
    script.onerror = function () {
      console.error('Error loading AEMSitesOptimizerPreflightApp.');
    };
    document.head.appendChild(script);
  }

  function handlePluginButtonClick() {
    if (!isAEMSitesOptimizerPreflightAppLoaded) {
      loadAEMSitesOptimizerPreflightApp();
    }
  }

  // Sidekick V1 extension support
  const sidekick = document.querySelector('helix-sidekick');
  if (sidekick) {
    sidekick.addEventListener('custom:preflight', handlePluginButtonClick);
  } else {
    document.addEventListener('sidekick-ready', () => {
      document.querySelector('helix-sidekick')
        .addEventListener('custom:preflight', handlePluginButtonClick);
    }, { once: true });
  }

  // Sidekick V2 extension support
  const sidekickV2 = document.querySelector('aem-sidekick');
  if (sidekickV2) {
    sidekickV2.addEventListener('custom:preflight', handlePluginButtonClick);
  } else {
    document.addEventListener('sidekick-ready', () => {
      document.querySelector('aem-sidekick')
        .addEventListener('custom:preflight', handlePluginButtonClick);
    }, { once: true });
  }
}());

Aggiorna la funzione loadLazy() in /scripts/scripts.js per importare lo script di verifica preliminare per gli URL di anteprima:

code language-javascript
`if (window.location.href.includes('.aem.page')) { import('../tools/sidekick/aem-sites-optimizer-preflight.js'); }`

Apri l’URL di anteprima (*.aem.page) della pagina di cui eseguire l’audit.
In Sidekick, fare clic sul pulsante Verifica preliminare per aprire Verifica preliminare per la pagina corrente.

Editor pagina per AEM Sites

Per utilizzare Verifica preliminare nell’editor di pagina di AEM Sites, puoi creare un bookmarklet nel browser web. Segui questi passaggi:

Mostra la Barra Segnalibri nel browser web:
- Premi Ctrl+Maiusc+B (Windows) o Comando+Maiusc+B (Mac).

Crea un nuovo segnalibro nel browser:

Fai clic con il pulsante destro del mouse sulla barra dei segnalibri e seleziona Nuova pagina o Aggiungi segnalibro.
Nel campo Indirizzo (URL), incolla il seguente codice:

code language-javascript

javascript:(function(){const script=document.createElement('script');script.src='https://experience.adobe.com/solutions/OneAdobe-aem-sites-optimizer-preflight-mfe/static-assets/resources/sidekick/client.js?source=bookmarklet&target-source=aem-cloud-service';document.head.appendChild(script);})();

Assegna al segnalibro il nome Verifica preliminare (o un nome qualsiasi).
Apri l’URL di anteprima (*.aem.page) della pagina di cui eseguire l’audit nell’Editor pagina per AEM Sites.
Fare clic sul segnalibro Verifica preliminare nella barra Segnalibri per aprire Verifica preliminare per la pagina corrente.

Adobe Managed Services

note important
IMPORTANT
Sono supportati solo gli ambienti Adobe Managed Services (AMS) che utilizzano il provider di identità di Adobe (IMS) per l’autenticazione in AEM Author. La verifica preliminare non funziona se l’organizzazione utilizza un altro provider di identità per l’autenticazione AMS.

Per utilizzare la verifica preliminare nell’Editor pagina di AEM Sites in un ambiente AMS, crea un bookmarklet nel browser web, seguendo la procedura riportata di seguito:

Mostra Barra Segnalibri nel browser web:
- Premi Ctrl+Maiusc+B (Windows) o Comando+Maiusc+B (Mac).

Crea un nuovo segnalibro nel browser:

Fai clic con il pulsante destro del mouse sulla barra dei segnalibri e seleziona Nuova pagina o Aggiungi segnalibro.
Nel campo Indirizzo (URL), incolla il seguente codice:

code language-javascript

javascript:(function(){const script=document.createElement('script');script.src='https://experience.adobe.com/solutions/OneAdobe-aem-sites-optimizer-preflight-mfe/static-assets/resources/sidekick/client.js?source=bookmarklet&target-source=ams';document.head.appendChild(script);})();

Assegna al segnalibro il nome Verifica preliminare (o un nome qualsiasi).
Apri la pagina di cui eseguire l’audit nell’Editor pagina per AEM Sites.
Fare clic sul segnalibro Verifica preliminare nella barra Segnalibri per aprire Verifica preliminare per la pagina corrente.

Best practice

Quando esegui gli audit di verifica preliminare, tieni presenti le seguenti linee guida:

Esegui sempre gli audit sulle pagine di staging o anteprima prima di pubblicarle in produzione.
Assegna priorità alla risoluzione di problemi ad alto impatto quali collegamenti interrotti, tag H1 mancanti o collegamenti non sicuri.
Prima di eseguire l’audit, verifica che l’autenticazione sia abilitata per gli ambienti di staging protetti.
Rivedi e applica consigli sui tag meta per migliorare le prestazioni SEO (Search Engine Optimization).

recommendation-more-help

experience-manager-sites-optimizer-help-main-toc