Altova MapForce 2025 Professional Edition

Navigation: L'API de MapForce > Référence d’objet > Interfaces

Mappage

Un objet de mappage représente un mappage dans un document, soit le mappage principal, soit le mappage de fonction définie par l'utilisateur.

Propriétés pour parcourir le modèle d’objet :

•Application

•Parent

Propriétés au mappage :

•IsMainMapping

•Nom

Composants dans le mappage :

•Composants

Ajouter des éléments :

•CreateConnection

•InsertFunctionCall

•InsertXMLFile

•InsertXMLSchema

•InsertXMLSchemaInputParameter

•InsertXMLSchemaOutputParameter

Propriétés

Nom	Description
Application	Lecture seule. Extrait l’objet de l’application de premier niveau.
Composants	Lecture seule. Renvoie une collection de tous les composants dans le mappage actuel.
IsMainMapping	Lecture seule. Indique si le mappage actuel est le mappage principal du document dans lequel le mappage se trouve. True signifie qu’il s’agit du mappage principal. False signifie qu’il s’agit d’une fonction définie par l’utilisateur (UDF).
Nom	Lecture seule. Le nom du mappage ou de la fonction définie par l'utilisateur (UDF).
Parent	Lecture seule. L’objet parent selon le modèle d’objet.

Méthodes

Nom	Description
CreateConnection	Crée une connexion entre les deux datapoints fournis (DatapointFrom & DatapointTo). La connexion ne sera pas établie si DatapointFrom n’est pas un datapoint output-side, si DatapointTo n’est pas un datapoint input-side, ou si une connexion entre ces deux datapoints existe déjà.
InsertFunctionCall	Insère un composant d’appel de fonction dans le mappage actuel. Les noms de bibliothèque et de fonction spécifiés indiquent la fonction ou la fonction définie par l’utilisateur à appeler.
InsertXMLFile	Ajoute un nouveau compostant de schéma XML au mappage. La structure interne du composant est déterminée par le schéma référencé dans le fichier XML spécifié (i_strFileName) ou, si le fichier XML ne référence pas de fichier de schéma, par le fichier de schéma spécifié séparément (i_strSchemaFileName). Si le fichier XML a une référence de fichier de schéma, alors le paramètre i_strSchemaFileName est ignoré. L’élément racine du fichier XML sera utilisé dans le composant. Le fichier XML spécifié est utilisé comme échantillon d‘entrée pour évaluer le mappage.
InsertXMLSchema	Ajoute un nouveau compostant de schéma XML au mappage. La structure interne du composant est déterminée par le fichier de schéma spécifié dans le premier paramètre. Le deuxième paramètre définit l’élément racine de ce schéma s’il existe plus d’un candidat. Si l’élément racine passé est un string vide et plus de candidats sont disponibles, une boîte de dialogue Sélectionner l’élément racine apparaîtra si MapForce est visible. Si MapForce est invisible, aucune boîte de dialogue n’apparaîtra et seule une erreur est retournée. Aucun échantillon d’entrée XML n’est assigné à ce composant.
InsertXMLSchemaInputParameter	Insère un composant de paramètre d’entrée du schéma XML dans le mappage actuel. Le mappage actuel doit être une fonction définie par l'utilisateur. Tenter de l’insérer (le paramètre d’entrée de schéma) dans le mappage principal échouera.
InsertXMLSchemaOutputParameter	Insère un composant de paramètre de sortie de schéma XML dans le mappage actuel. Le mappage actuel doit être une fonction définie par l'utilisateur. Tenter de l’insérer (le paramètre de sortie du schéma) dans le mappage principal échouera.