AEM Headless的進階概念

透過 30 天試用版了解我們的 headless CMS

此端對端教學課程會繼續 基本教學課程 涵蓋Adobe Experience Manager (AEM) Headless和GraphQL的基礎。 進階教學課程說明使用內容片段模型、內容片段和AEM GraphQL持續查詢的深入層面,包括在使用者端應用程式中使用GraphQL持續查詢。

先決條件

完成 AEMas a Cloud Service快速設定 以設定您的AEMas a Cloud Service環境。

強烈建議您完成先前的 基本教學課程影片系列 教學課程,再繼續此進階教學課程。 雖然您可以使用本機AEM環境完成本教學課程,但本教學課程僅涵蓋AEMas a Cloud Service的工作流程。

CAUTION
如果您沒有AEMas a Cloud Service環境的存取權,可以完成 使用本機SDK的AEM Headless快速設定. 不過,請務必注意,某些產品UI頁面(例如內容片段導覽)是不同的。

目標

本教學課程涵蓋下列主題:

  • 使用驗證規則和更進階的資料型別(例如Tab預留位置、巢狀片段參照、JSON物件以及日期和時間資料型別)建立內容片段模型。
  • 使用巢狀內容和片段參考時製作內容片段,並為內容片段製作控管設定資料夾原則。
  • 使用具有變數和指令的GraphQL查詢來探索AEM GraphQL API功能。
  • 在AEM中使用引數保留GraphQL查詢,並瞭解如何將快取控制引數用於保留查詢。
  • 使用AEM Headless JavaScript SDK將持續查詢請求整合到範例WKND GraphQL React應用程式中。

AEM Headless的進階概念概覽

以下影片提供本教學課程中所涵蓋概念的高層級概觀。 此教學課程包括使用更進階的資料型別定義內容片段模型、巢狀內容片段,以及在AEM中保留GraphQL查詢。

CAUTION
這段影片(於2:25)提到了透過封裝管理員安裝GraphiQL查詢編輯器以探索GraphQL查詢。 但在較新版本的AEM中,為Cloud Service內建 GraphiQL Explorer 提供,因此不需要安裝封裝。 另請參閱 使用GraphiQL IDE 以取得詳細資訊。

專案設定

WKND網站專案具有所有必要的設定,因此您可在完成 快速設定. 本節僅重點說明您在建立自己的AEM Headless專案時可以使用的一些重要步驟。

檢閱現有設定

在AEM中開始任何新專案的第一步是建立其設定,作為工作區並建立GraphQL API端點。 若要檢閱或建立組態,請導覽至 工具 > 一般 > 設定瀏覽器.

導覽至設定瀏覽器

請注意 WKND Shared 已針對本教學課程建立網站設定。 若要建立您專案的設定,請選取 建立 並完成出現的「建立組態」強制回應視窗中的表單。

檢閱WKND共用組態

檢閱GraphQL API端點

接下來,您必須設定API端點,以將GraphQL查詢傳送至。 若要檢閱現有端點或建立端點,請導覽至 工具 > 一般 > GraphQL.

設定端點

請注意 WKND Shared Endpoint 已建立。 若要建立專案的端點,請選取 建立 前往右上角,並依照工作流程操作。

檢閱WKND共用端點

NOTE
儲存端點後,您將會看到造訪安全性控制檯的強制回應視窗,在您想要設定端點的存取許可權時,此功能可讓您調整安全性設定。 然而,安全性許可權本身並不在本教學課程的討論範圍內。 如需詳細資訊,請參閱 AEM檔案.

檢閱WKND內容結構和語言根資料夾

明確定義的內容結構是AEM Headless實施成功的關鍵。 它有助於您管理內容的可擴充性、可用性和許可權。

語言根資料夾是以ISO語言代碼作為其名稱(例如EN或FR)的資料夾。 AEM翻譯管理系統使用這些資料夾來定義內容的主要語言和內容翻譯的語言。

前往 導覽 > 資產 > 檔案.

導覽至檔案

導覽至 WKND已共用 資料夾。 觀察標題為「English」且名稱為「EN」的資料夾。 此資料夾是WKND網站專案的語言根資料夾。

英文資料夾

針對您自己的專案,在設定中建立語言根資料夾。 請參閱以下小節: 建立資料夾 以取得更多詳細資料。

將設定指派給巢狀資料夾

最後,您必須將專案的設定指派給語言根資料夾。 此指派可讓您根據專案設定中定義的內容片段模型來建立內容片段。

若要將語言根資料夾指派給設定,請選取該資料夾,然後選取 屬性 ,位於頂端導覽列中。

選取屬性

接下來,導覽至 Cloud Service 標籤並選取中的資料夾圖示 雲端設定 欄位。

雲端設定

在出現的強制回應視窗中,選取您先前建立的設定,以將語言根資料夾指派給它。

最佳做法

以下是在AEM中建立您自己的專案時的最佳實務:

  • 資料夾階層模型化時應考慮到本地化和翻譯。 換言之,語言資料夾應巢狀內嵌於設定資料夾中,如此可讓您輕鬆翻譯這些設定資料夾中的內容。
  • 資料夾階層應保持平坦且直接。 請避免在稍後移動或重新命名資料夾和片段,尤其是在發佈以供即時使用後,因為這會變更路徑,進而影響片段參考和GraphQL查詢。

入門和解決方案套件

兩個AEM 套件 可用,並可透過以下方式安裝: 封裝管理員

React應用程式 — 進階教學課程 — WKND冒險 專案可供檢閱和探索範例應用程式。 此範例應用程式會叫用持續存在的GraphQL查詢,從AEM擷取內容,並在沈浸式體驗中呈現。

快速入門

若要開始使用這個進階教學課程,請依照下列步驟進行:

  1. 使用設定開發環境 AEMas a Cloud Service.
  2. 開始教學課程一章,於 建立內容片段模型.
recommendation-more-help
e25b6834-e87f-4ff3-ba56-4cd16cdfdec4