存取和傳送內容片段無頭快速入門手冊

了解如何使用AEM Assets REST API管理內容片段,以及GraphQL API,以無周邊方式傳送內容片段內容。

什麼是GraphQL和Assets REST API?

現在您已建立一些內容片段, 您可以使用AEM API無端傳送。

本指南的其餘部分將重點介紹GraphQL訪問和內容片段交付。

如何使用GraphQL傳送內容片段

資訊架構師需要為其管道端點設計查詢,才能傳送內容。 通常,每個模型的每個端點只需考慮這些查詢一次。 為了此快速入門手冊的目的,我們只需建立指南。

  1. 以Cloud Service身分登入AEM並存取GraphiQL介面:

    • 例如:https://<host>:<port>/content/graphiql.html
  2. GraphiQL是GraphQL的瀏覽器內查詢編輯器。 您可以使用它建立查詢來擷取內容片段,以便以JSON形式直接傳送。

    • 左側面板可讓您建立查詢。

    • 右側面板顯示結果。

    • 查詢編輯器具有代碼完成功能和可輕鬆執行查詢的快捷鍵。

      GraphiQL編輯器

  3. 假設我們建立的模型名為person,且欄位為firstNamelastNameposition,我們可以建立簡單查詢來擷取內容片段的內容。

    query 
    {
      personList {
        items {
          _path
          firstName
          lastName
          position
        }
      }
    }
    
  4. 在左側面板中輸入查詢。
    GraphiQL查詢

  5. 按一下​執行查詢​按鈕或使用Ctrl-Enter快捷鍵,結果將顯示為右側面板中的JSON。
    GraphiQL結果

  6. 按一下頁面右上角的​Docs​連結,顯示內容內檔案,協助您建立可適應您自己模型的查詢。
    GraphiQL檔案

GraphQL啟用結構化查詢,這些查詢不僅可以定位特定的資料集或單個資料對象,還可以提供對象的特定元素、嵌套結果、對查詢變數的支援等。

GraphQL可避免迭代API要求以及過度傳送,而可大量傳送要求,以回應單一API查詢,即可呈現所需的內容。 產生的JSON可用來傳送資料至其他網站或應用程式。

後續步驟

就這樣! 您現在對AEM中無頭式內容管理有了基本的了解。 當然,您還可以透過更多資源更進一步深入了解可用功能。

  • 設定瀏覽器 — 如需AEM設定瀏覽器的詳細資訊
  • 內容片段 — 如需建立和管理內容片段的詳細資訊
  • AEM Assets HTTP API中的內容片段支援 — 如需透過CRUD操作(建立、讀取、更新、刪除)直接透過HTTP API存取AEM內容的詳細資訊
  • GraphQL API — 了解如何無條件傳送內容片段的詳細資訊

本頁內容