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.
Indien geconfigureerd, vraagt u een paginaexport van uw browser door html
with 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. Als u een exportsjabloon wilt maken, raadpleegt u Een configuratie voor paginaexportters maken voor uw site.
Een pagina exporteren:
-
Ga naar de gewenste pagina in het dialoogvenster Sites console.
-
Selecteer de pagina en open vervolgens de knop Eigenschappen in.
-
Selecteer de Geavanceerd tab.
-
Breid uit Exporteren te selecteren.
Selecteer de vereiste sjabloon voor uw site en bevestig vervolgens met OK. -
Selecteren Opslaan en sluiten om het dialoogvenster Pagina-eigenschappen te sluiten.
-
De pagina voor export aanvragen en het achtervoegsel vervangen
html
withexport.zip
in 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 basis 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 (
-
overige middelen (
.js
bestanden,.css
bestanden, afbeeldingen, enzovoort) bevinden zich volgens de instellingen in de exportsjabloon
-
-
Open het HTML-bestand van de pagina (
<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 pagina-exportfunctie is gebaseerd op de Content Sync-framework. De configuraties die in Pagina-eigenschappen dialoogvensters zijn exportsjablonen die de vereiste afhankelijkheden voor een pagina definiëren.
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 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.
-
De
default
het 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 sjabloon voor het exporteren van pagina's te maken is:
-
kopieer de
default
sjabloon, -
een nieuwe naam toewijzen die geschikt is voor uw site;
-
Voer vervolgens de vereiste updates uit.
Een volledig nieuwe sjabloon maken:
-
In CRXDE Lite, maak hieronder een knooppunt
/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 wordt aangeroepen
mysite
, 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:
-
In CRXDE navigeer aan de vereiste pagina in
/content
vertakking. Dit kan een afzonderlijke pagina zijn, of de basispagina van een substructuur. -
Op de
jcr:content
knooppunt van de pagina, maakt u de eigenschap:Name
:cq:exportTemplate
Type
:String
Value
: pad naar de sjabloon, bijvoorbeeld:/etc/contentsync/templates/mysite
Configuratieknooppunten van pagina-exporteur page-exporter-configuration-nodes
De sjabloon bestaat uit een knooppuntstructuur, omdat deze de Content Sync-framework. Elk knooppunt heeft een type
eigenschap 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.
- Vergrendeld onder
/etc/contentsync/templates/<mysite>
. - Gedefinieerd met de eigenschap
Name
instellen oppage
. - Node type is
nt:unstructured
De
page
node heeft de volgende eigenschappen:-
A
type
eigenschap ingesteld met de waardepages
. -
Het heeft geen
path
eigenschap als het huidige paginapad dynamisch naar de configuratie 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.
- Vergrendeld onder
/etc/contentsync/templates/<mysite>
. - Gedefinieerd met de eigenschap
Name
instellen opdesign
. - Node type is
nt:unstructured
.
De
design
node heeft de volgende eigenschappen:-
A
type
eigenschap ingesteld op de waardecopy
. -
Het heeft geen
path
eigenschap, aangezien het huidige paginapad dynamisch naar de configuratie wordt gekopieerd.
-
generic
Een generisch knooppunt wordt gebruikt om bronnen als clientlibs te kopiëren.js
of.css
naar het ZIP-bestand. Het heeft de volgende kenmerken:- Optioneel.
- Vergrendeld onder
/etc/contentsync/templates/<mysite>
. - Geen specifieke naam.
- Node type is
nt:unstructured
. - Heeft een
type
eigendom entype
verwante eigenschappen.
De 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" }
Een aangepaste configuratie implementeren
Aangepaste configuraties zijn ook mogelijk.
Om aan bepaalde specifieke vereisten te voldoen, voert u een aangepaste update-handler.
Pagina's programmatisch exporteren programmatically-exporting-a-page
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 troubleshooting
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.