De pagina-exportfunctie the-page-exporter
Met Adobe Experience Manager (AEM) kunt u een pagina exporteren als een volledige webpagina, inclusief afbeeldingen, .js - en .css -bestanden.
Wanneer dit 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.
- een archiefbestand (
<page-name>.export.zip) - een map (
<page-name>); het archiefbestand is al uitgevouwen
Pagina's exporteren exporting-a-page
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, zie Creërend een Configuratie van de Exporteur van de Pagina voor uw Plaats .
Een pagina exporteren:
-
Navigeer aan de vereiste pagina in de console van Plaatsen.
-
Selecteer de pagina, dan open de dialoog van Eigenschappen.
-
Selecteer het Geavanceerde lusje.
-
Vouw het gebied van de Uitvoer uit om een uitvoermalplaatje te selecteren.
Selecteer het vereiste malplaatje voor uw plaats, dan bevestig met O.K.. -
Selecteer sparen & dicht om de dialoog van de pagina eigenschappen te sluiten.
-
Vraag de pagina voor export aan en vervang het achtervoegsel
htmldoorexport.zipin de URL.Bijvoorbeeld:
- localhost:4502/content/we-retail/language-masters/en.html
Wordt benaderd door:
- localhost:4502/content/we-retail/language-masters/en.export.zip
-
Download het archiefbestand naar uw bestandssysteem.
-
Pak het bestand desgewenst uit in uw bestandssysteem. Als deze is uitgevouwen, ziet u een map met dezelfde naam als de geselecteerde pagina. Deze map bevat:
-
de submap
content, de hoofdmap 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)
- binnen deze structuur is er het HTML-bestand voor de geselecteerde pagina (
-
andere bronnen (
.jsbestanden,.cssbestanden, afbeeldingen, enzovoort) bevinden zich volgens de instellingen in de exportsjabloon
-
-
Open het pagina-HTML-bestand (
<unzip-dir>/<path>/<to>/<page>/<page-path>.html) in uw browser zodat u de rendering kunt controleren.
Een configuratie voor paginaexportters maken voor uw site creating-a-page-exporter-configuration-for-your-site
De paginaexporteur is gebaseerd op het kader van de Synchronisatie van de Inhoud . De configuraties die in de dialoog van de Eigenschappen van de Pagina beschikbaar zijn zijn de uitvoermalplaatjes die de vereiste gebiedsdelen voor een pagina bepalen.
Wanneer het exporteren van een pagina wordt geactiveerd, wordt naar de exportsjabloon verwezen. Zowel het paginapad als het ontwerppad worden dynamisch toegepast. Het ZIP-bestand wordt vervolgens gemaakt met de standaardfunctionaliteit voor het synchroniseren van inhoud.
Een installatie buiten de AEM bevat een standaardsjabloon onder /etc/contentsync/templates/default .
-
Deze sjabloon is de fallback-sjabloon wanneer er geen exportsjabloon wordt gevonden in de repository.
-
De sjabloon
defaultlaat zien hoe een pagina-export kan worden geconfigureerd, zodat deze als basis kan dienen voor een nieuwe exportsjabloon. -
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 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:
-
In CRXDE Lite, creeer een knoop 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
-
-
Onder het sjabloonknooppunt, dat hier
mysitewordt genoemd, maakt u een knooppuntstructuur met behulp van de hieronder beschreven configuratieknooppunten.
Een paginamarittersjabloon activeren voor uw pagina's activating-a-page-exporter-configuration-for-your-pages
Wanneer uw malplaatje wordt gevormd, maak het beschikbaar:
-
Navigeer in CRXDE naar de vereiste pagina in de
/contentvertakking. Dit kan een afzonderlijke pagina zijn, of de basispagina van een substructuur. -
Maak de eigenschap op het knooppunt
jcr:contentvan de pagina:Name:cq:exportTemplateType:StringValue: pad naar de sjabloon, bijvoorbeeld:/etc/contentsync/templates/mysite
Configuratieknooppunten van pagina-exporteur page-exporter-configuration-nodes
Het malplaatje bestaat uit een knoopstructuur, aangezien het het kader van de Synchronisatie van de Inhoud 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 pagina html aan het ZIP dossier te kopiëren. Het heeft de volgende kenmerken:- Een verplicht knooppunt.
- Onder
/etc/contentsync/templates/<mysite>weergegeven. - Gedefinieerd met de eigenschap
Nameingesteld oppage. - Het knooppunttype is
nt:unstructured
Het knooppunt
pageheeft de volgende eigenschappen:-
Een eigenschap
typeingesteld met de waardepages. -
De eigenschap heeft geen eigenschap
pathomdat het huidige paginapad dynamisch naar 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:- Optioneel.
- Onder
/etc/contentsync/templates/<mysite>weergegeven. - Gedefinieerd met de eigenschap
Nameingesteld opdesign. - Het knooppunttype is
nt:unstructured.
Het knooppunt
designheeft de volgende eigenschappen:-
Een eigenschap
typeingesteld op de waardecopy. -
De eigenschap heeft geen eigenschap
pathomdat het huidige paginapad dynamisch naar de configuratie wordt gekopieerd.
-
generic
Een algemeen knooppunt wordt gebruikt om bronnen zoals clientlibs.js- of.css-bestanden naar het ZIP-bestand te kopiëren. Het heeft de volgende kenmerken:- Optioneel.
- Onder
/etc/contentsync/templates/<mysite>weergegeven. - Geen specifieke naam.
- Het knooppunttype is
nt:unstructured. - Heeft een eigenschap
typeentypeverwante eigenschappen.
Het volgende configuratieknooppunt kopieert bijvoorbeeld de
mysite.clientlibs.js-bestanden naar het ZIP-bestand:code language-xml "mysite.clientlibs.js": { "extension": "js", "type": "clientlib", "path": "/etc/designs/mysite/clientlibs", "jcr:primaryType": "nt:unstructured" }
Uitvoerend een Configuratie van de Douane
Aangepaste configuraties zijn ook mogelijk.
Om aan sommige specifieke vereisten te voldoen, voer de manager van de a douaneverupdate uit.
Pagina's programmatisch exporteren programmatically-exporting-a-page
Om een pagina programmatically uit te voeren, kunt u de PageExporter dienst gebruiken OSGI. 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 de export selecteur en de zip uitbreiding is gebonden gebruikt de dienst PageExporter.
Problemen oplossen troubleshooting
Als er een probleem optreedt met het downloaden van het ZIP-bestand, kunt u het knooppunt /var/contentsync in de gegevensopslagruimte verwijderen en de exportaanvraag opnieuw verzenden.