De pagina-exportfunctie

LET OP

AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

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

Nadat het exporteren is geconfigureerd, vraagt u eenvoudig een pagina in uw browser door html with export.zip in de URL en u krijgt een gecomprimeerde bestandsdownload met de weergegeven pagina in HTML-indeling en de bestanden waarnaar wordt verwezen. Alle paden op de pagina, bijvoorbeeld paden naar afbeeldingen, worden herschreven zodat ze verwijzen naar de bestanden in het ZIP-bestand of naar de bronnen op de server.

Een pagina exporteren

De volgende stappen beschrijven hoe te om een pagina uit te voeren, en veronderstellen dat een malplaatje van de de uitvoerconfiguratie voor uw plaats bestaat. Een configuratiesjabloon definieert de manier waarop een pagina wordt geëxporteerd en is specifiek voor uw site. Als u een configuratiesjabloon wilt maken, raadpleegt u de Een configuratie voor paginaexportters maken voor uw site sectie.

Een pagina exporteren:

Open de pagina in uw browser. Bijvoorbeeld:
http://localhost:4502/content/geometrixx/en/products/triangle.html
Open het dialoogvenster met pagina-eigenschappen en selecteer het dialoogvenster Geavanceerd en breid het Exporteren veldset.
Klik op het vergrootpictogram en selecteer een configuratiesjabloon. Selecteer geometrixx sjabloon, omdat dit de standaardsjabloon voor de site Geometrixx is. Klikken OK.
Klikken OK om het dialoogvenster Pagina-eigenschappen te sluiten.
Vraag de pagina aan door html with export.zip in de URL.
Download de <page-name>.export.zip naar uw bestandssysteem.
Pak in uw bestandssysteem het bestand uit:
- het HTML-bestand van de pagina ( <page-name>.html) is hieronder beschikbaar <unzip-dir>/<page-path>
- andere bronnen (.js-bestanden, .css-bestanden, afbeeldingen, …) bevinden zich volgens de instellingen in de exportsjabloon. In dit voorbeeld worden enkele bronnen hieronder weergegeven <unzip-dir>/etc, enkele hieronder <unzip-dir>/<page-path>.
Open het HTML-bestand van de pagina ( <unzip-dir>/<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 configuratiesjablonen. Zij bepalen alle vereiste gebiedsdelen voor een pagina. Wanneer een paginauitvoer wordt teweeggebracht, wordt het configuratiesjabloon gebruikt en zowel de paginadad als de ontwerppad dynamisch toegepast op de configuratie. Het ZIP-bestand wordt vervolgens gemaakt met de standaardfunctionaliteit voor het synchroniseren van inhoud.

AEM sluit een aantal sjablonen in, waaronder:

Een standaardinstelling bij /etc/contentsync/templates/default. Deze sjabloon:
- Is het fallback malplaatje wanneer geen configuratiemalplaatje in de bewaarplaats wordt gevonden.
- Kan als basis voor een nieuw configuratiesjabloon dienen.
Een die gewijd is aan de Geometrixx plaats, op /etc/contentsync/templates/geometrixx. Deze sjabloon kan als voorbeeld worden gebruikt om een nieuwe sjabloon te maken.

Een configuratiesjabloon voor een pagina-exportfunctie maken:

In CRXDE Lite, maak hieronder een knooppunt /etc/contentsync/templates:
- Naam: bijv. mysite. De naam wordt weergegeven in het dialoogvenster Pagina-eigenschappen wanneer u de sjabloon voor het exporteren van pagina's kiest.
- Type: nt:unstructured
Onder het sjabloonknooppunt dat hier wordt aangeroepen mysite, maakt u een knooppuntstructuur met de hieronder beschreven configuratieknooppunten.

Configuratieknooppunten van pagina-exportfunctie

Het configuratiesjabloon bestaat uit een nodestructuur. Elk knooppunt heeft een type eigenschap die een specifieke handeling definieert in het aanmaakproces van het ZIP-bestand. Voor meer details over het typebezit, verwijs naar het Overzicht van configuratietypes in de het kaderpagina van de Synchronisatie van de Inhoud.

De volgende knopen kunnen worden gebruikt om een malplaatje van de de uitvoerconfiguratie te bouwen:

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

Is een verplicht knooppunt.
bevindt zich hieronder /etc/contentsync/templates/<sitename>.
De naam is page.
Het knooppunttype is nt:unstructured

De page node heeft de volgende eigenschappen:

A type eigenschap ingesteld met de waarde pages.
Het heeft geen path eigenschap als het huidige paginapad dynamisch naar de configuratie gekopieerd.
De andere eigenschappen worden beschreven in het gedeelte Overzicht van configuratietypen van het Content Sync-framework.

knooppunt herschrijven 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.

Raadpleeg de pagina Content Sync voor een volledige beschrijving van de rewrite knooppunt.

ontwerpknooppunt 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.
bevindt zich hieronder /etc/contentsync/templates/<sitename>.
De naam is design.
Het knooppunttype is nt:unstructured.

De design node heeft de volgende eigenschappen:

A type eigenschap ingesteld op de waarde copy.
Het heeft geen path eigenschap als het huidige paginapad dynamisch naar de configuratie gekopieerd.

algemeen knooppunt Een generisch knooppunt wordt gebruikt om bronnen zoals client-libs .js- of .css-bestanden naar het ZIP-bestand te kopiëren. Het heeft de volgende kenmerken:

Is optioneel.
bevindt zich hieronder /etc/contentsync/templates/<sitename>.
Heeft geen specifieke naam.
Het knooppunttype is nt:unstructured.
Heeft een type en alle type verwante eigenschappen zoals gedefinieerd in het gedeelte Overzicht van configuratietypen van het Content Sync-framework.

Met het volgende configuratieknooppunt kopieert u bijvoorbeeld de bestanden geometrixx client.js naar het ZIP-bestand:

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

De Geometrixx het malplaatje van de de configuratieconfiguratie van de paginauitvoer toont u hoe een paginauitvoer kan worden gevormd. Als u de knooppuntstructuur van de sjabloon in uw browser wilt weergeven als een JPEG-indeling, vraagt u om de volgende URL:

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

Een aangepaste configuratie implementeren

Aangezien u in de knoopstructuur kunt opgemerkt, Geometrixx pagina-exportconfiguratiesjabloon heeft een logo knooppunt met een type eigenschap ingesteld op image. Dit is een speciaal configuratietype dat is gemaakt om het afbeeldingslogo naar het ZIP-bestand te kopiëren. Om aan sommige specifieke vereisten te voldoen, kunt u een douane moeten uitvoeren type eigenschap: Raadpleeg hiervoor de sectie Een aangepaste update-handler implementeren in de pagina Content Sync.

Een pagina programmatisch exporteren

Als u een pagina programmatisch wilt exporteren, kunt u de opdracht PageExporter OSGI-dienst. 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 en de zip gebruikt de PageExporter-service.

Problemen oplossen

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