스프레드시트 및 JSON
AEM은 Google Docs 및 Word 문서를 마크다운 및 HTML 마크업으로 번역하는 것 외에도 스프레드시트(Microsoft Excel 통합 문서 및 Google 시트)를 웹 사이트 또는 웹 애플리케이션에서 쉽게 사용할 수 있는 JSON 파일로 번역합니다.
이를 통해 테이블 기반 또는 구조화된 콘텐츠를 다양하게 사용할 수 있습니다.
시트 및 시트 구조
시트의 가장 간단한 예는 첫 번째 행을 열 이름으로 사용하고 그 다음 행을 데이터로 사용하는 테이블로 구성됩니다. 예는 다음과 같을 수 있습니다.
sidekick을(를) 통해 미리 보고 게시한 후 AEM은 이 테이블을 해당 .json
리소스에 대한 요청에 제공되는 JSON 표시로 변환합니다. 위의 예제가 다음으로 변환됩니다.
{
"total": 4,
"offset": 0,
"limit": 4,
"data": [
{
"Source": "/sidekick-extension",
"Destination": "https://chromewebstore.google.com/detail/aem-sidekick/igkmdomcgoebiipaifhmpfjhbjccggml"
},
{
"Source": "/github-bot",
"Destination": "https://github.com/apps/helix-bot"
},
{
"Source": "/install-github-bot",
"Destination": "https://github.com/apps/helix-bot/installations/new"
},
{
"Source": "/tutorial",
"Destination": "/developer/tutorial"
}
],
":type": "sheet"
}
AEM을 사용하면 여러 시트가 있는 통합 문서를 관리할 수 있습니다.
- 시트가 하나만 있는 경우 AEM에서는 기본적으로 해당 시트를 정보 소스로 사용합니다.
- 시트가 여러 개 있는 경우 AEM에서는 추가 정보 및 가능한 공식을 웹에 전달되지 않는 동일한 스프레드시트에 보관할 수 있도록 접두사가
shared-
(또는helix-
)인 시트만 전달합니다. - 이름이
shared-default
(또는helix-default
인 시트가 있는 경우, 추가 쿼리 매개 변수가 제공되지 않으면 이 시트가 전달됩니다.
참고: helix-
접두사는 더 이상 사용되지 않으며 보다 중립적인 shared-
접두사를 사용해야 합니다.
특정 시트를 쿼리하는 방법에 대한 자세한 내용은 다음 섹션을 참조하십시오.
쿼리 매개변수
오프셋 및 제한
스프레드시트와 JSON 파일은 매우 커질 수 있습니다. 이러한 경우 AEM에서는 스프레드시트의 어떤 행이 전달되는지를 나타내기 위해 limit
및 offset
쿼리 매개 변수의 사용을 지원합니다.
AEM은 항상 JSON을 압축하므로 일반적으로 페이로드가 비교적 적습니다. 따라서 기본적으로 AEM은 limit
쿼리 매개 변수가 지정되지 않은 경우 반환되는 행 수를 1000으로 제한합니다. 간단한 경우가 많으면 이 정도면 충분합니다.
시트
sheet
쿼리 매개 변수를 사용하면 응용 프로그램에서 스프레드시트나 통합 문서에서 하나 또는 여러 개의 특정 시트를 지정할 수 있습니다. 예를 들어 ?sheet=jobs
은(는) 이름이 shared-jobs
인 시트를 반환하고 ?sheet=jobs&sheet=articles
은(는) 이름이 shared-jobs
및 shared-articles
인 시트에 대한 데이터를 반환합니다.
특수 시트 이름
특정 사용 사례에서는 AEM이 스프레드시트에 쓰기도 하며, 이 경우 특정 시트 이름이 필요합니다.
이러한 서비스에 대한 자세한 내용은 위의 링크를 참조하십시오.
배열
네이티브 배열은 셀 값으로 지원되지 않으므로 문자열로 전달됩니다.
"tags": "[\"Adobe Life\",\"Responsibility\",\"Diversity & Inclusion\"]"
JSON.parse()
을(를) 사용하여 JavaScript에서 배열로 다시 전환할 수 있습니다.