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.

NOTE
Beroende på webbläsaren och inställningarna är hämtningen antingen:
  • 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:

  1. Navigera till önskad sida i konsolen Platser.

  2. Markera sidan och öppna sedan dialogrutan Egenskaper.

  3. Välj fliken Avancerat.

  4. 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.

  5. Välj Spara och stäng för att stänga dialogrutan för sidegenskaper.

  6. Begär att sidan ska exporteras och ersätt suffixet html med export.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
  7. Hämta arkivfilen till filsystemet.

  8. 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)
    • andra resurser (.js filer, .css filer, bilder och så vidare) finns enligt inställningarna i exportmallen

  9. Ö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:

  1. 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

  2. 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:

  1. I CRXDE navigerar du till önskad sida i grenen /content. Det kan vara en enskild sida eller en rotsida i ett underträd.

  2. 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ärdet pages.

    • 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ärdet copy.

    • 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 och type-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.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2