Skip to content

atlasmap/atlasmap

Folders and files

NameName
Last commit message
Last commit date
Feb 27, 2023
Sep 21, 2020
Aug 15, 2022
Aug 11, 2022
Aug 11, 2022
Oct 7, 2022
Aug 11, 2022
Aug 11, 2022
Oct 10, 2022
Aug 15, 2022
Feb 13, 2023
Aug 15, 2022
Dec 23, 2024
May 20, 2021
May 21, 2021
May 20, 2021
Feb 26, 2020
Nov 15, 2017
Oct 11, 2022
Sep 2, 2020
Sep 2, 2020
May 20, 2021
May 25, 2021
Nov 15, 2017
Nov 14, 2017
Nov 15, 2017
May 8, 2020
Feb 13, 2023
Oct 11, 2021
Jan 26, 2018

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.