Sidexporteraren the-page-exporter
Med Adobe Experience Manager (AEM) kan du exportera en sida som en fullständig webbsida, inklusive bilder, .js
och .css
filer.
När den är konfigurerad begär du en sidexport från webbläsaren genom att ersätta html
med export.zip
i URL:en. Detta genererar en arkivfil (ZIP) som innehåller den återgivna sidan i html-format, tillsammans med de refererade resurserna. Alla sökvägar på sidan (till exempel sökvägar till bilder) skrivs om så att de pekar på antingen filerna som finns i arkivet eller på resurserna på servern. Arkivfilen (ZIP) kan sedan laddas ned från webbläsaren.
- en arkivfil (
<page-name>.export.zip
) - en mapp (
<page-name>
); arkivfilen är i själva verket redan utökad
Exportera en sida exporting-a-page
I följande steg beskrivs hur du exporterar en sida och förutsätter att det finns en exportmall för platsen. En exportmall definierar hur en sida exporteras och är specifik för din plats. Mer information om hur du skapar en exportmall finns i Skapa en sidexportkonfiguration för din plats.
Exportera en sida:
-
Navigera till önskad sida i konsolen Platser.
-
Markera sidan och öppna sedan dialogrutan Egenskaper.
-
Välj fliken Avancerat.
-
Expandera fältet Exportera för att välja en exportmall.
Välj den mall som krävs för din plats och bekräfta sedan med OK. -
Välj Spara och stäng för att stänga dialogrutan för sidegenskaper.
-
Begär att sidan ska exporteras och ersätt suffixet
html
medexport.zip
i URL:en.Till exempel:
- localhost:4502/content/we-retail/language-masters/en.html
Åtkomst via:
- localhost:4502/content/we-retail/language-masters/en.export.zip
-
Hämta arkivfilen till filsystemet.
-
Zippa upp filen i filsystemet om det behövs. När den är expanderad finns det en mapp med samma namn som den markerade sidan. Mappen innehåller:
-
undermappen
content
, som är roten till en serie undermappar som återspeglar sökvägen till sidan i databasen- i den här strukturen finns HTML-filen för den valda sidan (
<page-name>.html
)
- i den här strukturen finns HTML-filen för den valda sidan (
-
andra resurser (
.js
filer,.css
filer, bilder och så vidare) finns enligt inställningarna i exportmallen
-
-
Öppna HTML-sidfilen (
<unzip-dir>/<path>/<to>/<page>/<page-path>.html
) i webbläsaren så att du kan kontrollera återgivningen.
Skapa en sidexportkonfiguration för platsen creating-a-page-exporter-configuration-for-your-site
Sidexporteraren baseras på ramverket för innehållssynkronisering. De konfigurationer som är tillgängliga i dialogrutan Sidegenskaper är exportmallar som definierar nödvändiga beroenden för en sida.
När en sidexport aktiveras refereras exportmallen. Både sidbanan och designbanan tillämpas dynamiskt. ZIP-filen skapas sedan med standardfunktionen för innehållssynkronisering.
En körklar AEM innehåller en standardmall under /etc/contentsync/templates/default
.
-
Den här mallen är en reservmall när ingen exportmall hittas i databasen.
-
Mallen
default
visar hur en sidexport kan konfigureras så att den kan fungera som bas för en ny exportmall. -
Om du vill visa nodstrukturen för mallen i webbläsaren som JSON-format begär du följande URL:
http://localhost:4502/etc/contentsync/templates/default.json
Det enklaste sättet att skapa en sidexportmall är att:
-
kopiera mallen
default
, -
tilldela ett nytt namn som passar din webbplats,
-
gör sedan nödvändiga uppdateringar.
Så här skapar du en helt ny mall:
-
Skapa en nod under
/etc/contentsync/templates
i CRXDE Lite:-
Name
: ett namn som passar din plats, till exempel<mysite>
. Namnet visas i dialogrutan för sidegenskaper när du väljer sidexportmall. -
Type
:nt:unstructured
-
-
Under mallnoden, som anropas här
mysite
, skapar du en nodstruktur med hjälp av konfigurationsnoderna som beskrivs nedan.
Aktivera en sidexportmall för dina sidor activating-a-page-exporter-configuration-for-your-pages
Gör mallen tillgänglig när du har konfigurerat den:
-
I CRXDE navigerar du till önskad sida i grenen
/content
. Det kan vara en enskild sida eller en rotsida i ett underträd. -
Skapa egenskapen på noden
jcr:content
på sidan:Name
:cq:exportTemplate
Type
:String
Value
: sökväg till mallen, till exempel:/etc/contentsync/templates/mysite
Konfigurationsnoder för sidexport page-exporter-configuration-nodes
Mallen består av en nodstruktur, eftersom den använder ramverket för innehållssynkronisering. Varje nod har en type
-egenskap som definierar en specifik åtgärd när zip-filen skapas.
Följande noder kan användas för att skapa en exportmall:
-
page
Sidnoden används för att kopiera sidans HTML-kod till zip-filen. Den har följande egenskaper:- En obligatorisk nod.
- Finns under
/etc/contentsync/templates/<mysite>
. - Definieras med egenskapen
Name
inställd påpage
. - Nodtypen är
nt:unstructured
Noden
page
har följande egenskaper:-
En
type
-egenskap med värdetpages
. -
Den har ingen
path
-egenskap eftersom den aktuella sidsökvägen kopieras dynamiskt till konfigurationen.
-
rewrite
Noden rewrite definierar hur länkarna skrivs om på den exporterade sidan. De omskrivna länkarna kan antingen peka på filerna som finns i ZIP-filen eller på resurserna på servern. -
design
Designnoden används för att kopiera designen som används för den exporterade sidan. Den har följande egenskaper:- Valfritt.
- Finns under
/etc/contentsync/templates/<mysite>
. - Definieras med egenskapen
Name
inställd pådesign
. - Nodtypen är
nt:unstructured
.
Noden
design
har följande egenskaper:-
En
type
-egenskap har värdetcopy
. -
Den har ingen
path
-egenskap eftersom den aktuella sidsökvägen kopieras dynamiskt till konfigurationen.
-
generic
En allmän nod används för att kopiera resurser som clientlibs.js
- eller.css
-filer till zip-filen. Den har följande egenskaper:- Valfritt.
- Finns under
/etc/contentsync/templates/<mysite>
. - Inget specifikt namn.
- Nodtypen är
nt:unstructured
. - Har en
type
-egenskap ochtype
-relaterade egenskaper.
Följande konfigurationsnod kopierar till exempel
mysite.clientlibs.js
-filerna till zip-filen:code language-xml "mysite.clientlibs.js": { "extension": "js", "type": "clientlib", "path": "/etc/designs/mysite/clientlibs", "jcr:primaryType": "nt:unstructured" }
Implementera en anpassad konfiguration
Anpassade konfigurationer är också möjliga.
Implementera en anpassad uppdateringshanterare för att uppfylla vissa specifika krav.
Programmatisk export av en sida programmatically-exporting-a-page
Om du vill exportera en sida programmatiskt kan du använda OSGI-tjänsten PageExporter. Med den här tjänsten kan du:
- Exportera en sida och skriv till HTTP-serverns svar.
- Exportera en sida och spara zip-filen på en viss plats.
Servern som är bunden till väljaren export
och tillägget zip
använder tjänsten PageExporter.
Felsökning troubleshooting
Om du får problem med nedladdningen av zip-filen kan du ta bort noden /var/contentsync
i databasen och skicka exportbegäran igen.