샘플 콘텐츠 및 쿼리를 탐색하여 AEM과 함께 GraphQL을 사용하여 headless로 콘텐츠를 제공하는 방법을 알아봅니다.
이 페이지는 다음과 함께 읽어야 합니다.
GraphQL 쿼리를 시작하고 쿼리가 AEM 콘텐츠 조각과 함께 작동하는 방식을 살펴보려면 몇 가지 실제 사례를 살펴보는 것이 좋습니다.
도움이 필요하면 다음을 참조하십시오.
일부 샘플 GraphQL 쿼리, 샘플 콘텐츠 조각 구조(콘텐츠 조각 모델 및 관련 콘텐츠 조각)를 기반으로 합니다.
샘플 결과와 더불어 쿼리 만들기에 대한 설명은 이 샘플 쿼리를 참조하십시오.
인스턴스에 따라 AEM GraphQL API에 포함된 GraphiQL 인터페이스 쿼리 제출 및 테스트용.
예를 들어http://localhost:4502/content/graphiql.html
샘플 쿼리는 GraphQL과 함께 사용하기 위한 샘플 콘텐츠 조각 구조를 기반으로 합니다.
이 샘플 쿼리는 모두 반환합니다 types
사용 가능한 모든 스키마.
샘플 쿼리
{
__schema {
types {
name
description
}
}
}
샘플 결과:
{
"data": {
"__schema": {
"types": [
{
"name": "AdventureModel",
"description": null
},
{
"name": "AdventureModelArrayFilter",
"description": null
},
{
"name": "AdventureModelFilter",
"description": null
},
{
"name": "AdventureModelResult",
"description": null
},
{
"name": "AdventureModelResults",
"description": null
},
{
"name": "AllFragmentModels",
"description": null
},
{
"name": "ArchiveRef",
"description": null
},
{
"name": "ArrayMode",
"description": null
},
{
"name": "ArticleModel",
"description": null
},
...more results...
{
"name": "__EnumValue",
"description": null
},
{
"name": "__Field",
"description": null
},
{
"name": "__InputValue",
"description": null
},
{
"name": "__Schema",
"description": "A GraphQL Introspection defines the capabilities of a GraphQL server. It exposes all available types and directives on the server, the entry points for query, mutation, and subscription operations."
},
{
"name": "__Type",
"description": null
},
{
"name": "__TypeKind",
"description": "An enum describing what kind of type a given __Type is"
}
]
}
}
}
모든 도시에 대한 모든 정보를 검색하려면 다음과 같은 기본 쿼리를 사용하면 됩니다.
샘플 쿼리
{
cityList {
items
}
}
실행 시 시스템은 모든 필드를 포함하도록 쿼리를 자동으로 확장합니다.
{
cityList {
items {
_path
name
country
population
}
}
}
샘플 결과:
{
"data": {
"cityList": {
"items": [
{
"_path": "/content/dam/sample-content-fragments/cities/basel",
"name": "Basel",
"country": "Switzerland",
"population": 172258
},
{
"_path": "/content/dam/sample-content-fragments/cities/berlin",
"name": "Berlin",
"country": "Germany",
"population": 3669491
},
{
"_path": "/content/dam/sample-content-fragments/cities/bucharest",
"name": "Bucharest",
"country": "Romania",
"population": 1821000
},
{
"_path": "/content/dam/sample-content-fragments/cities/san-francisco",
"name": "San Francisco",
"country": "USA",
"population": 883306
},
{
"_path": "/content/dam/sample-content-fragments/cities/san-jose",
"name": "San Jose",
"country": "USA",
"population": 1026350
},
{
"_path": "/content/dam/sample-content-fragments/cities/stuttgart",
"name": "Stuttgart",
"country": "Germany",
"population": 634830
},
{
"_path": "/content/dam/sample-content-fragments/cities/zurich",
"name": "Zurich",
"country": "Switzerland",
"population": 415367
}
]
}
}
}
이 샘플 쿼리는 다음을 반환하는 간단한 쿼리입니다. name
의 모든 항목 city
스키마.
샘플 쿼리
query {
cityList {
items {
name
}
}
}
샘플 결과:
{
"data": {
"cityList": {
"items": [
{
"name": "Basel"
},
{
"name": "Berlin"
},
{
"name": "Bucharest"
},
{
"name": "San Francisco"
},
{
"name": "San Jose"
},
{
"name": "Stuttgart"
},
{
"name": "Zurich"
}
]
}
}
}
이 샘플 쿼리는 저장소의 특정 위치에 있는 단일 조각 항목의 세부 정보를 반환하는 쿼리입니다.
샘플 쿼리
{
cityByPath (_path: "/content/dam/sample-content-fragments/cities/berlin") {
item {
_path
name
country
population
categories
}
}
}
샘플 결과:
{
"data": {
"cityByPath": {
"item": {
"_path": "/content/dam/sample-content-fragments/cities/berlin",
"name": "Berlin",
"country": "Germany",
"population": 3669491,
"categories": [
"city:capital",
"city:emea"
]
}
}
}
}
이름이 "Berlin Center"인 변형을 만드는 경우(berlin_centre
), city
Berlin에서는 쿼리를 사용하여 변형의 세부 정보를 반환할 수 있습니다.
샘플 쿼리
{
cityList (variation: "berlin_center") {
items {
_path
name
country
population
categories
}
}
}
샘플 결과:
{
"data": {
"cityList": {
"items": [
{
"_path": "/content/dam/sample-content-fragments/cities/berlin",
"name": "Berlin",
"country": "Germany",
"population": 3669491,
"categories": [
"city:capital",
"city:emea"
]
}
]
}
}
}
다음과 같은 경우:
Tourism
: Business
, City Break
, Holiday
City
인스턴스그런 다음 쿼리를 사용하여 name
및 tags
의 모든 게시물에 도시 브레이크로 태그가 지정됨 city
스키마.
샘플 쿼리
query {
cityList(
includeVariations: true,
filter: {_tags: {_expressions: [{value: "tourism:city-break", _operator: CONTAINS}]}}
){
items {
name,
_tags
}
}
}
샘플 결과:
{
"data": {
"cityList": {
"items": [
{
"name": "Berlin",
"_tags": [
"tourism:city-break",
"tourism:business"
]
},
{
"name": "Zurich",
"_tags": [
"tourism:city-break",
"tourism:business"
]
}
]
}
}
}
중첩된 조각의 구조를 사용하여 이 쿼리는 회사 CEO와 모든 직원의 전체 세부 정보를 반환합니다.
샘플 쿼리
query {
companyList {
items {
name
ceo {
_path
name
firstName
awards {
id
title
}
}
employees {
name
firstName
awards {
id
title
}
}
}
}
}
샘플 결과:
{
"data": {
"companyList": {
"items": [
{
"name": "Apple Inc.",
"ceo": {
"_path": "/content/dam/sample-content-fragments/persons/steve-jobs",
"name": "Jobs",
"firstName": "Steve",
"awards": []
},
"employees": [
{
"name": "Marsh",
"firstName": "Duke",
"awards": []
},
{
"name": "Caulfield",
"firstName": "Max",
"awards": [
{
"id": "GB",
"title": "Gameblitz"
}
]
}
]
},
{
"name": "Little Pony, Inc.",
"ceo": {
"_path": "/content/dam/sample-content-fragments/persons/adam-smith",
"name": "Smith",
"firstName": "Adam",
"awards": []
},
"employees": [
{
"name": "Croft",
"firstName": "Lara",
"awards": [
{
"id": "GS",
"title": "Gamestar"
}
]
},
{
"name": "Slade",
"firstName": "Cutter",
"awards": [
{
"id": "GB",
"title": "Gameblitz"
},
{
"id": "GS",
"title": "Gamestar"
}
]
}
]
},
{
"name": "NextStep Inc.",
"ceo": {
"_path": "/content/dam/sample-content-fragments/persons/steve-jobs",
"name": "Jobs",
"firstName": "Steve",
"awards": []
},
"employees": [
{
"name": "Smith",
"firstName": "Joe",
"awards": []
},
{
"name": "Lincoln",
"firstName": "Abraham",
"awards": []
}
]
}
]
}
}
}
이 샘플 쿼리는 모두 필터링합니다. persons
를 나타내는 모든 단어 Jobs
또는 Smith
.
샘플 쿼리
query {
personList(filter: {
name: {
_logOp: OR
_expressions: [
{
value: "Jobs"
},
{
value: "Smith"
}
]
}
}) {
items {
name
firstName
}
}
}
샘플 결과:
{
"data": {
"personList": {
"items": [
{
"name": "Smith",
"firstName": "Adam"
},
{
"name": "Smith",
"firstName": "Joe"
},
{
"name": "Jobs",
"firstName": "Steve"
}
]
}
}
}
이 샘플 쿼리는 모두 필터링합니다. persons
를 나타내는 모든 단어 Jobs
또는 Smith
.
샘플 쿼리
query {
personList(filter: {
name: {
_expressions: [
{
value: "Jobs"
_operator: EQUALS_NOT
}
]
}
}) {
items {
name
firstName
}
}
}
샘플 결과:
{
"data": {
"personList": {
"items": [
{
"name": "Lincoln",
"firstName": "Abraham"
},
{
"name": "Smith",
"firstName": "Adam"
},
{
"name": "Slade",
"firstName": "Cutter"
},
{
"name": "Marsh",
"firstName": "Duke"
},
{
"name": "Smith",
"firstName": "Joe"
},
{
"name": "Croft",
"firstName": "Lara"
},
{
"name": "Caulfield",
"firstName": "Max"
}
]
}
}
}
_path
가 특정 접두사로 시작하는 모든 모험_path
가 특정 접두사로 시작하는 adventures
(/content/dam/wknd/en/adventures/cycling
).
샘플 쿼리
query {
adventureList(
filter: {
_path: {
_expressions: [
{
value: "/content/dam/wknd/en/adventures/cycling"
_operator: STARTS_WITH
}]
}
})
{
items {
_path
}
}
}
샘플 결과:
{
"data": {
"adventureList": {
"items": [
{
"_path": "/content/dam/wknd/en/adventures/cycling-southern-utah/cycling-southern-utah"
},
{
"_path": "/content/dam/wknd/en/adventures/cycling-tuscany/cycling-tuscany"
}
]
}
}
}
여기에서는 필드 조합이 필터링됩니다. An AND
(묵시적)는 population
범위를 선택하는 데 사용되며, OR
(명시적)는 필요한 도시를 선택하는 데 사용됩니다.
샘플 쿼리
query {
cityList(filter: {
population: {
_expressions: [
{
value: 400000
_operator: GREATER_EQUAL
}, {
value: 1000000
_operator: LOWER
}
]
},
country: {
_logOp: OR
_expressions: [
{
value: "Germany"
}, {
value: "Switzerland"
}
]
}
}) {
items {
name
population
country
}
}
}
샘플 결과:
{
"data": {
"cityList": {
"items": [
{
"name": "Stuttgart",
"population": 634830,
"country": "Germany"
},
{
"name": "Zurich",
"population": 415367,
"country": "Switzerland"
}
]
}
}
}
이 쿼리는 대소문자에 관계없이 이름에 SAN
이 있는 모든 도시에 대한 정보를 얻습니다.
샘플 쿼리
query {
cityList(filter: {
name: {
_expressions: [
{
value: "SAN"
_operator: CONTAINS
_ignoreCase: true
}
]
}
}) {
items {
name
population
country
}
}
}
샘플 결과:
{
"data": {
"cityList": {
"items": [
{
"name": "San Francisco",
"population": 883306,
"country": "USA"
},
{
"name": "San Jose",
"population": 1026350,
"country": "USA"
}
]
}
}
}
이 쿼리는 적어도 한 번은 발생해야 하는 항목(city:na
)이 있는 배열을 필터링합니다.
샘플 쿼리
query {
cityList(filter: {
categories: {
_expressions: [
{
value: "city:na"
_apply: AT_LEAST_ONCE
}
]
}
}) {
items {
name
population
country
categories
}
}
}
샘플 결과:
{
"data": {
"cityList": {
"items": [
{
"name": "San Francisco",
"population": 883306,
"country": "USA",
"categories": [
"city:beach",
"city:na"
]
},
{
"name": "San Jose",
"population": 1026350,
"country": "USA",
"categories": [
"city:na"
]
}
]
}
}
}
이 쿼리는 정확한 배열 값을 필터링합니다.
샘플 쿼리
query {
cityList(filter: {
categories: {
_expressions: [
{
values: [
"city:beach",
"city:na"
]
}
]
}
}) {
items {
name
population
country
categories
}
}
}
샘플 결과:
{
"data": {
"cityList": {
"items": [
{
"name": "San Francisco",
"population": 883306,
"country": "USA",
"categories": [
"city:beach",
"city:na"
]
}
]
}
}
}
이 쿼리는 name
이 “Smith”인 모든 person
에 대한 필터링을 보여 주고, 두 가지 중첩된 조각(company
및 employee
)에서 정보를 반환합니다.
샘플 쿼리
query {
companyList(filter: {
employees: {
_match: {
name: {
_expressions: [
{
value: "Smith"
}
]
}
}
}
}) {
items {
name
ceo {
name
firstName
}
employees {
name
firstName
}
}
}
}
샘플 결과:
{
"data": {
"companyList": {
"items": [
{
"name": "NextStep Inc.",
"ceo": {
"name": "Jobs",
"firstName": "Steve"
},
"employees": [
{
"name": "Smith",
"firstName": "Joe"
},
{
"name": "Lincoln",
"firstName": "Abraham"
}
]
}
]
}
}
}
이 쿼리는 세 가지 중첩된 조각(company
, employee
, award
)에 대한 필터링을 보여 줍니다.
샘플 쿼리
query {
companyList(filter: {
employees: {
_apply: ALL
_match: {
awards: {
_match: {
id: {
_expressions: [
{
value: "GS"
_operator:EQUALS
}
]
}
}
}
}
}
}) {
items {
name
ceo {
name
firstName
}
employees {
name
firstName
awards {
id
title
}
}
}
}
}
샘플 결과:
{
"data": {
"companyList": {
"items": [
{
"name": "Little Pony, Inc.",
"ceo": {
"name": "Smith",
"firstName": "Adam"
},
"employees": [
{
"name": "Croft",
"firstName": "Lara",
"awards": [
{
"id": "GS",
"title": "Gamestar"
}
]
},
{
"name": "Slade",
"firstName": "Cutter",
"awards": [
{
"id": "GB",
"title": "Gameblitz"
},
{
"id": "GS",
"title": "Gamestar"
}
]
}
]
}
]
}
}
}
이 쿼리는 세 가지 중첩된 조각(company
, employee
, award
)에 대한 필터링을 보여 줍니다.
샘플 쿼리
query {
awardList(filter: {
id: {
_expressions: [
{
value:"GB"
}
]
}
}) {
items {
_metadata {
stringMetadata {
name,
value
}
}
id
title
}
}
}
샘플 결과:
{
"data": {
"awardList": {
"items": [
{
"_metadata": {
"stringMetadata": [
{
"name": "title",
"value": "Gameblitz Award"
},
{
"name": "description",
"value": ""
}
]
},
"id": "GB",
"title": "Gameblitz"
}
]
}
}
}
이러한 샘플 쿼리는 WKND 프로젝트를 기반으로 합니다. 여기에는 다음과 같은 항목이 있습니다.
콘텐츠 조각 모델은 다음에서 사용할 수 있습니다.
http://<hostname>:<port>/libs/dam/cfm/models/console/content/models.html/conf/wknd
콘텐츠 조각(및 기타 콘텐츠)은 다음에서 사용할 수 있습니다.
http://<hostname>:<port>/assets.html/content/dam/wknd/en
결과가 광범위할 수 있으므로 여기에서 재현하지는 않습니다.
이 샘플 쿼리는 다음에 대한 정보를 얻습니다.
article
유형의 모든 콘텐츠 조각path
및 author
속성 포함.샘플 쿼리
{
articleList {
items {
_path
author
}
}
}
이 쿼리는 다음에 대한 정보를 얻습니다.
adventure
유형의 모든 콘텐츠 조각샘플 쿼리
{
adventureList {
items {
_path,
_metadata {
stringMetadata {
name,
value
}
stringArrayMetadata {
name,
value
}
intMetadata {
name,
value
}
intArrayMetadata {
name,
value
}
floatMetadata {
name,
value
}
floatArrayMetadata {
name,
value
}
booleanMetadata {
name,
value
}
booleanArrayMetadata {
name,
value
}
calendarMetadata {
name,
value
}
calendarArrayMetadata {
name,
value
}
}
}
}
}
이 샘플 쿼리는 다음에 대한 정보를 얻습니다.
article
유형의 단일 콘텐츠 조각
샘플 쿼리
{
articleByPath (_path: "/content/dam/wknd/en/magazine/alaska-adventure/alaskan-adventures") {
item {
_path
author
main {
html
markdown
plaintext
json
}
}
}
}
이 샘플 쿼리는 다음에 대한 정보를 얻습니다.
샘플 쿼리
{
adventureByPath(_path: "/content/dam/wknd/en/adventures/riverside-camping-australia/riverside-camping-australia") {
item {
_path
adventureTitle
_model {
_path
title
}
}
}
}
이 쿼리는 다음에 대한 정보를 얻습니다.
article
유형의 단일 콘텐츠 조각
referencearticle
필드에는 fragment-reference
데이터 형식이 있습니다.
샘플 쿼리
{
adventureByPath(_path: "/content/dam/wknd-shared/en/magazine/western-australia/western-australia-by-camper-van") {
item {
_path
title
_model {
_path
title
}
}
}
}
이 쿼리는 다음에 대한 정보를 얻습니다.
bookmark
유형의 복수 콘텐츠 조각
Article
의 다른 조각에 대한 조각 참조 포함fragments
필드에는 fragment-reference
데이터 유형이 있고, Article
모델이 선택됩니다. 쿼리는 fragments
의 배열로 [Article]
제공.
{
bookmarkList {
items {
fragments {
_path
author
}
}
}
}
이 쿼리는 다음에 대한 정보를 얻습니다.
bookmark
유형의 복수 콘텐츠 조각
Article
및 Adventure
의 다른 조각에 대한 조각 참조 포함fragments
필드에는 fragment-reference
데이터 유형이 있고, Article
, Adventure
모델이 선택됩니다. 쿼리는 공용 구조체 형식으로 참조되지 않은 [AllFragmentModels]
의 배열로 fragments
을 제공합니다.
{
bookmarkList {
items {
fragments {
... on ArticleModel {
_path
author
}
... on AdventureModel {
_path
adventureTitle
}
}
}
}
}
이 쿼리에는 다음과 같은 두 가지 버전이 있습니다.
attachments
유형의 특정 콘텐츠 참조 반환.이들 쿼리는 다음에 대한 정보를 얻습니다.
bookmark
유형의 복수 콘텐츠 조각
다음 쿼리는 _references
를 사용하여 모든 콘텐츠 참조를 반환합니다.
{
bookmarkList {
_references {
... on ImageRef {
_path
type
height
}
... on MultimediaRef {
_path
type
size
}
... on DocumentRef {
_path
type
author
}
... on ArchiveRef {
_path
type
format
}
}
items {
_path
}
}
}
다음 쿼리는 모두 반환합니다 attachments
- 유형의 특정 필드(하위 그룹) content-reference
:
attachments
필드에는 content-reference
데이터 형식이 있고, 다양한 형태가 선택되어 있습니다.
{
bookmarkList {
items {
attachments {
... on PageRef {
_path
type
}
... on ImageRef {
_path
width
}
... on MultimediaRef {
_path
size
}
... on DocumentRef {
_path
author
}
... on ArchiveRef {
_path
format
}
}
}
}
}
이 쿼리는 다음에 대한 정보를 얻습니다.
bookmark
유형의 단일 콘텐츠 조각
RTE 인라인 참조는 _references
에서 하이드레이션됩니다.
샘플 쿼리
{
bookmarkByPath(_path: "/content/dam/wknd/en/bookmarks/skitouring") {
item {
_path
description {
json
}
}
_references {
... on ArticleModel {
_path
}
... on AdventureModel {
_path
}
... on ImageRef {
_path
}
... on MultimediaRef {
_path
}
... on DocumentRef {
_path
}
... on ArchiveRef {
_path
}
}
}
}
이 쿼리는 다음에 대한 정보를 얻습니다.
article
유형의 단일 콘텐츠 조각
variation1
샘플 쿼리
{
articleByPath (_path: "/content/dam/wknd/en/magazine/alaska-adventure/alaskan-adventures", variation: "variation1") {
item {
_path
author
main {
html
markdown
plaintext
json
}
}
}
}
이 쿼리는 다음에 대한 정보를 얻습니다.
variation1
이 포함된 article
유형의 콘텐츠 조각샘플 쿼리
{
articleList (variation: "variation1") {
items {
_path
author
main {
html
markdown
plaintext
json
}
}
}
}
이 쿼리는 다음에 대한 정보를 얻습니다.
article
및 모든 변형샘플 쿼리
query {
articleList(
includeVariations: true ){
items {
_variation
_path
_tags
_metadata {
stringArrayMetadata {
name
value
}
}
}
}
}
이 쿼리는 다음에 대한 정보를 얻습니다.
article
하나 이상의 변형 포함(태그 포함) WKND : Activity / Hiking
샘플 쿼리
{
articleList(
includeVariations: true,
filter: {_tags: {_expressions: [{value: "wknd:activity/hiking", _operator: CONTAINS}]}}
){
items {
_variation
_path
_tags
_metadata {
stringArrayMetadata {
name
value
}
}
}
}
}
이 쿼리는 다음에 대한 정보를 얻습니다.
fr
로케일 안에 있는 article
유형의 콘텐츠 조각샘플 쿼리
{
articleList (_locale: "fr") {
items {
_path
author
main {
html
markdown
plaintext
json
}
}
}
}
샘플 쿼리는 다음 구조를 기반으로 합니다. 사용:
하나 이상의 샘플 콘텐츠 조각 구조 모델 - GraphQL 스키마의 기반 형성
위 모델을 기반으로 하는 샘플 콘텐츠 모델
샘플 쿼리의 경우 다음 콘텐츠 모델 및 해당 상호 관계를 사용합니다(참조 ->).
회사를 정의하는 기본 필드는 다음과 같습니다.
필드 이름 | 데이터 형식 | 참조 |
---|---|---|
회사 이름 | 한 줄 텍스트 | |
CEO | 조각 참조 (단일) | 개인 |
직원 | 조각 참조 (다중 필드) | 개인 |
직원일 수도 있는 사람을 정의하는 필드입니다.
필드 이름 | 데이터 형식 | 참조 |
---|---|---|
이름 | 한 줄 텍스트 | |
이름 | 한 줄 텍스트 | |
상 | 조각 참조 (다중 필드) | 상 |
상을 정의하는 필드는 다음과 같습니다.
필드 이름 | 데이터 형식 | 참조 |
---|---|---|
단축키/ID | 한 줄 텍스트 | |
제목 | 한 줄 텍스트 |
도시를 정의하는 필드는 다음과 같습니다.
필드 이름 | 데이터 형식 | 참조 |
---|---|---|
이름 | 한 줄 텍스트 | |
국가 | 한 줄 텍스트 | |
인구 | 숫자 | |
범주 | 태그 |
다음 조각이 적절한 모델에 사용됩니다.
회사 이름 | CEO | 직원 |
---|---|---|
Apple | Steve Jobs | Duke Marsh Max Caulfield |
Little Pony Inc. | Adam Smith | Lara Croft Cutter Slade |
NextStep Inc. | Steve Jobs | Joe Smith Abe Lincoln |
이름 | 이름 | 상 |
---|---|---|
Lincoln | Abe | |
Smith | Adam | |
Slade | Cutter | Gameblitz Gamestar |
Marsh | Duke | |
Smith | Joe | |
Croft | Lara | Gamestar |
Caulfield | Max | Gameblitz |
Jobs | Steve |
단축키/ID | 제목 |
---|---|
GB | Gameblitz |
GS | Gamestar |
OSC | Oscar |
이름 | 국가 | 인구 | 범주 |
---|---|---|---|
바젤 | 스위스 | 172258 | city:emea |
베를린 | 독일 | 3669491 | city:capital city:emea |
부쿠레슈티 | 루마니아 | 1821000 | city:capital city:emea |
샌프란시스코 | 미국 | 883306 | city:beach city:na |
새너제이 | 미국 | 102635 | city:na |
슈투트가르트 | 독일 | 634830 | city:emea |
취리히 | 스위스 | 415367 | city:capital city:emea |