Setup

In order to use the provided repository, it is sufficient to add it to your Shopware6 project.

The use of the Data Integration Layer requires to use the samples&guidelines following tag 3.0.0 of the Integration Layer Guidelines https://github.com/boxalino/rtux-integration-shopware/tree/3.0.0. This will, respectively, update the Framework Layer (rtux-shopware) to version 3.0.0

Difference between Data Integration and Data Exporter Layer

The data integration layer will transform your e-shop data in the Boxalino Data Structures.

Read more about the new structure on the public documentation https://boxalino.atlassian.net/wiki/spaces/BPKB/pages/252149803/Data+Integration

In the Data Exporter Layer, the exported product attributes had a prefix of "products_". This prefix is no longer applied for the new Data Integration (DI) strategy.

Due to this, the Integration Layer Guidelines require to be updated if you are changing your data synchronization strategy from the Data Exporter Layer to the Data Integration Layer.

Setup

1. Add the plugin to your project via composer

• composer require boxalino/data-integration-shopware6

2. Activate the plugin per Shopware use

• php ./bin/console plugin:refresh
• php ./bin/console plugin:install --activate --clearCache BoxalinoDataIntegration
• php ./bin/console database:migrate BoxalinoDataIntegration --all

3. Plugin Configuration

Log in your Shopware admin and configure the plugin with the configurations provided for your setup Shopware Admin >> Settings >> System >> Plugins >> Boxalino Data Integration for Shopware v6

Follow the instructions provided in the Configurations wiki page

4. Integrate the services

4.1. Declare the documents IntegrationHandler Interfaces.

Over time, there will be provided multiple document handlers (vouchers, reviews, blogs, etc). The list bellow is the minimum requirement for an initial kick-off

The default definitions and activated properties are part of the integration layer and can be imported as are:

• doc_product handler
• doc_order handler
• doc_language handler
• doc_attribute handler
• doc_attribute_value handler

4.2 Add the console commands, task schedulers or subscribers(for instant). The default definitions and activated properties are part of the integration layer and can be imported as are.

These are required for an initial kick-off:

• product console commands
• order console commands

You can review the integration strategies for data integrations later on in the Integration process.

5. Export your store data

In order to kick off your account,a full data integration is required.

• php ./bin/console boxalino:di:full:product
• php ./bin/console boxalino:di:full:order (optional)
• php ./bin/console boxalino:di:full:user (optional)

The exporter will log it's process in a dedicated log ./var/log/boxalino-di-type-env.log

6. Review integration options

Check more integration features:

• in our guidelines suggestions https://github.com/boxalino/rtux-integration-shopware/wiki/DI:-Data-Integration
• in the Data Integration wiki for Full, Delta or Instant