설명서CommerceAEM Assets 통합 안내서

Commerce 메타데이터를 지원하도록 AEM Assets 프로젝트 구성

Last update: Fri Dec 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 사용자

AEM Assets을 Commerce용 DAM(디지털 에셋 관리 시스템)으로 사용하는 경우 assets-commerce 패키지를 설치하면 AEM 작성 환경에서 Commerce 제품의 이미지와 비디오를 관리할 수 있습니다.

다음 단계를 완료하여 AEM 작성 환경에서 Commerce 에셋을 관리하는 데 필요한 패키지 코드 및 메타데이터로 AEM Assets 프로젝트를 구성합니다.

  1. 에 대해 알아보기 ​

  2. 설치 단계를 완료하여 Commerce 메타데이터를 지원하도록 AEM Assets 프로젝트를 구성합니다

AEM Commerce assets-commerce 패키지 콘텐츠

Adobe은 Experience Manager Assets Commerce 환경 구성에 Commerce 네임스페이스 및 메타데이터 스키마 리소스를 추가하기 위해 AEM as a Cloud Service 패키지 코드 assets-commerce을(를) 제공합니다.

이 패키지 코드는 AEM Assets 작성 환경에 다음 리소스를 추가합니다.

  • Commerce 관련 속성을 식별하기 위한 사용자 지정 네임스페이스, Commerce입니다.

    • Adobe Commerce 프로젝트와 연결된 Commerce 자산에 태그를 지정하는 레이블이 commerce:isCommerce인 사용자 지정 메타데이터 형식 Eligible for Commerce입니다.

    • commerce:skus 속성을 추가할 사용자 지정 메타데이터 형식 Product Data 및 해당 UI 구성 요소입니다. 제품 데이터에는 Commerce 에셋을 제품 SKU와 연결하는 메타데이터 속성이 포함됩니다.

      사용자 지정 제품 데이터 UI 컨트롤 {width="600" modal="regular"}

    • Commerce에서 자산이 시각화되는 방식을 보여 주는 사용자 지정 메타데이터 형식 commerce:roles 및 commerce:positions 특성입니다.

  • Commerce 자산에 태그를 지정할 Eligible for Commerce 및 Product Data 필드가 포함된 Commerce 탭이 있는 메타데이터 스키마 양식입니다. 이 양식은 AEM Assets UI에서 roles 및 position 필드를 표시하거나 숨기는 옵션도 제공합니다.

    AEM Assets 메타데이터 스키마 양식에 대한 Commerce 탭 {width="600" modal="regular"}

  • 초기 에셋 동기화를 지원하기 위해 샘플 Commerce 에셋이 태그되고 승인되었습니다 equipment_6.jpg. 승인된 Commerce 자산만 AEM Assets에서 Adobe Commerce으로 동기화할 수 있습니다.

NOTE
AEM Commerce 패키지 코드에 대한 자세한 내용은 readme 페이지를 참조하십시오.

사전 요구 사항

assets-commerce 패키지 코드를 AEM Assets as a Cloud Service AEM 환경에 배포하려면 다음 리소스와 권한이 필요합니다.

1단계: assets-commerce 패키지 설치

  1. AEM Cloud Manager으로 이동하여 프로그램을 선택한 다음 Adobe Commerce과 통합할 프로덕션 및 스테이징 환경 만들기를 선택합니다.

  2. 배포 파이프라인을 구성하거나 파이프라인이 선택한 환경에 변경 내용을 배포할 수 있는지 확인하십시오.

  3. 선택한 프로그램에 대해 Adobe 관리 git 저장소를 복제합니다.

  4. GitHub에서 AEM Assets Commerce 저장소에서 패키지 코드를 다운로드합니다.

  5. 로컬 AEM 개발 환경에서 다운로드한 코드를 기존 Adobe 관리 저장소에 수동으로 복사하십시오.

  6. 프로젝트의 모든 filter.xml 및 pom.xml files에서 <my-app>을(를) 앱 이름으로 바꾸십시오.

NOTE
또는 사용자 지정 코드를 AEM Assets 프로젝트 구성에 Maven 패키지로 설치할 수 있습니다.

  1. 변경 사항을 커밋하고 로컬 개발 분기를 Cloud Manager Git 저장소로 푸시합니다.

  2. AEM Cloud Manager에서 파이프라인을 사용하여 코드를 배포하여 AEM 환경을 업데이트합니다.

  3. 변경 내용을 확인하려면 임의의 자산으로 이동하여 해당 속성을 편집하십시오.

    • 기본 메타데이터 스키마에는 Commerce 탭이 포함되어 있습니다.

    • 제품 SKU 및 Eligible for Commerce 필드가 표시됩니다.

