Skip to content

engswee/equalize-cpi-converter

Repository files navigation

Equalize CPI Converter a.k.a. FormatConversionBean for CPI

Build Status Codecov GitHub release Github All Releases License: MIT HitCount

FormatConversionBean is a collection of converters for transforming data content from one format to another, e.g. JSON to XML, XML to Excel, etc. It was originally developed as a complementary open-source solution for SAP Process Integration (PI) and is now also available for SAP Cloud Platform Integration (CPI).

Getting Started

If your intention is to use the converters as-is, then it is as easy as downloading the latest release and configuring the CPI integration flow as detailed in this blog post.

The following are only applicable if you plan to either enhance the converters privately or collaborate publicly on this project.

Prerequisites

Maven or M2Eclipse - for dependency management and build automation

Groovy Eclipse - for Groovy development in Eclipse

Installation

The following steps will get you a copy of the project up and running on your local machine for development and testing purposes. This assumes the development will be done in an Eclipse environment.

  1. Fork this Git repository
  2. Clone the forked Git repository into your local machine
  3. Import Maven project into Eclipse
  4. Execute Maven command mvn clean install

Maven Goals

Following are some of the common Maven goals used in this project:-

  1. Clean up output directory and execute unit tests
mvn clean test
  1. Execute unit tests using OpenClover to instrument and generate code coverage report
mvn initialize clover:instrument-test clover:clover
  1. Full cycle - clean, test, check coverage %, build and install JAR
mvn clean initialize clover:instrument-test clover:check clover:clover install

Deployment

To deploy this into a CPI tenant:-

  1. Generate JAR file
  2. Upload into a CPI integration flow as an Archive

Built With

  • Maven - Used for dependency management and build automation
  • Spock - Used as testing and specification framework
  • GMavenPlus - Used to integrate Groovy into Maven projects
  • OpenClover - Used to generate coverage for Java and Groovy source codes
  • Travis CI - Used for Continuous Integration
  • CodeCov - Used to compile OpenClover code coverage statistics for GitHub

Versioning

SemVer is used for versioning.

License

This project is licensed under the MIT License - see the LICENSE file for details