Sidexporteraren the-page-exporter

Med Adobe Experience Manager (AEM) kan du exportera en sida som en komplett webbsida med bilder, .jsoch .css filer.

När konfigurationen är konfigurerad begär du en sidexport från webbläsaren genom att ersätta html med export.zip i webbadressen. 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. Information om hur du skapar en exportmall finns i Skapa en sidexportkonfiguration för platsen.

Exportera en sida:

  1. Navigera till önskad sida i Webbplatser konsol.

  2. Markera sidan och öppna sedan Egenskaper -dialogrutan.

  3. Välj Avancerat -fliken.

  4. Expandera Exportera om du vill välja en exportmall.
    Välj önskad mall för platsen 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ätta suffixet html med export.zip i webbadressen.

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

  9. Öppna HTML-filen för sidan (<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å Innehållssynkroniseringsramverk. De konfigurationer som är tillgängliga i Sidegenskaper -dialogrutor ä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.

  • The default -mallen visar hur en sidexport kan konfigureras så att den kan fungera som en 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 default mall,

  • 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. I CRXDE Lite, skapa en nod nedan /etc/contentsync/templates:

    • 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 mysiteskapar 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 dialogrutan /content gren. Det kan vara en enskild sida eller en rotsida i ett underträd.

  2. jcr:content på sidans nod, skapa egenskapen:

    • 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 som använder Innehållssynkroniseringsramverk. Varje nod har en type -egenskap som definierar en viss å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 nedan /etc/contentsync/templates/<mysite>.
    • Definieras med egenskapen Nameange till page.
    • Nodtypen är nt:unstructured

    The page noden har följande egenskaper:

    • A type egenskap som anges med värdet pages.

    • Den har inte en path egenskapen när 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 nedan /etc/contentsync/templates/<mysite>.
    • Definieras med egenskapen Name ange till design.
    • Nodtypen är nt:unstructured.

    The design noden har följande egenskaper:

    • A type egenskapen inställd på värdet copy.

    • Den har inte en path -egenskapen när 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 till zip-filen. Den har följande egenskaper:

    • Valfritt.
    • Finns nedan /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 filer 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.

Programmatisk export av en sida programmatically-exporting-a-page

Om du vill exportera en sida programmatiskt kan du använda PageExporter OSGI-tjänster. 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 export väljaren och zip i används tjänsten PageExporter.

Felsökning troubleshooting

Om du får problem med nedladdningen av ZIP-filen kan du ta bort /var/contentsync i databasen och skicka exportbegäran igen.

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