스프레드시트를 사용하여 표 형식 데이터 관리

마지막 업데이트: 2025년 2월 14일

작성 대상:

  • 관리자
  • 개발자

스프레드시트를 사용하여 Edge Delivery Services 사이트를 통해 AEM에 대한 메타데이터 및 리디렉션과 같은 다양한 값에 대한 표 형식 데이터를 관리하는 방법을 알아봅니다.

사용 사례

Edge Delivery Services 사이트가 포함된 AEM의 경우 키-값 매핑과 같은 표 형식 데이터 목록을 유지 관리해야 합니다. 이는 메타데이터 및 리디렉션과 같은 다양한 값의 목록일 수 있습니다. Edge Deliver Services를 사용하면 직관적인 도구인 스프레드시트를 사용하여 이러한 표 형식 목록을 유지 관리할 수 있습니다. AEM은 이러한 스프레드시트를 웹 사이트 또는 웹 애플리케이션에서 쉽게 사용할 수 있는 JSON 파일로 변환합니다.

일반적인 사용 사례는 다음과 같습니다.

또한 모든 구조의 스프레드시트를 만들어 원하는 목적에 맞게 매핑을 저장할 수 있습니다.

이 문서에서는 리디렉션의 예를 사용하여 이러한 스프레드시트를 만드는 방법을 보여 줍니다. 각 사용 사례에 대한 자세한 내용은 Edge Delivery Services 설명서에서 이전에 링크된 주제를 참조하십시오.

TIP
일반적으로 스프레드시트가 Edge Delivery Services와 작동하는 방식에 대한 자세한 내용은 스프레드시트 및 JSON 문서를 참조하십시오.
TIP
스프레드시트는 표 형식의 데이터를 유지하는 데만 사용해야 합니다. 구조화된 데이터를 저장하려면 AEM의 Headless 기능을 확인하십시오.

사전 요구 사항

Edge Delivery Services 프로젝트가 포함된 AEM에서 스프레드시트를 사용하여 매핑을 만들려면 최신 사이트 템플릿을 사용하여 사이트를 만들어야 합니다.

자세한 내용은 Edge Delivery Services를 사용한 WYSIWYG 작성용 개발자 시작 안내서 문서를 참조하십시오.

스프레드시트 만들기

이 예에서는 Edge Delivery Services 사이트를 사용하여 AEM에 대한 리디렉션을 관리하는 스프레드시트를 만듭니다. 만들려는 다른 스프레드시트 유형에도 동일한 단계가 적용됩니다.

  1. AEM as a Cloud Service 작성 인스턴스에 로그인하고 Sites 콘솔로 이동한 후 스프레드시트가 필요한 사이트의 루트로 이동합니다. 만들기 -> 페이지 ​를 탭하거나 클릭합니다.

    페이지 제작

  2. 페이지 만들기 마법사의 템플릿 탭에서 리디렉션 템플릿을 탭하거나 클릭하여 선택한 다음 다음 ​을 탭하거나 클릭합니다.

    템플릿 선택

  3. 마법사의 속성 탭에는 리디렉션 스프레드시트의 기본값이 표시됩니다. 만들기 ​를 탭하거나 클릭합니다.

    • 제목 - 이 값은 그대로 둡니다.

    • 열 - 리디렉션에 필요한 최소 열이 미리 채워져 있습니다.

      • 소스 - 리디렉션할 페이지
      • 대상 - 리디렉션할 대상 페이지

    스프레드시트의 속성

  4. 성공 대화 상자에서 열기 ​를 탭하거나 클릭합니다.

    완료 대화 상자

  5. 사전 정의된 소스 및 대상 열이 있는 스프레드시트가 편집기에 로드된 새 탭이 열립니다. 리디렉션을 정의하려면 소스 열의 빈 행을 탭하거나 클릭합니다. 스프레드시트를 편집하면 변경 사항이 자동으로 저장됩니다.

    스프레드시트 편집

    • 소스 ​는 웹 사이트 도메인에 상대적이므로 상대 경로만 포함됩니다.
    • 대상 ​은 다른 웹 사이트로 리디렉션하는 경우 정규화된 URL일 수 있고, 자체 웹 사이트 내에서 리디렉션하는 경우 상대 경로일 수 있습니다.
    • 다음 셀로 포커스를 이동하려면 Tab 키를 사용합니다.
    • 편집기는 필요에 따라 스프레드시트에 새 행을 추가합니다.
    • 행을 삭제하거나 이동하려면 각 행 끝에 있는 삭제 아이콘과 각 행 시작에 있는 드래그 핸들을 각각 사용합니다.

스프레드시트 데이터 가져오기

AEM 페이지 편집기에서 스프레드시트를 편집하는 것 외에도 CSV 파일에서 데이터를 가져올 수 있습니다.

  1. AEM에서 스프레드시트를 편집할 때 화면의 왼쪽 상단에 있는 업로드 버튼을 탭하거나 클릭합니다.

  2. 드롭다운에서 데이터를 가져오는 방법을 선택합니다.

    • 문서 바꾸기 ​를 클릭하여 전체 스프레드시트 콘텐츠를 업로드할 CSV 파일 콘텐츠로 대체합니다.
    • 문서에 추가 ​를 클릭하여 업로드할 CSV 파일의 데이터를 기존 스프레드시트 콘텐츠에 추가합니다.

  3. 대화 상자가 열리면 CSV 파일을 선택한 다음 열기 ​를 탭하거나 클릭합니다.

가져오기가 처리되면 대화 상자가 열립니다. 완료되면 CSV 파일의 데이터가 스프레드시트 콘텐츠에 추가되거나 해당 콘텐츠를 대체합니다. 열 불일치와 같은 오류가 발생하면 이를 보고하여 CSV 파일을 수정할 수 있습니다.

