스프레드시트 및 JSON

AEM은 Google 문서 및 Word 문서를 Markdown 및 HTML 마크업으로 변환하는 것 외에도 스프레드시트(Microsoft Excel 통합 문서 및 Google Sheets)를 웹 사이트나 웹 애플리케이션에서 쉽게 사용할 수 있는 JSON 파일로 변환합니다.

이를 통해 테이블 기반 또는 구조화된 콘텐츠를 다양하게 사용할 수 있습니다.

시트 및 시트 구조

시트의 가장 간단한 예는 첫 번째 행을 열 이름으로 사용하고 그 다음 행을 데이터로 사용하는 테이블로 구성됩니다. 예는 다음과 같을 수 있습니다.

미리보기 후 를 통해 게시 사이드 킥, AEM은 이 테이블을 해당 요청에 제공되는 JSON 표시로 변환합니다 .json 리소스. 위의 예제가 다음으로 변환됩니다.

{
  "total": 4,
  "offset": 0,
  "limit": 4,
  "data": [
    {
      "Source": "/sidekick-extension",
      "Destination": "https://chrome.google.com/webstore/detail/helix-sidekick-beta/ccfggkjabjahcjoljmgmklhpaccedipo"
    },
    {
      "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은 접두사가 있는 시트만 전달합니다. helix- 추가 정보 및 가능한 공식을 웹에 전달되지 않은 동일한 스프레드시트에 보관할 수 있습니다.
  • 이름이 인 시트가 있는 경우 helix-default, 제공된 추가 쿼리 매개 변수가 없으면 배달됩니다.

특정 시트를 쿼리하는 방법에 대한 자세한 내용은 다음 섹션을 참조하십시오.

쿼리 매개변수

오프셋 및 제한

스프레드시트와 JSON 파일은 매우 커질 수 있습니다. 이러한 경우 AEM은 의 사용을 지원합니다 limitoffset 게재되는 스프레드시트의 행을 나타내는 쿼리 매개 변수.

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

시트

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

특수 시트 이름

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

  • 양식 서비스 은(는) 이름이 인 시트에만 씁니다. incoming: JSON으로 제공되지 않습니다.
  • 색인 서비스 은(는) 이름이 인 시트에만 씁니다. raw_index: 간단한 단일 시트 설정에서 JSON에 전달될 수 있습니다.

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

배열

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

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

를 사용하여 JavaScript에서 배열로 되돌릴 수 있습니다. JSON.parse().

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