AEM Content & Commerce Authoring Picker

마지막 업데이트: 2024년 7월 15일

작성 대상:

  • 관리자

AEM Content & Commerce Authoring은 AEM 작성자 및 마케터가 상거래 제품 데이터 및 카탈로그를 효율적으로 작업하는 데 도움이 되는 작성 도구 세트를 제공합니다. 제품 선택기 및 카테고리 선택기는 CIF 추가 기능의 일부이며 CIF 핵심 구성 요소에서 사용됩니다. 프로젝트는 구성 요소 대화 상자에서 이러한 선택기를 사용하여 제품이나 범주를 선택할 수 있습니다.

제품 선택기

프로젝트 구성 요소에서 제품 선택기를 사용하려면 개발자가 구성 요소 대화 상자에 commerce/gui/components/common/cifproductfield을(를) 추가해야 합니다. 예를 들어 cq:dialog에 대해 다음을 사용합니다.

<product jcr:primaryType="nt:unstructured"
    sling:resourceType="commerce/gui/components/common/cifproductfield"
    fieldDescription="The product or product variant displayed by the teaser"
    fieldLabel="Select Product"
    filter="folderOrProductOrVariant"
    name="./selection"
    selectionId="sku"/>

제품 필드를 사용하면 사용자가 다른 보기를 통해 선택하려는 제품으로 이동할 수 있습니다. 기본적으로 제품 필드는 제품의 ID를 반환하지만 selectionId 특성을 사용하여 구성할 수 있습니다.

제품 선택기 필드는 다음과 같은 선택적 속성을 지원합니다.

  • selectionId(id, uid, SKU, slug, combinedSlug, combinedSku) - 선택기에서 반환할 제품 속성을 선택할 수 있습니다(기본값 = id). SKU를 사용하면 선택한 제품의 SKU가 반환됩니다. combinedSku를 사용하면 기본 제품 및 선택한 변형의 SKU가 있는 base#variant와 같은 문자열 또는 기본 제품이 선택된 경우 단일 SKU가 반환됩니다.
  • filter (folderOrProduct, folderOrProductOrVariant) - 제품 트리를 탐색하는 동안 선택기에서 렌더링할 콘텐츠를 필터링합니다. folderOrProduct - 폴더 및 제품을 렌더링합니다. folderOrProductOrVariant - 폴더, 제품 및 제품 변형을 렌더링합니다. 제품 또는 제품 변형이 렌더링되면 선택기에서 선택할 수도 있습니다. (기본값 = folderOrProduct)
  • 다중(true, false) - 하나 이상의 제품을 선택할 수 있습니다(기본값 = false).
  • emptyText - 선택기 필드의 빈 텍스트 값을 구성합니다.

또한 name, fieldLabel 또는 fieldDescription과(와) 같은 표준 대화 상자 필드 속성이 지원됩니다.

CAUTION
cifproductfield 구성 요소에는 cif.shell.picker clientlib이 필요합니다. 대화 상자에 clientlib을 추가하려면 extraClientlibs 속성을 사용합니다.
CAUTION
CIF 핵심 구성 요소 버전 2.0.0부터 id에 대한 지원이 제거되고 uid(으)로 대체되었습니다. Adobe은 sku 또는 slug을(를) 제품 식별자로 사용할 것을 권장합니다. Adobe은 CIF 핵심 구성 요소 버전 1.x를 사용하는 프로젝트에 대해서만 id을(를) 계속 지원합니다.

cifproductfield의 전체 작업 예는 CIF 핵심 구성 요소 프로젝트에서 찾을 수 있습니다. AEM 핵심 구성 요소 설명서의 대화 상자 사용자 지정도 참조하십시오.

범주 선택기

카테고리 선택기는 제품 선택기와 유사한 방식으로 구성 요소 대화 상자에서도 사용할 수 있습니다.

cq:dialog 구성에서 다음 코드 조각을 사용할 수 있습니다.

<category jcr:primaryType="nt:unstructured"
    sling:resourceType="commerce/gui/components/common/cifcategoryfield"
    fieldLabel="Category"
    name="./categoryId"
    selectionId="uid" />

카테고리 선택기 필드는 다음과 같은 옵션 속성을 지원합니다.

  • selectionId(id, uid, slug, urlPath, idAndUrlPath (더 이상 사용되지 않음), uidAndUrlPath (더 이상 사용되지 않음)) - 선택기에서 반환할 범주 특성을 선택할 수 있습니다(기본값 = id).
  • 다중(true, false) - 하나 이상의 카테고리를 선택할 수 있습니다(기본값 = false).

또한 name, fieldLabel 또는 fieldDescription과(와) 같은 표준 대화 상자 필드 속성이 지원됩니다.

CAUTION
cifproductfield 구성 요소와 마찬가지로 cifcategoryfield 구성 요소에도 cif.shell.picker clientlib이 필요합니다. 대화 상자에 clientlib을 추가하려면 extraClientlibs 속성을 사용합니다. AEM 핵심 구성 요소 설명서의 대화 상자 사용자 지정을 참조하십시오.
CAUTION
CIF 핵심 구성 요소 버전 2.0.0부터 id에 대한 지원이 제거되고 uid(으)로 대체되었습니다. Adobe uid 또는 urlPath을(를) 범주 식별자로 사용하는 것이 좋습니다. Adobe은 CIF 핵심 구성 요소 버전 1.x를 사용하는 프로젝트에 대해서만 id 및 idAndUrlPath을(를) 계속 지원합니다.

cifcategoryfield의 전체 작업 예는 CIF 핵심 구성 요소 프로젝트에서 찾을 수 있습니다.

이전 페이지CIF 구성 요소 맞춤화
다음 페이지CIF 제품 슬라이드에 대한 사용자 정의 속성

Experience Manager