// Do not edit directly!
// This file was generated by camel-quarkus-maven-plugin:update-extension-doc-page
[id="extensions-atlasmap"]
= AtlasMap
:linkattrs:
:cq-artifact-id: camel-quarkus-atlasmap
:cq-native-supported: true
:cq-status: Stable
:cq-status-deprecation: Stable
:cq-description: Transforms the message using an AtlasMap transformation.
:cq-deprecated: false
:cq-jvm-since: 1.5.0
:cq-native-since: 1.7.0

ifeval::[{doc-show-badges} == true]
[.badges]
[.badge-key]##JVM since##[.badge-supported]##1.5.0## [.badge-key]##Native since##[.badge-supported]##1.7.0##
endif::[]

Transforms the message using an AtlasMap transformation.

[id="extensions-atlasmap-whats-inside"]
== What's inside

* xref:{cq-camel-components}::atlasmap-component.adoc[AtlasMap component], URI syntax: `atlasmap:resourceUri`

Please refer to the above link for usage and configuration details.

[id="extensions-atlasmap-maven-coordinates"]
== Maven coordinates

https://{link-quarkus-code-generator}/?extension-search=camel-quarkus-atlasmap[Create a new project with this extension on {link-quarkus-code-generator}, window="_blank"]

Or add the coordinates to your existing project:

[source,xml]
----
<dependency>
    <groupId>org.apache.camel.quarkus</groupId>
    <artifactId>camel-quarkus-atlasmap</artifactId>
</dependency>
----
ifeval::[{doc-show-user-guide-link} == true]
Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
endif::[]

[id="extensions-atlasmap-allowcontextmapall-option-in-native-mode"]
== allowContextMapAll option in native mode

The `allowContextMapAll` option is not supported in native mode as it requires reflective access to security sensitive camel core classes such as
`CamelContext` & `Exchange`. This is considered a security risk and thus access to the feature is not provided by default.

[id="extensions-atlasmap-additional-camel-quarkus-configuration"]
== Additional Camel Quarkus configuration

Note that you can perform mapping for these types of data:

* Java
* XML
* Json
* CSV

The _ADM archive file_ or _mapping definition JSON file_ used in the _AtlasMap route_ should be located in the _resources_ repository.
In native mode, include this file for native build. Example:
[source,properties]
----
quarkus.native.resources.includes = mapping/atlas-mapping.json
----

When mapping Java documents, you may need to register the corresponding Java classes for reflection.

You may want to check the https://github.com/apache/camel-quarkus/tree/main/integration-tests/atlasmap[integration test] in our source tree as an example.

