AtlasMap Java backend implementation and design time REST service resources


Keywords
atlasmap
License
Apache-2.0

Documentation

AtlasMap

Runtime @ Maven Central UI @ NPM CircleCI Badge Codacy Badge Codacy Badge Gitter chat Google Group

The AtlasMap is a data mapping solution with interactive web based user interface, that simplifies configuring integrations between Java, XML, and JSON data sources. You can design your data mapping on the AtlasMap Data Mapper UI canvas, and then run that data mapping via runtime engine. AtlasMap Data Mapper UI is primarily designed to work within the Syndesis UI, and now we're exploring to improve standalone user experience.

AtlasMap Documentation

AtlasMap User Guide

AtlasMap Developer Guide

The shortest path to run standalone AtlasMap Data Mapper UI

  1. Download AtlasMap standalone jar
$ wget http://central.maven.org/maven2/io/atlasmap/atlasmap-standalone/${VERSION}/atlasmap-standalone-${VERSION}.jar
  1. Run
$ java -jar atlasmap-standalone-${VERSION}.jar 

Then AtlasMap Data Mapper UI is available at http://127.0.0.1:8585/ by default.

Build AtlasMap project

  1. Checkout AtlasMap repo from GitHub
$ git clone https://github.com/atlasmap/atlasmap ${ATLASMAP}
  1. Build
$ cd ${ATLASMAP}
$ ./mvnw clean install

or you can skip tests to get the build little bit faster

$ ./mvnw clean install -DskipTests
  1. Run AtlasMap standalone jar from springboot maven plugin
$ cd ${ATLASMAP}/standalone
$ ../mvnw -Pitests spring-boot:run

AtlasMap Data Mapper UI is available at http://127.0.0.1:8585/ by default.

Live update for UI development

While standalone AtlasMap design time services are running by following above, you can also run an another AtlasMap Data Mapper UI instance at different port by yarn start. This enables live update for UI code so you can see the outcome of your UI code change without build&restart manually.

  1. Install Yarn

  2. Install Data Mapper UI's dependencies

$ cd ${ATLASMAP}/ui
$ yarn install
  1. Start Data Mapper UI
$ yarn start

The yarn start command will attempt to automatically open your browser window, but if it doesn't, open it directly with this URL: http://localhost:3000.