Quickly get started using AtlasMap UI standalone

To run AtlasMap UI standalone:

Obtain the most recent AtlasMap version number:
1. Go to https://github.com/atlasmap/atlasmap/
2. Scroll down to see the maven central icon with the latest version, for example: .
Download the AtlasMap standalone .jar file by invoking the wget command with the following format. Replace ${VERSION} with an actual version number.
```
wget https://repo1.maven.org/maven2/io/atlasmap/atlasmap-standalone/${VERSION}/atlasmap-standalone-${VERSION}.jar
```

Run AtlasMap standalone by invoking the java command with the following format:

$ java -jar atlasmap-standalone-${VERSION}.jar

For example:

$ java -jar atlasmap-standalone-1.42.3.jar

Note

Although it is not a common situation, you can start AtlasMap and also load mapping definitions if you have an AtlasMap .adm file. An AtlasMap .adm file contains mapping definitions that were exported from AtlasMap. For example, suppose you want to start AtlasMap and import the /home/aslan/Downloads/atlas-mapping.adm file. Invoke a command such as the following:

$ java -Datlasmap.adm.path=/home/aslan/Downloads/atlas-mapping.adm -jar atlasmap-standalone-1.42.3.jar

In a browser, visit http://127.0.0.1:8585/ to see the AtlasMap data mapper canvas.
Experiment with the data mapper:
1. At the top of the Source panel, click to import a JSON or XML file that you can map fields from.
2. At the top of the Target panel, click to import a different JSON or XML file that you can map fields to.
3. To map fields:
  1. Navigate to a source field and click .
    
    The Mapping Details panel will slide in from the right.
  2. Either:
    
    Navigate to a target field and click to add it to the selected mapping, or
    
    Drag and drop a target field on the source field to add the target field to the mapping.
4. With a data mapping selected, explore the optional transformations.
5. To preview a data mapping result, click and enter sample data in source Mapping preview fields.
6. To save your work, click the AtlasMap menu and select Export the current mappings and support files into a catalog (.adm)
  
  .
  
  Then choose a folder in which to save an AtlasMap .adm file. This file contains the mapping definitions.