스프레드시트 및 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에서는 스프레드시트의 어떤 행이 전달되는지를 나타내기 위해 limitoffset 쿼리 매개 변수의 사용을 지원합니다.

AEM은 항상 JSON을 압축하므로 일반적으로 페이로드가 비교적 적습니다. 따라서 기본적으로 AEM은 limit 쿼리 매개 변수가 지정되지 않은 경우 반환되는 행 수를 1000으로 제한합니다. 간단한 경우가 많으면 이 정도면 충분합니다.

시트

sheet 쿼리 매개 변수를 사용하면 응용 프로그램에서 스프레드시트나 통합 문서에서 하나 또는 여러 개의 특정 시트를 지정할 수 있습니다. 예를 들어 ?sheet=jobs은(는) 이름이 shared-jobs인 시트를 반환하고 ?sheet=jobs&sheet=articles은(는) 이름이 shared-jobsshared-articles인 시트에 대한 데이터를 반환합니다.

특수 시트 이름

특정 사용 사례에서는 AEM이 스프레드시트에 쓰기도 하며, 이 경우 특정 시트 이름이 필요합니다.

  • Forms 서비스에서 JSON으로 배달되지 않는 incoming(이)라는 시트에만 씁니다.
  • 인덱스 서비스raw_index(이)라는 시트에만 쓰며, 이 시트는 간단한 단일 시트 설정에서 JSON에 전달될 수 있습니다.

이러한 서비스에 대한 자세한 내용은 위의 링크를 참조하십시오.

배열

네이티브 배열은 셀 값으로 지원되지 않으므로 문자열로 전달됩니다.

"tags": "[\"Adobe Life\",\"Responsibility\",\"Diversity & Inclusion\"]"

JSON.parse()을(를) 사용하여 JavaScript에서 배열로 다시 전환할 수 있습니다.

recommendation-more-help
10a6ce9d-c5c5-48d9-8ce1-9797d2f0f3ec