Skip to content

atlasmap/atlasmap

Repository files navigation

AtlasMap

Runtime @ Maven Central UI @ NPM Main Supported Codacy Grade Codacy Coverage Gitter chat GitHub Discussions

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 https://repo1.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
  1. Run AtlasMap standalone: Run yarn start for each sub packages from 3 different terminal
$ cd ${ATLASMAP}/ui/packages/atlasmap-core
$ yarn start
$ cd ${ATLASMAP}/ui/packages/atlasmap
$ yarn start
$ cd ${ATLASMAP}/ui/packages/atlasmap-standalone
$ yarn start

Run AtlasMap from your browser with storybook

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

There is a full function demo in storybook, AtlasMap|Demo. If you have AtlasMap server running at http://localhost:8585/, then the demo fully works as AtlasMap standalone UI.