SAP Commerce Cloud을 사용하여 개발 developing-with-sap-commerce-cloud

eCommerce 시스템에 연결하고 제품 데이터를 Adobe Experience Manager(AEM)로 가져옵니다

특정 eCommerce 엔진과 독립적인 상거래 기능을 위한 AEM 구성 요소 빌드

전자 상거래 엔진은 CommerceService 인터페이스를 지원하는 OSGi 서비스입니다.

• 엔진은 commerceProvider 서비스 속성으로 구분할 수 있습니다.

AEM은 CommerceService 및 Product에 대해 Resource.adaptTo()을(를) 지원합니다.

• adaptTo 구현은 리소스의 계층에서 cq:commerceProvider 속성을 찾습니다.

  • 검색되면 이 값을 사용하여 상거래 서비스 조회를 필터링합니다.

  • 검색되지 않는 경우, 가장 높은 등급의 상거래 서비스가 사용됩니다.

• cq:Commerce mixin을 사용하므로 cq:commerceProvider을(를) 강력한 형식의 리소스에 추가할 수 있습니다.

cq:commerceProvider 속성은 적절한 상거래 팩터리 정의를 참조하는 데에도 사용됩니다.

• 예를 들어 값이 hybris인 cq:commerceProvider 속성은 Hybris 용 Day CQ Commerce Factory(com.adobe.cq.commerce.hybris.impl.HybrisServiceFactory)의 OSGi 구성과 상관 관계가 있습니다. 여기서 매개 변수 commerceProvider도 값 hybris을(를) 가집니다.

• 카탈로그 버전 ​과 같은 추가 속성을 구성할 수 있습니다(적절한 경우 사용 가능).

Maven을 호출할 때 다음 명령줄 인수를 명령에 추가합니다.

-P hybris4

미리 구성된 Hybris 4 배포를 다운로드하여 cq-commerce-hybris-server 번들에 포함합니다.

OSGi 구성 관리자에서:

• 기본 응답 파서 서비스에 대한 Hybris 5 지원을 사용하지 않도록 설정합니다.

• Hybris Basic Authentication Handler 서비스의 서비스 순위가 Hybris OAuth Handler 서비스의 서비스 순위보다 낮은지 확인합니다.

첫 번째 요청에서 구매자의 요청에 쿠키가 설정되지 않으므로 세션을 만들도록 hybris 인스턴스에 요청이 전송됩니다.

세션 쿠키는 응답에서 추출되고, 새 쿠키(예: hybris-session-rest)로 인코딩되며, 쇼핑객에 대한 응답을 설정합니다. 원래 쿠키는 특정 경로에 대해서만 유효하고, 그렇지 않으면 후속 요청에서 브라우저에서 다시 전송되지 않으므로 새 쿠키의 인코딩이 필요합니다. 경로 정보를 쿠키 값에 추가해야 합니다.

후속 요청에서 쿠키는 hybris-session-<*xxx*> 쿠키에서 디코딩되고 hybris에서 데이터를 요청하는 데 사용되는 HTTP 클라이언트에 설정됩니다.

이 세션은 장바구니 ​를 "소유"합니다.

• 추가/제거/등 수행

• 장바구니에서 다양한 계산을 수행합니다.

  commerceSession.getProductPrice(Product product)

주문 데이터의 저장소 위치 ​을(를) 소유합니다.

CommerceSession.getUserContext()

결제 처리 연결 소유

이행 연결 소유

가져오기(b)는 카탈로그용 AEM에서 페이지 트리 구조의 초기 설정에 사용됩니다.

hybris의 카탈로그 변경 사항은 피드를 통해 AEM에 표시된 다음 AEM으로 전파됩니다(b)

• 카탈로그 버전에 대한 제품 추가/삭제/변경.

• 제품이 승인되었습니다.

