분류 체계 데이터 관리

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

작성 대상:

  • 관리자
  • 개발자

Edge Delivery Services 사이트에서 AEM과 함께 태그를 사용하기 위한 분류 체계 데이터 관리 방법을 알아봅니다.

소개

태그 지정은 페이지를 구성하고 관리하는 데 도움이 되는 중요한 기능입니다. AEM의 태그 지정 콘솔을 사용하면 페이지를 구성할 수 있는 태그 분류 체계를 만들 수 있습니다.

이러한 태그는 사용자와 작성자가 콘텐츠를 구성하는 데 유용할 뿐만 아니라 독자에게도 유용할 수 있습니다. 태그와 태그 분류 체계는 페이지의 구성 요소에서 사용하여 독자가 콘텐츠를 탐색하는 데 도움이 될 수 있습니다.

범용 편집기는 태그의 ID로만 작동합니다. 콘텐츠에 대한 분류 체계 페이지를 만들면 모든 언어로 된 이러한 태그의 설명을 범용 편집기에 노출하여 콘텐츠 렌더링 시 해당 정보를 사용할 수 있도록 합니다.

TIP
분류법으로 작업할 수 있는 범용 편집기에서 사용할 수 있는 AEM 태그 필드에 대한 자세한 내용은 모델 정의, 필드 및 구성 요소 유형 문서를 참조하십시오.

분류 체계 페이지 만들기

분류 체계는 AEM의 다른 페이지와 마찬가지로 작성됩니다.

  1. Sites 콘솔로 이동합니다.

  2. 분류 체계를 만들려는 위치를 선택합니다.

  3. 만들기 -> 페이지 ​를 탭하거나 클릭합니다.

    페이지 제작

  4. 페이지 만들기 마법사의 템플릿 탭에서 분류 체계 템플릿을 선택하고 다음 ​을 탭하거나 클릭합니다.

    분류 체계 템플릿

  5. 페이지 만들기 마법사의 속성 탭에서 페이지에 의미 있는 제목 ​을 입력하고 태그 필드에서 태그 선택기를 사용하여 분류 체계에 포함할 태그 또는 네임스페이스를 선택합니다.

    분류 체계 속성

  6. 만들기 ​를 탭하거나 클릭합니다.

분류 체계 페이지가 생성되었습니다. 성공 대화상자에서 완료 대화상자를 탭하거나 클릭하여 메시지를 삭제하거나 열기 ​를 탭하여 페이지 편집기에서 페이지를 편집합니다.

다음 단계에서 사용할 분류 체계 페이지의 결과 페이지 이름을 기록해 둡니다.

분류 체계 페이지 편집

AEM의 다른 페이지와 같은 방식으로 분류 체계 페이지 편집을 시작합니다.

  1. Sites 콘솔로 이동합니다.

  2. 편집하려는 분류 체계를 선택합니다.

  3. 작업 표시줄에서 편집 ​을 탭하거나 클릭합니다.

  4. 페이지 편집기가 열리고 분류 체계가 표시됩니다.

    • 분류 체계 페이지는 페이지 편집기에서 읽기 전용입니다.

    분류 체계 편집

  5. 도구 모음에서 페이지 정보 아이콘을 탭하거나 클릭하고 속성 열기 ​를 선택합니다.

    속성 열기

  6. 페이지 속성 창에서 페이지 이름을 업데이트하고 태그 선택기를 사용하여 분류 체계에 포함된 태그 및 네임스페이스를 업데이트할 수 있습니다.

    페이지 속성 편집

  7. 저장 및 닫기 ​를 탭하거나 클릭합니다.

분류 체계의 내용이 선택한 태그 및 네임스페이스에서 자동으로 생성되므로 페이지 편집기에 표시되는 페이지는 읽기 전용입니다. 분류 체계의 내용을 자동으로 생성하는 일종의 필터 역할을 합니다. 따라서 편집기에서 페이지를 직접 편집할 이유가 없습니다.

기본 태그 및 네임스페이스를 업데이트하면 AEM이 분류 체계 페이지의 내용을 자동으로 업데이트합니다. 그러나 이러한 변경 사항을 사용자가 사용할 수 있도록 하려면 변경 후 분류 체계를 다시 게시해야 합니다.

분류 체계 게시를 위한 paths.json 업데이트

