El exportador de páginas

AEM permite exportar una página como una página web completa que incluye imágenes, archivos .js y .css.

Una vez configurada la exportación, sólo tiene que solicitar una página en el explorador reemplazando html por export.zip en la dirección URL y obtener una descarga de archivo zip que contenga la página representada en formato html y los recursos a los que se hace referencia. Todas las rutas de la página, por ejemplo las rutas a las imágenes, se reescriben para que apunten a los archivos incluidos en el archivo zip o a los recursos del servidor.

Exportación de una página

Los siguientes pasos describen cómo exportar una página y suponen que existe una plantilla de configuración de exportación para el sitio. Una plantilla de configuración define la forma en que se exporta una página y es específica para su sitio. Para crear una plantilla de configuración, consulte la sección Creación de una configuración del exportador de páginas para su sitio.

Para exportar una página:

  1. En el explorador, abra la página. Por ejemplo:

  2. http://localhost:4502/content/geometrixx/en/products/triangle.html

  3. Abra el cuadro de diálogo de propiedades de página, seleccione la ficha Avanzado y expanda el conjunto de campos Exportar.

  4. Haga clic en el icono de lupa y seleccione una plantilla de configuración. Seleccione la plantilla geometrixx, ya que es la predeterminada para el sitio de Geometrixx. Haga clic en Aceptar.

  5. Haga clic en Aceptar para cerrar el cuadro de diálogo de propiedades de página.

  6. Solicite la página reemplazando html por export.zip en la dirección URL.

  7. Descargue el archivo <page-name>.export.zip en el sistema de archivos.

  8. En el sistema de archivos, descomprima el archivo:

    • el archivo HTML de la página ( <page-name>.html) está disponible a continuación <unzip-dir>/<page-path>
    • otros recursos (archivos .js, archivos .css, imágenes, etc.) se encuentran según la configuración de la plantilla de exportación. En este ejemplo, algunos recursos están por debajo de <unzip-dir>/etc, algunos por debajo de <unzip-dir>/<page-path>.

  9. Abra el archivo html de página ( <unzip-dir>/<page-path>.html) en el explorador para comprobar el procesamiento.

Creación de una configuración del exportador de páginas para su sitio

El exportador de páginas se basa en el marco de sincronización de contenido. Las configuraciones disponibles en el cuadro de diálogo de propiedades de página son plantillas de configuración. Definen todas las dependencias necesarias para una página. Cuando se activa una exportación de página, se utiliza la plantilla de configuración y tanto la ruta de página como la ruta de diseño se aplican de forma dinámica a la configuración. A continuación, el archivo zip se crea mediante la funcionalidad estándar de sincronización de contenido.

AEM incrusta algunas plantillas, entre las que se incluyen:

  • Una predeterminada en /etc/contentsync/templates/default. Esta plantilla:

    • Es la plantilla de reserva cuando no se encuentra ninguna plantilla de configuración en el repositorio.
    • Puede servir de base para una nueva plantilla de configuración.

  • Una que está dedicada al sitio Geometrixx, en /etc/contentsync/templates/geometrixx. Esta plantilla puede utilizarse como ejemplo para crear una nueva.

Para crear una plantilla de configuración de exportador de páginas:

  1. En CRXDE Lite, cree un nodo debajo de /etc/contentsync/templates:

    • Nombre: p. ej. mysite. El nombre aparece en el cuadro de diálogo de propiedades de página al elegir la plantilla del exportador de páginas.
    • Tipo: nt:unstructured

  2. Debajo del nodo de plantilla, llamado aquí mysite, cree una estructura de nodos utilizando los nodos de configuración que se describen a continuación.

Nodos de configuración del exportador de páginas

La plantilla de configuración consta de una estructura de nodos. Cada nodo tiene una propiedad type que define una acción específica en el proceso de creación del archivo zip. Para obtener más información sobre la propiedad type, consulte la sección Información general sobre los tipos de configuración en la página del marco de sincronización de contenido.

Se pueden utilizar los nodos siguientes para crear una plantilla de configuración de exportación:

page nodeEl nodo de página se utiliza para copiar el html de la página en el archivo zip. Tiene las características siguientes:

  • Es un nodo obligatorio.
  • Se encuentra por debajo de /etc/contentsync/templates/<sitename>.
  • Su nombre es page.
  • Su tipo de nodo es nt:unstructured

El nodo page tiene las siguientes propiedades:

  • Una propiedad type establecida con el valor pages.

  • No tiene una propiedad path ya que la ruta de la página actual se copia dinámicamente en la configuración.

  • Las demás propiedades se describen en la sección Información general sobre los tipos de configuración del marco de sincronización de contenido.

reescribir nodoEl nodo reescribir define cómo se reescriben los vínculos en la página exportada. Los vínculos reescritos pueden apuntar a los archivos incluidos en el archivo zip o a los recursos del servidor.

Consulte la página Sincronización de contenido para obtener una descripción completa del nodo rewrite.

nodo de diseñoEl nodo de diseño se utiliza para copiar el diseño utilizado para la página exportada. Tiene las características siguientes:

  • Es opcional.
  • Se encuentra por debajo de /etc/contentsync/templates/<sitename>.
  • Su nombre es design.
  • Su tipo de nodo es nt:unstructured.

El nodo design tiene las siguientes propiedades:

  • Una propiedad type establecida en el valor copy.

  • No tiene una propiedad path ya que la ruta de la página actual se copia dinámicamente en la configuración.

generic nodeUn nodo genérico se utiliza para copiar recursos como clientlibs.js o archivos .css en el archivo zip. Tiene las características siguientes:

  • Es opcional.
  • Se encuentra por debajo de /etc/contentsync/templates/<sitename>.
  • No tiene un nombre específico.
  • Su tipo de nodo es nt:unstructured.
  • Tiene una propiedad type y cualquier propiedad type relacionada, tal como se define en la sección Información general de los tipos de configuración del marco de sincronización de contenido.

Por ejemplo, el siguiente nodo de configuración copia los archivos geometrixx clientlibs.js en el archivo zip:

"geometrixx.clientlibs.js": {
    "extension": "js",
    "type": "clientlib",
    "path": "/etc/designs/geometrixx/clientlibs",
    "jcr:primaryType": "nt:unstructured"
}

La plantilla de configuración de exportación de página Geometrixx muestra cómo se puede configurar una exportación de página. Para vista de la estructura de nodos de la plantilla en el navegador como formato json, solicite la siguiente URL:

http://localhost:4502/etc/contentsync/templates/geometrixx.-1.json

Implementación de una configuración personalizada

Como puede haber notado en la estructura de nodos, la plantilla de configuración de exportación de página Geometrixx tiene un nodo logo con una propiedad type establecida en image. Se trata de un tipo de configuración especial que se ha creado para copiar el logotipo de la imagen en el archivo zip. Para cumplir algunos requisitos específicos, es posible que tenga que implementar una propiedad type personalizada: para ello, consulte la sección Implementación de un controlador de actualización personalizado en la página Sincronización de contenido.

Exportación programada de una página

Para exportar una página mediante programación, puede utilizar el servicio OSGI PageExporter. Este servicio le permite:

  • Exporte una página y escriba en la respuesta del servlet HTTP.
  • Exporte una página y guarde el archivo zip en una ubicación específica.

El servlet que está enlazado al selector export y la extensión zip utiliza el servicio PageExporter.

Solución de problemas

Si experimenta un problema con la descarga del archivo zip, puede eliminar el nodo /var/contentsync en el repositorio y volver a enviar la solicitud de exportación.

En esta página