頁面匯出工具

AEM可讓您將頁面匯出為完整的網頁，包括影像、 .js 和 .css 檔案。

設定後，您會以取代 html with export.zip 中。 這會產生封存(zip)檔案，其中包含以html格式呈現的頁面，以及參照的資產。 頁面中的所有路徑（例如，到影像的路徑）都會被重寫，以指向包含在存檔中的檔案，或指向伺服器上的資源。 然後，您就可以從瀏覽器下載封存(zip)檔案。

匯出頁面

下列步驟說明如何匯出頁面，並假設您的網站有匯出範本。 匯出範本會定義頁面的匯出方式，且是您網站專屬的。 若要建立匯出範本，請參閱 為您的網站建立頁面匯出工具組態 區段。

要導出頁面，請執行以下操作：

1. 導覽至 網站 控制台。

2. 選取頁面，然後開啟 屬性 對話框。

3. 選取 進階 標籤。

4. 展開 匯出 欄位來選取匯出範本。
   選取網站所需的範本，然後使用 確定.

5. 選擇 儲存並關閉 以關閉頁面屬性對話方塊。

6. 請求要匯出的頁面，取代尾碼 html with export.zip 中。

   例如：

   • localhost:4502/content/we-retail/language-masters/en.html

   可透過下列方式存取：

   • localhost:4502/content/we-retail/language-masters/en.export

7. 將存檔檔案下載到檔案系統。

8. 在您的檔案系統中，視需要解壓縮檔案。 展開後，會出現與所選頁面同名的資料夾。 此資料夾包含：

   • 子資料夾 content，這是反映存放庫中頁面路徑的一系列子資料夾的根目錄

     • 在此結構中，會有選定頁面的html檔案(<page-name>.html)

   • 其他資源(.js 檔案， .css 檔案、影像等) 是根據匯出範本中的設定來定位

9. 開啟頁面html檔案(<unzip-dir>/<path>/<to>/<page>/<page-path>.html)以檢查呈現。

為您的網站建立頁面匯出工具組態

頁面匯出器以 內容同步架構. 中可用的設定 頁面屬性 對話方塊是匯出範本，用於定義頁面所需的相依性。

觸發頁面匯出時，會參考匯出範本，並動態套用頁面路徑和設計路徑。 然後會使用標準的「內容同步」功能來建立zip檔案。

現成可用的AEM安裝包含下方的預設範本 /etc/contentsync/templates/default.

• 若儲存庫中找不到匯出範本，此範本即為後援範本。

• 此 default 範本會顯示如何設定頁面匯出，因此可作為新匯出範本的基礎。

• 若要以JSON格式檢視瀏覽器中範本的節點結構，請要求下列URL:
  http://localhost:4502/etc/contentsync/templates/default.json

建立新頁面匯出器範本最簡單的方法是：

• 複製 default 範本，

• 為您的網站指派合適的新名稱，

• 然後進行必要的更新。

若要建立全新範本：

1. 在 CRXDE Lite，請在下方建立節點 /etc/contentsync/templates:

   • Name:與您的網站相稱的名稱；例如， <mysite>. 選擇頁面導出器模板時，該名稱將出現在頁面屬性對話框中。

   • Type: nt:unstructured

2. 在範本節點下方，在此處呼叫 mysite，請使用下述設定節點建立節點結構。

為頁面啟用頁面匯出工具範本

設定範本後，您必須讓範本可供使用：

1. 在CRXDE中，導覽至 /content 分支。 這可以是個別頁面，或子樹的根頁面。

2. 在 jcr:content 頁面的節點建立屬性：

   • Name: cq:exportTemplate
   • Type: String
   • Value:範本路徑；例如： /etc/contentsync/templates/mysite

頁面導出器配置節點

範本由節點結構組成，因為它使用 內容同步架構. 每個節點都有 type 定義zip檔案建立程式中特定動作的屬性。

以下節點可用來建立匯出範本：

• page
  頁面節點可用來將頁面html複製到zip檔案。 其特點如下：

  • 是強制節點。
  • 位於下方 /etc/contentsync/templates/<mysite>.
  • 使用屬性定義 Name設為 page.
  • 節點類型為 nt:unstructured

  此 page 節點具有以下屬性：

  • A type 以值設定的屬性 pages.

  • 沒有 path 屬性，因為目前頁面路徑會動態複製到設定。

• rewrite
  重寫節點定義如何在匯出的頁面中重寫連結。 重寫的連結可以指向zip檔案中包含的檔案或指向伺服器上的資源。

• design
  設計節點用於複製用於導出頁面的設計。 其特點如下：

  • 為選用。
  • 位於下方 /etc/contentsync/templates/<mysite>.
  • 使用屬性定義 Name 設為 design.
  • 節點類型為 nt:unstructured.

  此 design 節點具有以下屬性：

  • A type 屬性設為值 copy.

  • 沒有 path 屬性，因為目前頁面路徑會動態複製到設定。

• generic
  一般節點可用來複製clientlibs等資源
  .js 或 .css 檔案。 其特點如下：

  • 為選用。
  • 位於下方 /etc/contentsync/templates/<mysite>.
  • 沒有特定名稱。
  • 節點類型為 nt:unstructured.
  • 有 type 屬性與 type 相關屬性。

  例如，下列設定節點會複製 mysite.clientlibs.js 檔案到zip檔案：

  "mysite.clientlibs.js": {
      "extension": "js",
      "type": "clientlib",
      "path": "/etc/designs/mysite/clientlibs",
      "jcr:primaryType": "nt:unstructured"
  }
  

實作自訂設定

您也可以進行自訂設定。

為了符合某些特定需求，您可能需要實作 自訂更新處理常式.

以程式設計方式匯出頁面

若要以程式設計方式匯出頁面，您可以使用 PageExporter OSGI服務。 此服務可讓您：

• 匯出頁面並寫入HTTP servlet回應。
• 匯出頁面並在特定位置儲存zip檔案。

系結至 export 選取器和 zip 擴充功能使用PageExporter服務。

疑難排解

如果您在下載zip檔案時遇到問題，可以刪除 /var/contentsync 節點，並再次傳送匯出請求。

Business.Adobe.com 資源

Dynamic Media Customer Experience Management Headless Cms Digital Asset Management Digital Signage Content Management System