AEM 게재 API를 통해 콘텐츠에 액세스하는 방법 access-your-content

이 AEM Headless 개발자 여정의 부분에서 GraphQL 쿼리를 통해 콘텐츠 조각의 콘텐츠에 액세스하고 앱에 피드하는 방법(Headless 게재)에 대해 알아볼 수 있습니다.

지금까지의 스토리 story-so-far

AEM Headless 여정의 이전 문서인 콘텐츠를 모델링하는 방법에서는 AEM의 콘텐츠 모델링에 대한 기본 사항을 살펴보았으므로 이제 콘텐츠 구조를 모델링하는 방법을 이해하고 AEM 콘텐츠 조각 모델 및 콘텐츠 조각을 사용하여 해당 구조를 실현해야 합니다.

이 문서는 해당 기본 사항을 기본으로 하며, 이를 통해 AEM GraphQL API를 통해 AEM의 기존 Headless 콘텐츠에 액세스하는 방법을 살펴볼 수 있습니다.

콘텐츠에 액세스하시겠습니까? so-youd-like-to-access-your-content

이에 이 모든 콘텐츠는 (콘텐츠 조각에) 깔끔히 구조화되어 새 앱 피드 대기 중입니다. 질문 - 콘텐츠를 가져오는 방법은 무엇입니까?

추가적인 처리가 필요하면 특정 콘텐츠를 타겟팅하고 필요한 사항을 선택한 다음 앱으로 반환해야 합니다.

AEM(Adobe Experience Manager)을 사용하면 AEM GraphQL API를 사용하여 콘텐츠 조각에 선택적으로 액세스하여 필요한 콘텐츠만 반환할 수 있습니다. 즉, 애플리케이션에 사용할 구조화된 콘텐츠의 Headless 게재를 실현할 수 있습니다.

GraphQL - 소개 graphql-introduction

GraphQL은 다음 사항을 제공하는 오픈 소스 사양입니다.

GraphQL은 강력한 형식의 API입니다. 즉, GraphQL이 액세스하는 대상 및 방법을 이해 ​할 수 있도록 모든 데이터를 유형별로 명확하게 구조화하고 구성해야 합니다. 콘텐츠 오브젝트의 구조를 정의하는 GraphQL 스키마 내에서 데이터 필드를 정의합니다.

그런 다음 GraphQL 엔드포인트는 GraphQL 쿼리에 응답하는 경로를 제공합니다.

즉, 앱이 AEM에서 사용되는 경우 필요한 사항을 정확하고 안정적이며 효율적으로 선택할 수 있습니다.

AEM GraphQL API aem-graphql-api

AEM GraphQL API는 표준 GraphQL API 사양을 기반으로 하는 사용자 지정된 버전으로, 콘텐츠 조각에서 (복잡한) 쿼리를 수행할 수 있도록 특별히 구성되어 있습니다.

콘텐츠는 콘텐츠 조각 모델에 따라 구조화되므로 콘텐츠 조각을 사용합니다. 이로써 GraphQL의 기본 요구 사항을 충족합니다.

실제로 AEM용 GraphQL(및 콘텐츠)에 액세스하려면 엔드포인트를 사용하여 액세스 경로를 제공합니다.

그런 다음 반환된 콘텐츠를 애플리케이션에서 AEM GraphQL API를 통해 사용할 수 있습니다.

쿼리를 직접 입력하고 테스트하는 데 도움이 되도록 표준 GraphiQL 인터페이스 구현은 AEM GraphQL과 함께 사용할 수도 있습니다(AEM으로 설치할 수 있음). 기록 및 온라인 설명서와 함께 구문 강조, 자동 완성, 자동 제안과 같은 기능을 제공합니다.

AEM GraphQL API과 함께 사용하기 위한 콘텐츠 조각 content-fragments-use-with-aem-graphql-api

콘텐츠 조각은 다음과 같이 AEM 스키마 및 쿼리를 위한 GraphQL의 기반으로 사용할 수 있습니다.

콘텐츠 조각 모델 content-fragments-models

해당 콘텐츠 조각 모델은

조각 참조 fragment-references

조각 참조:

JSON 미리보기 json-preview

콘텐츠 조각 모델 디자인 및 개발을 지원하기 위해 콘텐츠 조각 편집기에서 JSON 출력을 미리 볼 수 있습니다.

실제로 AEM GraphQL API 사용하기 actually-using-aem-graphiql

초기 설정 initial-setup

콘텐츠에 대한 쿼리를 시작하기 전에 다음 사항을 수행해야 합니다.

샘플 구조 sample-structure

쿼리에서 실제로 AEM GraphQL API를 사용하려면 두 가지 기본 콘텐츠 조각 모델 구조를 사용할 수 있습니다.

이처럼 CEO 및 직원 필드는 개인 조각을 참조합니다.

조각 모델이 사용됩니다.

쿼리를 테스트할 위치 where-to-test-your-queries

쿼리는 GraphiQL 인터페이스에 입력할 수 있습니다(예: 다음 위치).

쿼리 시작하기 getting-Started-with-queries

간단한 쿼리는 회사 스키마에 있는 모든 항목의 이름을 반환하는 것입니다. 여기에서 모든 회사 이름 목록을 요청합니다.

query {
  companyList {
    items {
      name
    }
  }
}

약간 더 복잡한 쿼리는 “작업” 이름이 없는 모든 사람을 선택하는 것입니다. 작업 이름이 없는 모든 사람이 필터링됩니다. 이는 EQUALS_NOT 연산자로 수행됩니다(추가 연산자 있음).

query {
  personList(filter: {
    name: {
      _expressions: [
        {
          value: "Jobs"
          _operator: EQUALS_NOT
        }
      ]
    }
  }) {
    items {
      name
      firstName
    }
  }
}

더 복잡한 쿼리를 작성할 수도 있습니다. 예: 이름이 “Smith”인 직원이 한 명 이상 있는 모든 회사의 쿼리. 이 쿼리는 이름이 “Smith”인 모든 개인에 대한 필터링을 보여 주고, 중첩된 조각에서 정보를 반환합니다.

query {
  companyList(filter: {
    employees: {
      _match: {
        name: {
          _expressions: [
            {
              value: "Smith"
            }
          ]
        }
      }
    }
  }) {
    items {
      name
      ceo {
        name
        firstName
      }
      employees {
        name
        firstName
      }
    }
  }
}

필수 요소 구성과 함께 AEM GraphQL API 사용에 대한 자세한 내용은 다음 자료를 참조하십시오.

다음 단계 whats-next

이제 AEM GraphQL API를 사용하여 Headless 콘텐츠에 액세스하고 쿼리하는 방법을 배웠으므로 REST API를 사용하여 콘텐츠 조각의 콘텐츠에 액세스하고 업데이트하는 방법에 대해 알아볼 수 있습니다.

추가 리소스 additional-resources