De pagina-exportfunctie

AEM kunt u een pagina exporteren als een volledige webpagina met afbeeldingen, .js- en .css-bestanden.

Nadat de configuratie is geconfigureerd, vraagt u een pagina-export vanuit uw browser door html te vervangen door export.zip in de URL. Hiermee wordt een archiefbestand (zip) gegenereerd dat de weergegeven pagina in HTML-indeling bevat, samen met de elementen waarnaar wordt verwezen. Alle paden op de pagina (bijvoorbeeld paden naar afbeeldingen) worden herschreven zodat ze verwijzen naar de bestanden die in het archief zijn opgenomen of naar de bronnen op de server. Het archiefbestand (zip) kan vervolgens vanuit uw browser worden gedownload.

OPMERKING

Afhankelijk van uw browser en de instellingen is de download:

  • een archiefbestand (<page-name>.export.zip)
  • een map (<page-name>); het archiefbestand is al uitgebreid

Een pagina exporteren

In de volgende stappen wordt beschreven hoe u een pagina exporteert en wordt ervan uitgegaan dat er een exportsjabloon voor uw site bestaat. Een exportsjabloon definieert de manier waarop een pagina wordt geëxporteerd en is specifiek voor uw site. Om een uitvoermalplaatje tot stand te brengen verwijs naar Creërend een Configuratie van de Exporter van de Pagina voor uw Plaats sectie.

Een pagina exporteren:

  1. Navigeer naar de vereiste pagina in de console Sites.

  2. Selecteer de pagina en open vervolgens het dialoogvenster Eigenschappen.

  3. Selecteer het tabblad Geavanceerd.

  4. Vouw het veld Exporteren uit om een exportsjabloon te selecteren.
    Selecteer de vereiste sjabloon voor uw site en bevestig vervolgens met OK.

  5. Selecteer Opslaan en sluiten om het dialoogvenster Pagina-eigenschappen te sluiten.

  6. Vraag de pagina voor export aan en vervang het achtervoegsel html door export.zip in de URL.

    Bijvoorbeeld:

    • localhost:4502/content/we-retail/language-masters/en.html

    Wordt benaderd via:

    • localhost:4502/content/we-retail/language-masters/en.export.zip
  7. Download het archiefbestand naar uw bestandssysteem.

  8. Pak het bestand desgewenst uit in uw bestandssysteem. Nadat de map is uitgevouwen, krijgt deze dezelfde naam als de geselecteerde pagina. Deze map bevat:

    • de submap content, die de basis is van een reeks submappen die het pad naar de pagina in de opslagplaats weerspiegelen

      • binnen deze structuur is er het HTML-bestand voor de geselecteerde pagina (<page-name>.html)
    • andere bronnen (.js bestanden, .css bestanden, afbeeldingen, enz.) worden geplaatst volgens de instellingen in de exportsjabloon

  9. Open het pagina-HTML-bestand (<unzip-dir>/<path>/<to>/<page>/<page-path>.html) in uw browser om de rendering te controleren.

Een configuratie voor paginaexportters maken voor uw site

De pagina-exportfunctie is gebaseerd op het Content Sync framework. De configuraties die beschikbaar zijn in het dialoogvenster Pagina-eigenschappen zijn exportsjablonen die de vereiste afhankelijkheden voor een pagina definiëren.

Wanneer een pagina-export wordt geactiveerd, wordt naar de exportsjabloon verwezen en worden zowel het paginapad als het ontwerppad dynamisch toegepast. Het ZIP-bestand wordt vervolgens gemaakt met de standaardfunctionaliteit voor het synchroniseren van inhoud.

Een uit-van-de-doos AEM installatie omvat een standaardmalplaatje onder /etc/contentsync/templates/default.

  • Deze sjabloon is de fallback-sjabloon wanneer er geen exportsjabloon wordt gevonden in de repository.

  • Het default malplaatje toont u hoe een paginauitvoer kan worden gevormd, zodat kan als basis voor een nieuw de uitvoermalplaatje dienen.

  • Als u de knooppuntstructuur van de sjabloon in uw browser wilt weergeven als JSON-indeling, vraagt u de volgende URL op:
    http://localhost:4502/etc/contentsync/templates/default.json

De eenvoudigste methode om een nieuwe sjabloon voor het exporteren van pagina's te maken is:

  • de default-sjabloon kopiëren,

  • een nieuwe naam toewijzen die geschikt is voor uw site;

  • Voer vervolgens de vereiste updates uit.

