Introduction

Welcome to the Intershop Commerce Management (ICM) SPARQUE Extension. The extension is a blueprint to show how to set up and configure ICM data export and transfer to SPARQUE. The data (product, catalog) is required to build the SPARQUE search index and provide search functionality. Order data is necessary to create recommendations and to personalize the search results.

This document provides important product information, including version information and dependencies. It also outlines the basic setup steps.

It uses ICM Demo Data extensions to show how to build the necessary exports. You need to adapt it in the project as required.

References

Version Information and Dependencies

Intershop Commerce Management	ICM Headless Extension	ICM Demo Data
14.0+	4.+	4.+

Also see Reference - ICM 14 Release Versions for versions that are released and tested together.

Delivery

The following table lists the cartridges contained in the ICM SPARQUE Extension:

Cartridge	Description
sparque_dbinit_demo	DBPrepare - contains all jobs, transport framework, and process chain definitions for inSPIRED Demo
sparque_impex	Import/Export - contains pipelets and pipelines that are used in job order export to rename the exported file name
ac_sparque_api	Adapter SPARQUE - API, managed service definition and implementation to send requests to SPARQUE API Wrapper
ac_sparque_bo	Adapter SPARQUE - back office
as_sparque	SPARQUE Application Suite - assigns the cartridges to the applications
ft_sparque	Feature SPARQUE Cartridges - includes the runtime cartridges without inSPIRED Demo content
ft_sparque_demo	Feature SPARQUE Cartridges - additionally includes schedule and process chain configurations for the inSPIRED Demo content

Setup

Follow the basic setup of ICM 14 customization described in Concept - Customization - Deployment - ICM 11+ to add the cartridges of the extension to ICM and to the cartridge list.

Add the ft_sparque feature to the cartridge list to create the process chain and its jobs:
```
  environment:
    CARTRIDGE_LIST: ft_sparque, ft_other_customization
```
Use ft_sparque_demo to see the blueprint how it is done with the demo data:
```
  environment:
    CARTRIDGE_LIST: ft_sparque_demo, ft_other_customization
```

Add the ICM SPARQUE Extension to the customizations section of the Helm chart:

...

customizations:
    sparque:
      repository: intershophub/icm-as-customization-sparque:1.3.1
....

Changelog

Release 1.3.1

Bug Fixes

Fixed inSPIRED-inTRONICS process chain ExportAndTransportProducts validation errors (115390)
Fixed trailing whitespace in jobs ExecuteSparqueProcessChain and ExecuteSparqueTransport (115730)

Release 1.3.0

Rework of cartridge-application assignments, added cartridges ac_sparque_bo, ac_sparque_api, as_sparque
Generated the v4 SPARQUE API based on the OpenAPI SPARQUE Wrapper API specification
Added a managed service to send requests to SPARQUE based on the SPARQUE API definition
Extended the OCI Punchout Handler to direct OCI Punchout REST search requests to the managed service that queries SPARQUE

Release 1.2.0

Revoked release

Do not use this release. It contains a severe bug which causes errors in storefront and back office functionality.

Release 1.1.4

Support creation of order export to build a recommendation engine
Support creation of product and catalog export

Disclaimer

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Website, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.