hybris 확장은 지정된 간격(예: 간격이 초 단위로 지정된 경우 24시간마다)으로 AEM에 변경 사항을 가져오도록 구성할 수 있는 폴링 가져오기("hybris" 체계")를 제공합니다.

    http://localhost:4502/content/geometrixx-outdoors/en_US/jcr:content.json
     {
     * "jcr:mixinTypes": ["cq:PollConfig"],
     * "enabled": true,
     * "source": "hybris:outdoors",
     * "jcr:primaryType": "cq:PageContent",
     * "interval": 86400
     }

AEM의 카탈로그 구성은 준비 중 및 온라인 카탈로그 버전을 인식합니다.

카탈로그 버전 간의 제품 동기화를 사용하려면 해당 AEM 페이지의 활성화 또는 비활성화가 필요합니다(a, c)

• 온라인 카탈로그 버전에 제품을 추가하려면 제품 페이지를 활성화해야 합니다.

• 제품을 제거하려면 비활성화해야 합니다.

AEM ©에서 페이지를 활성화하려면 확인 (b)이 필요하며, 다음 경우에만 가능합니다.

• 제품이 제품 페이지의 온라인 카탈로그 버전에 있습니다.

• 참조된 제품은 다른 페이지(예: 캠페인 페이지)의 Online 카탈로그 버전에서 사용할 수 있습니다.

활성화된 제품 페이지는 제품 데이터의 온라인 버전(d)에 액세스해야 합니다.

AEM Publish 인스턴스를 사용하려면 제품 및 개인화된 데이터(d)를 검색하기 위해 hybris에 액세스해야 합니다.

일반 저장 메커니즘

• 제품 노드는 nt:unstructured입니다.

• 제품 노드는 다음 중 하나일 수 있습니다.

  • 제품 데이터가 다른 곳에 저장된 참조:

    • 제품 참조에는 제품 데이터(일반적으로 /etc/commerce/products 아래)를 가리키는 productData 속성이 있습니다.

    • 제품 데이터는 계층적입니다. 제품 속성은 제품 데이터 노드의 상위 항목에서 상속됩니다.

    • 제품 참조에는 제품 데이터에 지정된 속성을 재정의하는 로컬 속성도 포함될 수 있습니다.

  • 제품 자체:

    • productData 속성이 없습니다.

    • 모든 속성을 로컬로 보유하는(productData 속성을 포함하지 않는) 제품 노드는 자체 상위 항목에서 직접 제품 속성을 상속합니다.

AEM 일반 제품 구조

• 각 변형에는 자체 리프 노드가 있어야 합니다.

• 제품 인터페이스는 제품 및 변형을 모두 나타내지만 관련 저장소 노드는 제품 및 변형에 대해 구체적입니다.

• 제품 노드는 제품 속성 및 변형 축에 대해 설명합니다.

장바구니를 CommerceSession:이(가) 소유하고 있습니다.

• CommerceSession은(는) 추가 또는 제거 등을 수행합니다.
• CommerceSession은(는) 장바구니에서 다양한 계산도 수행합니다. "

장바구니와 직접 관련되지는 않지만 CommerceSession은(는) 가격 정보를 소유하므로 카탈로그 가격 정보도 제공해야 합니다.

• 가격책정에는 다음과 같은 몇 가지 수정자가 있을 수 있습니다.

  • 수량 할인.
  • 다른 통화.
  • 부가세 부담 및 부가세 무료.

• 수정자는 다음 인터페이스로 끝이 열립니다.

  • int CommerceSession.getQuantityBreakpoints(Product product)
  • String CommerceSession.getProductPrice(Product product)

스토리지

• hybris의 경우 hybris 서버는 장바구니를 소유합니다.
• AEM 일반적인 경우 의 장바구니는 ClientContext에 저장됩니다.

ClientContext을 통해 항상 개인화를 촉진하십시오.

장바구니의 ClientContext /version/이(가) 모든 경우에 만들어집니다.

• 제품은 CommerceSession.addCartEntry() 메서드를 사용하여 추가해야 합니다.

다음은 ClientContext 장바구니에 있는 장바구니 정보의 예를 보여줍니다.

주문 양식에는 종종 여러 배송 옵션(및 가격)이 있어야 합니다.

가격은 중량 및/또는 배송 주소와 같은 품목 및 주문 세부 사항을 기반으로 할 수 있습니다.

CommerceSession은(는) 모든 종속성에 액세스할 수 있으므로 제품 가격과 유사한 방식으로 처리할 수 있습니다.

• CommerceSession이(가) 배송 가격을 소유합니다.
• updateOrder(Map<String, Object> delta)을(를) 사용하여 게재 세부 정보를 검색/업데이트할 수 있습니다.

CommerceSession이(가) 결제 처리 연결도 소유합니다.

구현자는 선택한 결제 처리 서비스에 특정 호출을 CommerceSession 구현에 추가해야 합니다.

인증

AEM은 only 웹 프런트 엔드로 간주되므로 all 인증을 수행합니다.

Hybris의 계정

AEM은 각 쇼핑객에 대해 hybris에 해당 (하위) 계정을 만듭니다. 이 계정의 사용자 이름은 AEM 사용자 이름과 같습니다. 암호화 임의 암호는 AEM에서 자동 생성되고 저장(암호화)됩니다.

AEM > hybris

• hybris에 로그인할 때 AEM 사용자가 없는 경우:

  • 암호학적으로 무작위 암호를 사용하여 hybris 사용자 만들기
  • AEM 사용자의 사용자 디렉토리에 hybris 사용자 이름을 저장합니다.

• 참조: com.adobe.cq.commerce.hybris.impl.HybrisSessionImpl#login()

hybris > AEM

• AEM에 로그인할 때 시스템에서 사용자를 인식하는 경우:

  • 제공된 사용자 이름/pwd로 hybris에 로그인 시도
  • 성공하면 동일한 암호로 AEM에서 사용자를 만듭니다(AEM 특정 솔트 결과로 AEM 특정 해시가 표시됨).

• 위의 알고리즘은 Sling AuthenticationInfoPostProcessor에서 구현됩니다.

  • 참조: com.adobe.cq.commerce.hybris.impl.user.LazyUserImporter.java

ImportHandler 인터페이스를 구현해야 합니다.

DefaultImportHandler을(를) 확장할 수 있습니다.