Een volledig nieuwe sjabloon maken:

  1. Maak in CRXDE Lite een knooppunt onder /etc/contentsync/templates:

    • Name: een naam die geschikt is voor uw site; bijvoorbeeld <mysite>. De naam wordt weergegeven in het dialoogvenster Pagina-eigenschappen wanneer u de sjabloon voor het exporteren van pagina's kiest.

    • Type: nt:unstructured

  2. Onder de malplaatjeknoop, genoemd hier mysite, creeer een knoopstructuur gebruikend de hieronder beschreven configuratieknopen.

Een sjabloon voor pagina-exportters activeren voor uw pagina's

Zodra uw malplaatje is gevormd moet u het ter beschikking stellen:

  1. Navigeer in CRXDE naar de vereiste pagina in de /content vertakking. Dit kan een afzonderlijke pagina zijn, of de hoofdpagina van een substructuur.

  2. Maak de eigenschap op het knooppunt jcr:content van de pagina:

    • Name: cq:exportTemplate
    • Type: String
    • Value: pad naar de sjabloon; bijvoorbeeld: /etc/contentsync/templates/mysite

Configuratieknooppunten van pagina-exportter

De sjabloon bestaat uit een knooppuntstructuur, aangezien deze het Content Sync framework gebruikt. Elk knooppunt heeft een eigenschap type die een specifieke handeling definieert in het aanmaakproces van het ZIP-bestand.

De volgende knooppunten kunnen worden gebruikt om een exportsjabloon te maken:

  • page
    Het paginaknooppunt wordt gebruikt om de pagina-html naar het ZIP-bestand te kopiëren. Het heeft de volgende kenmerken:

    • Is een verplicht knooppunt.
    • Wordt onder /etc/contentsync/templates/<mysite> geplaatst.
    • Wordt gedefinieerd met de eigenschap Nameingesteld op page.
    • Het knooppunttype is nt:unstructured

    Het knooppunt page heeft de volgende eigenschappen:

    • Een eigenschap type ingesteld met de waarde pages.

    • Het heeft geen path bezit aangezien het huidige paginapad dynamisch aan de configuratie wordt gekopieerd.

  • rewrite
    Het knooppunt rewrite definieert hoe de koppelingen in de geëxporteerde pagina worden herschreven. De herschreven koppelingen kunnen verwijzen naar de bestanden in het ZIP-bestand of naar de bronnen op de server.

  • design
    Het ontwerpknooppunt wordt gebruikt om het ontwerp te kopiëren dat voor de geëxporteerde pagina wordt gebruikt. Het heeft de volgende kenmerken:

    • Is optioneel.
    • Wordt onder /etc/contentsync/templates/<mysite> geplaatst.
    • Wordt gedefinieerd met de eigenschap Name ingesteld op design.
    • Het knooppunttype is nt:unstructured.

    Het knooppunt design heeft de volgende eigenschappen:

    • Een eigenschap type ingesteld op de waarde copy.

    • Het heeft geen path bezit, aangezien het huidige paginadad dynamisch aan de configuratie wordt gekopieerd.

  • generic
    Een generisch knooppunt wordt gebruikt om bronnen als clientlibs te kopiëren
    .js of .css bestanden naar het ZIP-bestand. Het heeft de volgende kenmerken:

    • Is optioneel.
    • Wordt onder /etc/contentsync/templates/<mysite> geplaatst.
    • Heeft geen specifieke naam.
    • Het knooppunttype is nt:unstructured.
    • Heeft een type eigenschap en type gerelateerde eigenschappen.

    Met het volgende configuratieknooppunt worden bijvoorbeeld de mysite.clientlibs.js-bestanden naar het ZIP-bestand gekopieerd:

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

Een aangepaste configuratie implementeren

Aangepaste configuraties zijn ook mogelijk.

Om aan sommige specifieke vereisten te voldoen, kunt u douane updatemanager moeten uitvoeren.

Een pagina programmatisch exporteren

Als u een pagina programmatisch wilt exporteren, kunt u de service PageExporter OSGI gebruiken. Met deze service kunt u:

  • Exporteer een pagina en schrijf naar de HTTP-servletreactie.
  • Exporteer een pagina en sla het ZIP-bestand op een specifieke locatie op.

De servlet die aan export selecteur en zip uitbreiding verbindt gebruikt de dienst PageExporter.

Problemen oplossen

Als er een probleem optreedt met het downloaden van het ZIP-bestand, kunt u het /var/contentsync-knooppunt in de gegevensopslagruimte verwijderen en het exportverzoek opnieuw verzenden.

Op deze pagina