存取及傳遞內容片段無頭快速入門手冊

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

什麼是 GraphQL 和 Assets REST API?

現在您已經建立一些內容片段,您可以使用 AEM 的 API 無周邊傳遞內容片段。

本指南的其餘部分著重在 GraphQL 存取和內容片段傳遞。

如何使用GraphQL傳送內容片段

資訊架構師需要為他們的管道端點設計查詢,以便傳遞內容。通常只需要為每個模型的每個端點考慮一次這些查詢。出於本快速入門指南的目的,我們只需要建立一個。

  1. 登入AEM並存取 GraphiQL介面:

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

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

    • 右側面板顯示結果。

    • 查詢編輯器具有程式碼完成和快速鍵功能,可輕鬆執行查詢。

      GraphiQL 編輯器

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

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

  5. 按一下 執行查詢 (向右箭頭)圖示,或使用 Ctrl-Enter 快捷鍵和結果會在右側面板中顯示為JSON。
    GraphiQL 結果

  6. 按一下:

    • 檔案 顯示內容內檔案,協助您建立可適應您自己模型的查詢。

    • 歷史記錄 ,以顯示先前的查詢。

    • 另存新檔儲存 要保存查詢,在此之後,您可以列出並從 持續查詢 面板和 發佈.

      GraphiQL 文件

GraphQL 支援結構化查詢,這些查詢不僅可以針對特定資料集或個別資料物件,還可以傳遞物件的特定元素、巢狀結果、支援查詢變數等等。

GraphQL 可以避免反覆 API 要求以及過度傳遞,而是允許大量傳遞呈現作業所需的內容,作為對單一 API 查詢的回應。產生的 JSON 可用於將資料傳遞到其他網站或應用程式。

後續步驟

就是這樣!您現在對 AEM 無周邊內容管理有基本的了解。當然,還有更多資源可供您深入研究以全面了解可用的功能。

本頁內容