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的工作流程。

注意

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

目標

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

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

AEM Headless的進階概念概觀

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

注意

這段影片（下午2:25）提到了如何透過封裝管理員安裝GraphiQL查詢編輯器，以探索GraphQL查詢。 但在較新版本的AEM as Cloud Service中，則是內建的 GraphiQL Explorer 提供，因此不需要安裝封裝。 另請參閱 使用GraphiQL IDE 以取得詳細資訊。

專案設定

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

檢閱現有設定

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

導覽至設定瀏覽器

請留意 WKND Shared 已針對本教學課程建立網站設定。 若要為您自己的專案建立設定，請選取 建立 並填妥顯示之「建立組態」強制回應視窗中的表單。

檢閱WKND共用組態

檢閱GraphQL API端點

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

設定端點

請留意 WKND Shared Endpoint 已建立。 若要建立專案的端點，請選取 建立 並依照工作流程操作。

檢閱WKND共用端點

注意

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

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

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

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

前往 導覽 > 資產 > 檔案.

導覽至檔案

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

英文資料夾

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

將設定指派給巢狀資料夾

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

若要將語言根資料夾指派給設定，請選取該資料夾，然後選取 屬性 導覽列上方的「 」。

選取屬性

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

雲端設定

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

最佳實務

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

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

入門和解決方案套件

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

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

快速入門

若要開始使用這個進階教學課程，請遵循下列步驟：

  1. 使用設定開發環境 AEMas a Cloud Service.
  2. 開始教學課程章節於 建立內容片段模型.

本頁內容