Commerce 탭이 속성에 표시되지 않습니다.

Commerce 탭이 속성에 나타나지 않으면 메타데이터 스키마 편집기에서 수동으로 만들어야 합니다.

  1. 메타데이터 스키마 편집기로 이동합니다.

  2. 기본 메타데이터 스키마 양식을 수정하려면 편집​을 클릭하십시오.

  3. Commerce 탭을 만들고 선택합니다.

  4. Product 구성 요소를 Commerce 탭으로 끌어다 놓고 속성 commerce:skus에 매핑합니다.

  5. 역할 표시 및 순서 표시​에 대한 확인란을 선택하십시오.

  6. checkbox 구성 요소를 Commerce 탭으로 끌어다 놓고 속성 commerce:isCommerce에 매핑합니다. 옵션으로 예 및 아니요​를 정의합니다.

다른 문제가 발생하면 지원 티켓을 만들거나 AEM Assets 통합 영업 담당자에게 도움을 요청하십시오.

2단계: 선택 사항입니다. 메타데이터 프로필 구성

AEM Assets 작성 환경에서 메타데이터 프로필을 만들어 Commerce 에셋 메타데이터에 대한 기본값을 설정합니다. 그런 다음 AEM 자산 폴더에 새 프로필을 적용하여 이러한 기본값을 자동으로 사용합니다. 이 구성은 수동 단계를 줄여 자산 처리를 간소화합니다.

메타데이터 프로필을 구성할 때는 다음 구성 요소만 구성해야 합니다.

  • Commerce 탭을 추가합니다. 이 탭에서는 템플릿에서 추가한 Commerce 특정 구성 설정을 사용할 수 있습니다.

  • Commerce 탭에 Eligible for Commerce 필드를 추가합니다.

제품 데이터 UI 구성 요소는 템플릿을 기반으로 자동으로 추가됩니다.

메타데이터 프로필 정의

  1. Adobe Experience Manager 작성자 환경에 로그인합니다.

  2. Adobe Experience Manager 작업 영역에서 Adobe Experience Manager 아이콘을 클릭하여 AEM Assets용 작성자 컨텐츠 관리 작업 영역으로 이동합니다.

    AEM Assets 작성 {width="600" modal="regular"}

  3. 망치 아이콘을 선택하여 관리자 도구를 엽니다.

    AEM 작성자 관리자 관리 메타데이터 프로필 {width="600" modal="regular"}

  4. Metadata Profiles​을(를) 클릭하여 프로필 구성 페이지를 엽니다.

  5. Commerce 통합을 위한 메타데이터 프로필을 Create​합니다.

    AEM 작성자 관리자 메타데이터 프로필 추가 {width="600" modal="regular"}

  6. Commerce 메타데이터에 대한 탭을 추가합니다.

    1. 왼쪽에서 Settings​을(를) 클릭합니다.

    2. 탭 섹션에서 +​을(를) 클릭한 다음 Tab Name, Commerce을(를) 지정합니다.

  7. 양식에 Eligible for Commerce 필드를 추가합니다.

    AEM 작성자 관리자가 프로필에 메타데이터 필드 추가 {width="600" modal="regular"}

    • Build form​을(를) 클릭합니다.

    • Single Line text 필드를 양식으로 끕니다.

    • Eligible for Commerce을(를) 클릭하여 레이블에 대한 Field Label 텍스트를 추가합니다.

    • 설정 탭에서 레이블 텍스트를 필드 레이블​에 추가합니다.

    • 자리 표시자 텍스트를 yes(으)로 설정하십시오.

    • Map to Property 필드에서 다음 값을 복사하여 붙여 넣습니다.

      code language-terminal 
      ./jcr:content/metadata/commerce:isCommerce

  8. 선택 사항입니다. 승인된 Commerce 자산이 AEM Assets 환경에 업로드될 때 자동으로 동기화하려면 Review Status​탭의 Basic 필드에 대한 기본값을 approved(으)로 설정합니다.

  9. 업데이트를 저장합니다.

Commerce 에셋 소스 폴더에 메타데이터 프로필 적용

  1. ​ Metadata Profiles 페이지에서 Commerce 통합 프로필을 선택합니다.

  2. 작업 메뉴에서 Apply Metadata Profiles to Folders​을(를) 선택합니다.

  3. Commerce 자산이 포함된 폴더를 선택합니다.

    Commerce 폴더가 없는 경우 만듭니다.

  4. Apply​을(를) 클릭합니다.

다음 단계

recommendation-more-help
520dd1d6-1a61-4b98-a41f-0ee905eafadc