Configuración de Preflight

La ejecución de la comprobación preliminar requiere su configuración en el entorno de creación. Puede configurar Comprobaciones para el editor universal, la creación basada en documentos, el editor de páginas de AEM Sites o Adobe Managed Services, de modo que pueda ejecutar las auditorías de comprobaciones en sus páginas antes de publicarlas.

Habilitar el acceso de los usuarios

Para usar la comprobación preliminar, asegúrate de que el usuario esté asignado al menos a uno de los siguientes perfiles de producto de AEM Sites Optimizer en Adobe Admin Console:

  • AEM Sites Optimizer: sugerencia automática de usuario
  • AEM Sites Optimizer: optimización automática del usuario

Activar comprobación preliminar

Editor universal

Para configurar la comprobación preliminar en el editor universal, siga estos pasos:

  1. Abra Extension Manager en:
    https://experience.adobe.com/#/@org/aem/extension-manager/universal-editor
  2. Localice la extensión Comprobación preliminar de AEM Sites Optimizer.
  3. El administrador del sistema de la organización deberá habilitar esta extensión.
  4. Una vez habilitada la extensión, abra una página en el Editor universal, por ejemplo:
    https://author-p12345-e123456.adobeaemcloud.com/ui#/@org/aem/universal-editor/canvas/author-p12345-e123456.adobeaemcloud.com/content/en/example/home.html
  5. La extensión Preflight aparece en el carril lateral.
  6. Seleccione la extensión de comprobación preliminar del carril lateral para abrir Comprobación preliminar de la página actual.
Creación basada en documentos

Para configurar la comprobación preliminar para la creación basada en documentos, siga estos pasos:

  1. Añada la siguiente configuración a /tools/sidekick/config.json en el repositorio de GitHub de su proyecto de Edge Delivery Services:

    code language-json
    {
      "plugins": [
        {
          "id": "preflight",
          "titleI18n": {
            "en": "Preflight"
          },
          "environments": ["preview"],
          "event": "preflight"
        }
      ]
    }
    
  2. Cree un nuevo archivo /tools/sidekick/aem-sites-optimizer-preflight.js y añada el siguiente contenido:

    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 });
      }
    }());
    
  3. Actualice la función loadLazy() en /scripts/scripts.js para importar el script de comprobación preliminar para las direcciones URL de vista previa:

    code language-javascript
    if (window.location.href.includes('.aem.page')) {
       import('../tools/sidekick/aem-sites-optimizer-preflight.js');
    }
    
  4. Abra la dirección URL de vista previa (*.aem.page) de la página que desea auditar.

  5. En Sidekick, haga clic en el botón Comprobación preliminar para abrir Comprobación preliminar de la página actual.

Editor de página de AEM Sites

Si su entorno de creación ejecuta AEM 2026.7.0 (versión 27083) o posterior, la comprobación preliminar está integrada en el editor de páginas de AEM Sites y no se requiere ningún bookmarklet. Siga estos pasos:

  1. Abra la página que desee auditar en el Editor de páginas de AEM Sites.

  2. En la barra de herramientas del editor, seleccione el icono Comprobación preliminar (el botón de reproducción, resaltado abajo) para abrir el panel Comprobación preliminar de la página actual.

    Icono de comprobación preliminar en la barra de herramientas del Editor de páginas de AEM Sites {align="center"}

note
NOTE
¿No ves el icono Comprobaciones en la barra de herramientas? Compruebe lo siguiente:
  • Versión compatible: el botón integrado requiere AEM 2026.7.0 (versión 27083) o posterior. En versiones anteriores, utilice el método bookmarklet que aparece a continuación.
  • Despliegue: el botón integrado se está habilitando para organizaciones por fases, por lo que es posible que aún no haya llegado a su organización, incluso en una versión compatible. Hasta que lo haga, utilice el método bookmarklet que aparece a continuación o póngase en contacto con Adobe o su administrador.
  • Acceso a la página: el botón solo aparece cuando tiene acceso de edición a la página.
  • Acceso de usuario: confirma que tu usuario tiene asignado el perfil AEM Sites Optimizer - Sugerencia automática del usuario o AEM Sites Optimizer - Optimización automática del usuario. Consulte Habilitar acceso de usuario.

Para utilizar la comprobación preliminar en el editor de páginas de AEM Sites en versiones anteriores de AEM, puede crear un bookmarklet en el explorador web. Siga estos pasos:

  1. Muestre la Barra de marcadores en el explorador web:

    • Pulse Ctrl+Mayús+B (Windows) o Cmd+Mayús+B (Mac).
  2. Cree un nuevo marcador en el explorador:

    • Haga clic con el botón derecho en la barra de marcadores y seleccione Nueva página o Añadir marcador.
    • En el campo Dirección (URL), pegue el siguiente código:
    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);})();
    
  3. Asigne un nombre al marcador Comprobación preliminar (o cualquier nombre que prefiera).

  4. Abra la dirección URL de vista previa (*.aem.page) de la página que desea auditar en el Editor de páginas de AEM Sites.

  5. Haga clic en el marcador Comprobaciones de la barra de marcadores para abrir Comprobaciones de la página actual.

Adobe Managed Services
note important
IMPORTANT
Solo se admiten los entornos de Adobe Managed Services (AMS) que utilizan el proveedor de identidad (IMS) de Adobe para la autenticación en AEM Author. Preflight (comprobación preliminar) no funciona si su organización utiliza cualquier otro proveedor de identidad para la autenticación AMS.

Para utilizar la comprobación preliminar en el editor de páginas de AEM Sites en un entorno de AMS, cree un bookmarklet en el explorador web, siguiendo estos pasos:

  1. Muestre la Barra de marcadores en el explorador web:

    • Pulse Ctrl+Mayús+B (Windows) o Cmd+Mayús+B (Mac).
  2. Cree un nuevo marcador en el explorador:

    • Haga clic con el botón derecho en la barra de marcadores y seleccione Nueva página o Añadir marcador.
    • En el campo Dirección (URL), pegue el siguiente código:
    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);})();
    
  3. Asigne un nombre al marcador Comprobación preliminar (o cualquier nombre que prefiera).

  4. Abra la página que desee auditar en el Editor de páginas de AEM Sites.

  5. Haga clic en el marcador Comprobaciones de la barra de marcadores para abrir Comprobaciones de la página actual.

Prácticas recomendadas

Cuando ejecute auditorías de comprobaciones preliminares, tenga en cuenta las siguientes directrices:

  • Ejecute siempre auditorías en páginas de ensayo o vista previa antes de publicar en producción.
  • Priorice la resolución de problemas de alto impacto, como vínculos rotos, etiquetas H1 que faltan o vínculos no seguros.
  • Asegúrese de que la autenticación esté habilitada para los entornos de ensayo protegidos antes de ejecutar auditorías.
  • Revise y aplique recomendaciones de etiquetas meta para mejorar el rendimiento de SEO.
recommendation-more-help
experience-manager-sites-optimizer-help-main-toc