Skip to content

rvnyk/atlasmap

 
 

Repository files navigation

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

The shortest path to run standalone AtlasMap Data Mapper UI

  1. Download AtlasMap standalone jar
$ wget http:https://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:https://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:https://127.0.0.1:8585/ by default.

Live update for UI development

While standalone AtlasMap design time services are running by following above steps, you can also run another AtlasMap Data Mapper UI instance at a different port by yarn start. This enables live updates to the UI code so you can see the outcome of your UI code change without building and restarting 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:https://localhost:3000.

Run REACT version of the standalone AtlasMap UI

  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 from the REACT folder:
$ cd ${ATLASMAP}/ui-react
$ yarn standalone

Live update for REACT UI development

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

  1. As above, run the AtlasMap standalone jar from the springboot maven plugin:
$ cd ${ATLASMAP}/standalone
$ ../mvnw -Pitests spring-boot:run
  1. In a separate terminal window, run yarn start to make live updates to core:
$ cd ${ATLASMAP}/ui-react/packages/atlasmap-core
$ yarn start
  1. Again in a separate terminal window, run yarn start to make live updates to the REACT UI:
$ cd ${ATLASMAP}/ui-react/packages/atlasmap-ui
$ yarn start
  1. In a final separate terminal window, run the standalone UI from the REACT folder:
$ cd ${ATLASMAP}/ui-react
$ yarn standalone

About

AtlasMap project repository

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 72.8%
  • TypeScript 16.9%
  • HTML 8.6%
  • CSS 1.5%
  • JavaScript 0.1%
  • Shell 0.1%