Une XMap est un objet de transformation Processeur de données qui modifie un document d'entrée hiérarchique en un autre document hiérarchique dont la structure hiérarchique est différente.
Une XMap utilise les schémas d'entrée et de sortie pour définir la hiérarchie attendue des documents d'entrée et de sortie. Utilisez l'éditeur XMap pour définir et gérer des instructions de mappage. L'éditeur XMap contient la hiérarchie du schéma d'entrée et celle du schéma de sortie. Les instructions de mappage lient les éléments du schéma d'entrée aux éléments du schéma de sortie.
Une XMap peut transformer tout document hiérarchique d'entrée dont les éléments correspondent à la hiérarchie du schéma d'entrée en document de sortie avec la hiérarchie du schéma de sortie.
Par exemple, une XMap peut transformer des factures client en une liste de commandes client triées par mois de l'année. L'entrée est un document JSON qui contient une hiérarchie d'éléments client. La sortie est un document XML qui contient une hiérarchie d'éléments mois. Le document XML de sortie groupe la commande client par mois et inclut les informations de contact et les totaux de la commande.
L'image suivante montre l'éditeur XMap.
L'éditeur XMap contient des schémas hiérarchiques d'entrée et de sortie. Faites glisser et déplacez les éléments de schéma pour créer des instructions de mappage.
La grille de l'éditeur XMap affiche les instructions de mappage. Utilisez la grille pour gérer et éditer les instructions de mappage.
Une XMap utilise les instructions de mappage pour définir comment transformer un élément de schéma d'entrée en élément de schéma de sortie. Vous pouvez glisser d'un nœud dans le schéma d'entrée vers un nœud dans le schéma de sortie pour créer un lien. Lorsque vous créez des liens, ils sont des instructions de mappage. L'éditeur XMap affiche l'instruction de mappage dans la grille.
Vous pouvez éditer les instructions de mappage dans la grille. Vous pouvez définir des conditions pour transformer et filtrer les données selon différents types d'instructions de mappage et d'expressions XPath. XPath est un langage de requête utilisé pour sélectionner des nœuds dans un document hiérarchique et exécuter des calculs.
Vous pouvez utiliser les expressions XPath pour définir le contexte pour une instruction de mappage. Vous pouvez également ajouter divers calculs arithmétiques à une instruction de mappage à l'aide d'expressions XPath.