歡迎使用有關Adobe Experience Manager (AEM)中的內容片段和GraphQL端點的教學課程章節。 我們將介紹如何運用內容片段、建立片段模型,以及在AEM中使用GraphQL端點。
內容片段提供結構化方法,可跨管道管理內容,提供彈性和可重複使用性。 在AEM中啟用內容片段可建立模組化內容,增強一致性和適應性。
首先,我們將引導您在AEM中啟用內容片段,涵蓋無縫整合的必要設定和設定。
接下來,我們將介紹如何建立片段模型,這些模型會定義結構和屬性。 瞭解如何根據您的內容需求設計模型,並有效管理模型。
接著,我們將示範如何從模型建立內容片段,提供製作和發佈的逐步指引。
此外,我們將探索定義AEM GraphQL端點。 GraphQL會有效率地從AEM擷取資料,而我們將設定並設定端點以公開所需的資料。 持續查詢將最佳化效能和快取。
在本教學課程中,我們將提供說明、程式碼範例和實用秘訣。 到最後,您將具備啟用內容片段、建立片段模型、產生片段,以及定義AEM GraphQL端點和持續查詢的技能。 讓我們開始吧!
導覽至 「工具」>「設定瀏覽器」 為Headless體驗建立設定。
提供 標題 和 名稱,並勾選 GraphQL持續查詢 和 內容片段模型.
導覽至 工具>內容片段模型 並選取具有在步驟1中建立的設定名稱的資料夾。
在資料夾中,選取 建立 並為模型命名 Teaser. 將下列資料型別新增至 Teaser 模型。
資料型別 | 名稱 | 必要 | 選項 |
---|---|---|---|
內容參考 | 資產 | 是 | 您可以新增預設影像。 例如: /content/dam/wknd-headless/assets/AdobeStock_307513975.mp4 |
單行文字 | 標題 | 是 | |
單行文字 | 前置標題 | 否 | |
多行文字 | 說明 | 否 | 確定預設型別為RTF文字 |
列舉 | 樣式 | 是 | 呈現為下拉式清單。 選項包括Hero ->Hero和Featured ->精選 |
在資料夾內,建立名為的第二個模型 選件. 按一下「建立」並為模型命名「選件」,然後新增以下資料型別:
資料型別 | 名稱 | 必要 | 選項 |
---|---|---|---|
內容參考 | 資產 | 是 | 新增預設影像。 例如:/content/dam/wknd-headless/assets/AdobeStock_238607111.jpeg |
多行文字 | 說明 | 否 | |
多行文字 | 文章 | 否 |
在資料夾內,建立名為的第三個模型 影像清單. 按一下「建立」並為模型命名「影像清單」,然後新增以下資料型別:
資料型別 | 名稱 | 必要 | 選項 |
---|---|---|---|
片段參考 | 清單項目 | 是 | 呈現為多個欄位。 允許的內容片段模型為選件。 |
現在導覽至「資產」 ,並為新網站建立資料夾。 按一下「建立」並為資料夾命名。
建立資料夾後,選取資料夾並開啟其 屬性.
在資料夾的 雲端設定 索引標籤中,選取設定 建立時間較早.
按一下進入新資料夾並建立Teaser。 按一下 建立 和 內容片段 並選取 Teaser 模型。 為模型命名 Hero 並按一下 建立.
名稱 | 附註 |
---|---|
資產 | 保留為預設值或選擇其他資產(視訊或影像) |
標題 | Explore. Discover. Live. |
前置標題 | Join use for your next adventure. |
說明 | 留空 |
樣式 | Hero |
導覽至 「工具」>「GraphQL」
按一下 建立 並為新端點命名,然後選擇新建立的設定。
讓我們測試新端點。 導覽至 「工具> GraphQL查詢編輯器」 並為視窗右上方的下拉式清單選擇我們的端點。
在查詢編輯器中,建立一些不同的查詢。
{
teaserList {
items {
title
}
}
}
您應該會獲得包含已建立單一片段的清單 以上.
針對此練習,建立AEM Headless應用程式使用的完整查詢。 建立可依路徑傳回單一Teaser的查詢。 在查詢編輯器中,輸入以下查詢:
query TeaserByPath($path: String!) {
component: teaserByPath(_path: $path) {
item {
__typename
_path
_metadata {
stringMetadata {
name
value
}
}
title
preTitle
style
asset {
... on MultimediaRef {
__typename
_authorUrl
_publishUrl
format
}
... on ImageRef {
__typename
_authorUrl
_publishUrl
mimeType
width
height
}
}
description {
html
plaintext
}
}
}
}
在 查詢變數 在底部輸入,輸入:
{
"path": "/content/dam/pure-headless/hero"
}
您可能需要調整查詢變數 path
根據資料夾和片段名稱。
執行查詢以接收先前建立的內容片段的結果。
按一下 儲存 以保留(儲存)查詢並命名查詢 Teaser. 這可讓我們在應用程式中依名稱參照查詢。
恭喜!您已成功設定AEMas a Cloud Service以允許建立內容片段和GraphQL端點。 您也可以建立內容片段模型和內容片段,並定義GraphQL端點與持續查詢。 您現在已準備好進入下一個教學課程章節,您將瞭解如何建立AEM Headless React應用程式,該應用程式會使用您在本章中建立的內容片段和GraphQL端點。