commercetools sync
More at https://commercetools.github.io/commercetools-sync-java
Java library which allows to import/synchronise (import changes) the data from any arbitrary source to commercetools project.
Supported resources: Categories, Products, InventoryEntries, ProductTypes, Types, CartDiscounts, States, TaxCategories, CustomObjects, Customers, ShoppingLists
Usage
Create you own event or cronjob based application and use the library to transform any external data (JSON, CSV, XML, REST API, DB, ...) into commercetools-jvm-sdk resource draft objects (e.g. CategoryDraft) and import those into the commercetools project.
Notes:
- It is often more efficient if you can setup your external data source to provide you only the changes (deltas) instead of the full data set on every import iteration.
- There is dockerized ready-to-use CLI application commercetools-project-sync which based on this library can synchronize entire data catalogue between the 2 commercetools projects.
- During a synchronisation, resources are either created or updated, but not deleted.
Prerequisites
- Library requires the min JDK version
>= 11.The library tested with each major JDK version (i.e: 11, 12, 13...) as well as some specific updates of LTS versions (i.e: 11.0.3 and above).
- A target commercetools project for syncing your source data to.
Installation
There are multiple ways to add the commercetools sync dependency to your project, based on your dependency manager. Here are the most popular ones:
Maven
<dependency>
<groupId>com.commercetools</groupId>
<artifactId>commercetools-sync-java</artifactId>
<version>9.0.3</version>
</dependency>Gradle
implementation 'com.commercetools:commercetools-sync-java:9.0.3'SBT
libraryDependencies += "com.commercetools" % "commercetools-sync-java" % "9.0.3"
Ivy
<dependency org="com.commercetools" name="commercetools-sync-java" rev="9.0.3"/>Note: To avoid commercetools JVM SDK libraries version mismatch between projects.
It is better not to add commercetools JVM SDK dependencies explicitly into your project and use them from commercetools-Sync-Java dependencies instead.
Please remove them if you have already added the below dependencies in your project.
For Gradle users, remove:
````groovy
implementation 'com.commercetools.sdk.jvm.core:commercetools-models:<version>'
implementation 'com.commercetools.sdk.jvm.core:commercetools-java-client-ahc-2_5:<version>'
implementation 'com.commercetools.sdk.jvm.core:commercetools-convenience:<version>'
````
For Maven users, remove:
````xml
<dependency>
<groupId>com.commercetools.sdk.jvm.core</groupId>
<artifactId>commercetools-models</artifactId>
<version>version</version>
</dependency>
<dependency>
<groupId>com.commercetools.sdk.jvm.core</groupId>
<artifactId>commercetools-java-client-ahc-2_5</artifactId>
<version>version</version>
</dependency>
<dependency>
<groupId>com.commercetools.sdk.jvm.core</groupId>
<artifactId>commercetools-convenience</artifactId>
<version>version</version>
</dependency>
````
If you want to use a different commercetools JVM SDK version than the version used in this project.
, below you will find examples on how to exclude commercetools JVM SDK from commercetools-sync-java library. Beware that library might not work with the older commercetools JVM SDK versions.
For Gradle:
````groovy
implementation('com.commercetools:commercetools-sync-java') {
exclude group: 'com.commercetools.sdk.jvm.core', module: 'commercetools-models'
exclude group: 'com.commercetools.sdk.jvm.core', module: 'commercetools-java-client-ahc-2_5'
exclude group: 'com.commercetools.sdk.jvm.core', module: 'commercetools-convenience'
}
````
For Maven:
````xml
<dependency>
<groupId>com.commercetools</groupId>
<artifactId>commercetools-sync-java</artifactId>
<version>version</version>
<exclusions>
<exclusion>
<groupId>com.commercetools.sdk.jvm.core</groupId>
<artifactId>commercetools-models</artifactId>
</exclusion>
<exclusion>
<groupId>com.commercetools.sdk.jvm.core</groupId>
<artifactId>commercetools-java-client-ahc-2_5</artifactId>
</exclusion>
<exclusion>
<groupId>com.commercetools.sdk.jvm.core</groupId>
<artifactId>commercetools-convenience</artifactId>
</exclusion>
</exclusions>
</dependency>
````