瞭解如何使用GraphQL API來無頭地傳遞內容片段內容和資AEM產REST API來管理內容片段。
此功能的某些功能在預發行渠道中可用。 特別是與永續查詢相關的功能。
查看 預發行渠道文檔 有關如何為您的環境啟用該功能的資訊。
既然你已經建立了一些內容片段, 你可以用AEMAPI來無端傳送它們。
本指南的其餘部分將重點介紹GraphQL訪問和內容片段交付。
必須先建立GraphQL終結點,然後才能使用GraphQL API。
導航到 工具。 常規,然後選擇 圖形QL。
選擇 建立。
的 建立新GraphQL終結點 對話框。 您可以在此處指定:
確認 建立。
在控制台中 路徑 現在將基於先前建立的配置顯示。 這是用於執行GraphQL查詢的路徑。
/content/cq:graphql/<configuration-name>/endpoint
有關啟用的詳細資訊 可在此處找到GraphQL端點。
資訊架構師需要為其渠道端點設計查詢,以便提供內容。 通常,每個模型的每個端點只需考慮一次這些查詢。 為了完成本入門指南的目的,我們只需建立一個。
GraphiQL是可安裝在環境上的AEMIDE。 按照上的步驟操作 使用GraphiQL IDE 安裝到您的AEM環境中。
登錄到AEMas a Cloud Service並訪問GraphiQL介面:
可以從以下任一位置訪問查詢編輯器:
http://localhost:4502/aem/graphiql.html
GraphiQL IDE是GraphQL的瀏覽器內查詢編輯器。 您可以使用它構建查詢以檢索內容片段,以JSON形式無頭地傳遞這些內容片段。
假設我們建立的模型被稱為 person
帶 firstName
。 lastName
, position
,我們可以構建一個簡單的查詢來檢索內容片段的內容。
query
{
personList {
items {
_path
firstName
lastName
position
}
}
}
在左面板中輸入查詢。
按一下 執行查詢 按鈕或 Ctrl-Enter
熱鍵和結果在右面板中顯示為JSON。
按一下 文檔 連結到頁面右上角以顯示上下文文檔,以幫助您構建適應您自己模型的查詢。
GraphQL支援結構化查詢,不僅可以針對特定資料集或單個資料對象,還可以提供對象的特定元素、嵌套結果、支援查詢變數等。
GraphQL可以避免迭代API請求和過量傳遞,而是允許批量傳遞對單個API查詢的響應而進行呈現所需的內容。 生成的JSON可用於將資料傳遞到其他站點或應用。
就這樣! 您現在對中的無頭內容管理有了基本的了AEM解。 當然,您還有更多資源可以深入瞭解可用功能。