Edge Delivery Services 사이트의 표 형식 데이터를 관리 및 게시할 때와 마찬가지로 분류 체계 데이터를 게시할 수 있도록 프로젝트의 paths.json 파일을 업데이트해야 합니다.

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

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

    paths.json 파일

  3. 새 분류 체계 페이지를 .json 리소스에 매핑하는 줄을 추가합니다.

    {
  "mappings": [
   "/content/<site-name>/:/",
   "/content/<site-name>/<taxonomy-page-name>:/<taxonomy-json-name>.json"
  ]
}
    • <taxonomy-page-name>은 생성한 분류 체계 페이지의 이름과 일치해야 합니다.
    • <taxonomy-json-name>은 선택한 유효한 이름일 수 있습니다.

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

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

이 프로세스는 분류 체계 페이지당 한 번만 수행하면 됩니다. 완료되면 분류 체계를 게시할 수 있습니다.

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

분류 체계 게시

분류 체계는 게시될 때까지 범용 편집기에서 또는 사용자가 사용할 수 없습니다.

분류 체계 페이지는 도구 모음의 빠른 게시 또는 발행물 관리 아이콘을 사용하여 다른 페이지와 마찬가지로 게시됩니다.

매번 분류 체계 페이지를 다시 게시해야 합니다.

  • 분류 체계 페이지를 편집합니다.
  • 분류 체계 페이지에 포함된 태그 및 네임스페이스를 편집하거나 추가합니다.

새 분류 체계 페이지를 만들려면 먼저 프로젝트의 paths.json 파일에 매핑을 추가해야 합니다.

분류 체계 정보 접근

분류 체계가 게시되면 범용 편집기에서 해당 정보를 활용하여 사용자에게 표시할 수 있습니다.

분류 체계는 다음 주소에서 JSON 데이터로 액세스할 수 있습니다.

https://<branch>--<repository>--<owner>.aem.page/<taxonomy-json-name>.json

분류 체계를 프로젝트의 paths.json 파일에 매핑할 때 정의한 <taxonomy-json-name>을 사용합니다. 분류 체계 데이터는 다음 예제와 같이 JSON 데이터로 반환됩니다.

{
  "total": 3,
  "offset": 0,
  "limit": 3,
  "data": [
    {
      "tag": "default:",
      "title": "Standard Tags"
    },
    {
      "tag": "do-not-translate",
      "title": "Do Not Translate"
    },
    {
      "tag": "translate",
      "title": "Translate"
    }
  ],
  "columns": [
    "tag",
    "title"
  ],
  ":type": "sheet"
}

이 JSON 데이터는 분류 체계를 업데이트하고 다시 게시할 때 자동으로 업데이트됩니다. 앱은 사용자를 위해 이 정보에 프로그래밍 방식으로 액세스할 수 있습니다.

여러 언어로 태그를 유지 관리하는 경우 ISO2 언어 코드를 sheet= 매개변수의 값으로 전달하여 해당 언어에 액세스할 수 있습니다.

추가 태그 속성 노출

기본적으로 분류 체계에는 tag 및 title 값이 포함됩니다(이전 예제에서 확인할 수 있음). 추가 태그 속성을 노출하도록 분류 체계를 구성할 수 있습니다. 이 예제에서는 태그 설명을 노출하겠습니다.

  1. Sites 콘솔을 사용하여 만든 분류 체계를 선택합니다.
  2. 도구 모음에서 속성 아이콘을 탭하거나 클릭합니다.
  3. 추가 속성 섹션에서 추가 ​를 탭하거나 클릭하여 필드를 추가합니다.
  4. 새 필드에 노출할 JRC 속성 이름을 입력합니다. 이 경우에는 태그 설명을 위해 jcr:description을 입력합니다.
  5. 저장 및 닫기 ​를 탭하거나 클릭합니다.
  6. 분류 체계를 선택한 상태로 도구 모음에서 빠른 게시 ​를 탭하거나 클릭합니다.

이제 분류 체계에 액세스하면 태그 설명(또는 노출하도록 선택한 속성)이 JSON에 포함됩니다.

{
  "total": 3,
  "offset": 0,
  "limit": 3,
  "data": [
    {
      "tag": "default:",
      "title": "Standard Tags",
      "jcr:description": "These are the standard tags"
    },
    {
      "tag": "do-not-translate",
      "title": "Do Not Translate",
      "jcr:description": "Tag to mark pages that should not be translated"
    },
    {
      "tag": "translate",
      "title": "Translate",
      "jcr:description": "Tag to mark pages that should be translated"
    }
  ],
  "columns": [
    "tag",
    "title",
    "jcr:description"
  ],
  ":type": "sheet"
}

Experience Manager