NOTE
  • CSV 파일의 머리글은 스프레드시트의 열과 정확히 일치해야 합니다.
  • 전체 CSV를 가져와도 열 머리글은 수정되지 않고 콘텐츠 행만 수정됩니다.
  • 열을 업데이트해야 할 경우 CSV 가져오기를 수행하기 전에 AEM 페이지 편집기에서 업데이트해야 합니다.
  • 가져오기 할 때 CSV 파일은 10MB보다 클 수 없습니다.

mode의 선택 내용에 따라 다음과 유사한 CSV 및 cURL 명령을 사용하여 스프레드시트를 create, replace하거나 스프레드시트에 append할 수도 있습니다.

curl --request POST \
  --url http://<aem-instance>/bin/asynccommand \
  --header 'content-type: multipart/form-data' \
  --form file=@/path/to/your.csv \
  --form spreadsheetPath=/content/<your-site>/<your-spreadsheet> \
  --form 'spreadsheetTitle=Your Spreadsheet' \
  --form cmd=spreadsheetImport \
  --form operation=asyncSpreadsheetImport \
  --form _charset_=utf-8 \
  --form mode=append

작업 ID에 대한 정보가 제공되면 호출에서 HTML 페이지를 반환합니다.

Message | Job(Id:2024/9/18/15/27/5cb0cacc-585d-4176-b018-b684ad2dfd02_90) created successfully. Please check status at Async Job Status Navigation.

작업 콘솔을 사용하여 작업 상태를 보거나 반환된 ID를 사용하여 작업을 쿼리할 수 있습니다.

https://<aem-instance>/bin/asynccommand?optype=JOBINF&jobid=2024/10/24/14/1/8da63f9e-066b-4134-95c9-21a9c57836a5_1

스프레드시트 paths.json 게시

AEM에서 스프레드시트의 데이터를 게시하려면 프로젝트의 paths.json 파일을 추가로 업데이트해야 합니다.

  1. GitHub에서 프로젝트의 루트를 엽니다.

  2. paths.json 파일을 탭하거나 클릭하여 세부 정보를 연 다음 편집 아이콘을 엽니다.

    paths.json 파일

  3. 새 스프레드시트를 redirects.json 리소스에 매핑하는 줄을 추가합니다.

    {
  "mappings": [
   "/content/<site-name>/:/",
   "/content/<site-name>/redirects:/redirects.json"
  ]
}
    NOTE
    이 paths.json 항목은 표 형식 데이터를 사용하여 리디렉션을 생성하는 예제를 기반으로 합니다. 생성하려는 스프레드시트 유형에 맞는 경로를 업데이트해야 합니다.

  4. 변경 사항 커밋… ​을 클릭하여 main에 변경 사항을 저장합니다.

    • 프로세스에 따라 main에 커밋하거나 가져오기 요청을 만듭니다.

  5. 리디렉션 정의를 마치고 경로 매핑을 업로드했으면 Sites 콘솔로 돌아갑니다.

  6. 콘솔에서 만든 리디렉션 스프레드시트를 탭하거나 클릭하여 선택한 다음 작업 표시줄에서 빠른 게시 ​를 탭하거나 클릭하여 스프레드시트를 게시합니다.

    Sites 콘솔에서 스프레드시트 선택

  7. 빠른 게시 대화 상자에서 게시 ​를 탭하거나 클릭합니다.

    게시 확인

  8. 배너가 게시를 확인합니다.

    게시에 대한 배너 확인

이제 리디렉션 스프레드시트가 게시되어 공개적으로 액세스할 수 있는 상태입니다.

TIP
경로 매핑에 대한 자세한 내용은 Edge Delivery Services용 경로 매핑 문서를 참조하십시오.

기타 스프레드시트 유형

이제 리디렉션 스프레드시트를 만드는 방법을 알았으므로 다음과 같은 다른 표준 스프레드시트 유형을 만들 수 있습니다.

스프레드시트 만들기 및 paths.json 업데이트 섹션의 단계를 동일하게 따르고, 적절한 템플릿을 선택하고, paths.json 파일을 적절하게 업데이트하십시오.

구성, 헤더 및 메타데이터의 경우 기본 위치에 게시되도록 하는 매핑을 추가해야 합니다.

  • 구성: /.helix/config.json
  • 헤더: /.helix/headers.json
  • 메타데이터: /metadata.json
  • 분류 체계: 자세한 내용은 분류 체계 데이터 관리 문서를 참조하십시오.

또한 자체 용도를 위한 임의의 열을 사용해 자체 스프레드시트를 만들 수 있습니다.

NOTE
Edge Delivery Services 프로젝트를 사용하여 AEM as a Cloud Service에 대한 인덱싱을 관리하기 위해 스프레드시트를 만들 필요는 없습니다.
자체 인덱스를 만들고 싶다면 이 설명서에 따라 자체 helix-query.yaml 파일을 만들 수 있습니다.

자체 스프레드시트 만들기

  1. 스프레드시트 만들기 섹션의 단계를 동일하게 따릅니다.

  2. 템플릿을 선택할 때 스프레드시트 ​를 선택합니다.

  3. 마법사의 속성 탭에서 자체 열을 추가할 수 있습니다.

    자체 열 추가

    • 열 섹션에서 추가 ​를 탭하거나 클릭하여 새 열을 추가합니다.
    • 열의 이름을 입력합니다.
    • 삭제 및 드래그 핸들 아이콘을 각각 사용하여 열을 제거하거나 재구성합니다.

  4. 리디렉션 스프레드시트에 대한 지침에 따라 스프레드시트를 만들고 게시합니다.

  5. 리디렉션 스프레드시트의 지침에 따라 paths.json 파일에 매핑을 추가합니다.

Experience Manager