/atlasmap

AtlasMap project repository

Primary LanguageJavaApache License 2.0Apache-2.0

AtlasMap

Runtime @ Maven Central UI @ NPM CircleCI Badge Codacy Badge Codacy Badge Gitter chat Netlify Status 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

Places to discuss and/or ask a question

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 -DskipTests -Pitests

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

$ ./mvnw clean install -DskipTests
  1. Run the AtlasMap standalone jar from the springboot maven plugin, as described above:
$ cd ${ATLASMAP}/standalone
$ ../mvnw -Pitests spring-boot:run
  1. In a separate terminal window, run the standalone UI:
$ cd ${ATLASMAP}/ui/packages/atlasmap-standalone
$ yarn start

Live update for UI development

You can also run the AtlasMap Data Mapper UI with live updates by starting yarn in both the core and UI folders:

  1. Build AtlasMap UI and server
$ cd ${ATLASMAP}
$ ./mvnw clean install -DskipTests -Pitests
  1. Start the AtlasMap server by running the AtlasMap standalone jar from the springboot maven plugin:
$ cd ${ATLASMAP}/standalone
$ ../mvnw -Pitests spring-boot:run
  1. Again in a separate terminal window, run yarn build to make the REACT UI:
$ cd ${ATLASMAP}/ui/packages/atlasmap/ui
$ yarn build

4a. Run AtlasMap standalone:

$ cd ${ATLASMAP}/ui/packages/atlasmap-standalone
$ yarn start

4b. Run AtlasMap from your browser with storybook

$ cd ${ATLASMAP}/ui/packages/atlasmap
$ yarn build
$ yarn storybook