AEM Headless 製作基本知識 author-headless-basics

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
無周邊

建立對象：

管理員
開發人員

目前進度 story-so-far

在 AEM Headless 內容作者歷程的一開始，簡介部分介紹了和 Headless 內容製作相關的基本概念和術語。

本文以這些內容為基礎，以便您了解如何為 AEM Headless 專案製作您自己的內容。

目標 objective

對象：初學者
目標：介紹 Headless CMS 製作的基本知識：
- 使用 AEMaaCS 製作簡介
- 內容片段簡介

基本處理 basic-handling

在您掌握內容片段之前，對於如何使用 AEM，這裡有 (非常) 快速的介紹…但沒有什麼能真正取代登入和嘗試使用系統的體驗。

作者、預覽和發佈 author-preview-publish

AEM 安裝通常至少包含三個環境：

作者
發佈
預覽

登入並使用製作環境來產生您的內容。準備好內容後，就可以發佈，使其普遍可用。對於 Headless ，這將針對其他應用程式，對於網頁，這將針對網路讀者。

如需詳細資訊，請參閱製作概念。

在發佈之前，您還可以從 內容片段 主控台發佈至 預覽服務，以進行測試和預覽。請參閱「發佈和預覽片段」。

登入 signing-in

如同大部分系統，需要登入。作為作者，您將取得：

使用者 (帳戶) 名稱
密碼
存取登入畫面的連結

您的帳戶將設定成具有任何您需要的權限。如果您有任何問題，Adobe 建議應聯絡您的內部支援團隊。

首次登入小型線上教學課程，將會重點介紹使用者介面的一些主要功能。

然後，您可以使用導覽面板存取 AEM 的關鍵區域。對於內容片段，您使用 內容片段 主控台 (對於某些動作，您也將使用資產主控台)。

可以透過選擇左上角的 Adobe 圖示，然後選擇小羅盤圖示來開啟導覽面板。

NOTE

雖然內容片段是 AEM Sites 的功能，但它們也另存為資產。這個技術細節不會影響您的操作，但了解它可能會有用。

在主控台中，您可以在左側面板中選擇資料夾以導覽至您的內容片段。您還可以篩選和/或搜尋。

內容片段主控台

動作、選擇、檢視 actions-selecting-viewing

在 內容片段 主控台中，工具列中有一系列動作可用於您的內容片段：

在 Assets 中開啟
建立
參考者 欄也提供直接連結以顯示該片段的所有父參考；包括參考內容片段、體驗片段和頁面。
將游標停留在資料夾名稱上將顯示 JCR 路徑。

選擇您的片段後，所有適當的動作都可用：

開啟
發佈 (和 取消發佈)
複製
移動
重新命名
刪除

NOTE

發佈、取消發佈、刪除、移動、重新命名、複製等動作觸發非同步作業。可以透過 AEM 非同步作業 UI 監視該作業的進度。

製作內容片段 authoring-content-fragments

所以，這是對 AEM 使用者介面 (UI) 的非常快速介紹，但希望您有機會嘗試一下。現在我們開始討論您真正感興趣的部分 - Headless 內容片段。

我們必須從頭到尾說明所有事情，但是您的執行個體可能已經建立了資料夾和/或片段，並且它們可能位於不同的位置。原理是一樣的。

組織和導覽 organizing-and-navigating

除非您的內容片段很少，否則您會想要加以組織，以便您 (和其他人) 可以再次找到它們。

建立資料夾 creating-folder

為此，您可以在資產主控台的檔案區段內，建立一系列的資料夾。選擇建立選項 (右上角)，然後選擇 資料夾：

建立資料夾選項

對話框隨即開啟，您可以在其中輸入詳細資料，然後使用「建立」來確認：

建立資料夾對話框

使用路徑和標記限制資料夾中可用的內容片段模型 tags-paths-for-models-in-folder

本章節的技術稍微進階一些。如果您才剛開始嘗試，您並不需要它，但是當您有很多片段時，它就非常實用。所以了解它是件好事 - 即使您還沒有使用它。

您的內容架構師將建立您目前專案所需的所有內容片段模型，一些其他專案可能也需要。為了協助您和其他作者簡化作業，您可以對特定資料夾的可用模型清單加以限制。

建立資料夾後，您可以開啟屬性資料夾。這裡有各種索引標籤，其中包含有關資料夾的資訊和設定詳細資料。特別是對於內容片段，您可以使用原則索引標籤為此資料夾定義特定路徑和/或標記。這限制了可在資料夾中使用的內容片段模型，因為這表示內容片段模型必須滿足這些要求才能用來在此資料夾中產生片段。

建立資料夾屬性 - 原則

NOTE

您可以在「內容片段模型 - 允許在資產資料夾中使用內容片段模型」下閱讀更多詳細資訊。

然後瀏覽這些資料夾以建立和編輯您的內容片段。

以防萬一 - 資料夾雲端服務設定 cloud-services-folder

以防萬一…

您可能會得到一個初始資料夾，您可以在其中建立資料夾。這是因為一些設定細節必須套用 (通常由開發人員或系統管理員執行) 到根資料夾。您可能對此不感興趣，但如果有必要，您可以查看屬性資料夾中 雲端服務 的設定：

建立資料夾屬性 - 設定

NOTE

您可以在「將設定套用到資產資料夾」下閱讀更多資訊。

建立內容片段 creating-fragment

在 內容片段 主控台，您可以使用建立來開啟 新的內容片段 對話框：

內容片段主控台 - 建立新片段

指定：

位置
內容片段模型
標題
名稱
說明

然後使用建立或 建立並開啟 加以確認。

編輯片段 editing-fragment

您可以在建立片段後立即開啟它，或者從內容片段主控台 (也可以從資產主控台) 中選擇它以開啟。

NOTE

內容片段是 Sites 的一項功能，但儲存為資產。

有兩個編輯器用於製作內容片段。

新編輯器主要可從「內容片段」主控台存取。
原始編輯器主要可從「資產」主控台存取。

編輯器首次開啟時，您會看到：

頂端工具列：用於關鍵資訊和動作
- 內容片段主控台的連結 (首頁圖示)
- 有關模型和檔案夾的資訊
- 預覽連結；如果設預覽 URL 模式是為模型所設定
- 發佈和取消發佈動作
- 顯示全部 父參考內容 的選項 (連結圖示)
- 狀態片段，以及最後儲存的資訊
- 用來切換至原始 (以資產為主) 編輯器的切換開關
左面板：顯示內容片段的變數及其欄位：
- 這些連結可用來導覽至內容片段結構
右側面板：展示一些會顯示屬性 (中繼資料) 和標記的標籤、有關版本歷史記錄的資訊，以及與任何語言版本相關的資訊
- 在「屬性」標籤中，您可以更新片段的「標題」和「說明」，或者更新「變數」
中央面板：顯示所選變數的實際欄位和內容
- 允許您編輯內容
- 如果「標籤預留位置」欄位是在此處所示模型中定義，那麼這些欄位可用於導覽