Altova MapForce 2024 Enterprise Edition

Fonctions définies par l'utilisateur

Accueil Préc Haut Suivant

Les Fonctions définies par l'utilisateur (UDF en abrégé) sont des fonctions personnalisées définies une fois et réutilisables plusieurs fois dans le cadre du même mappage ou sur de plusieurs mappages. Les FDU sont de mini-mappages eux-mêmes : elles consistent généralement en un ou plusieurs paramètres, certains composants intermédiaires pour traiter les données et une sortie pour retourner les données à l'appelant. L'appelant est le mappage principal ou une autre UDF

 

Avantages des FDU

Les FDU ont les avantages suivants :

 

Les FDU sont réutilisables à l’intérieur d’un mappage ou dans de multiples mappages.

Les FDU peuvent faciliter la lecture de votre mappage : Par exemple, vous pouvez mettre en packages des parties du mappage en composants plus petits et abstraire des détails de mise en œuvre. Le diagramme ci-dessous illustre ce principe.

mff_udf

Les UDF sont des fonctions flexibles qui vous permettent de procéder des strings, nombres, dates et d’autres données de manière personnalisée qui agrandit les fonctions built-in de MapForce. Par exemple, vous voulez concaténer ou séparer du texte, réaliser des calculs en avance, manipuler des dates et heures, etc.

Une autre utilisation commune des FDU est de rechercher un champ dans un fichier XML, une base de données ou tout autre format de données pris en charge par votre édition de MapForce et présenter ces données de manière utile. Pour les détails, voir Look-up Implementation.

Les FDU peuvent être appelées récursivement (par ex., la FDU s’appelle elle-même). Ceci requiert que la FDU soit définie comme fonction régulière (pas inline). Les FDU récursives peuvent remplir plusieurs exigences de mappage avancées, telles l’iération sur des structures de données ayant une profondeur d’enfants N, où N n’est pas connu à l’avance.

 

Exemple

L'exemple suivant montre une FDU simple qui partage un string en deux strings séparés. Cette FDU fait partie d’un plus grand mappage appelé MapForceExamples\ContactsFromPO.mfd. Il prend un nom en tant que paramètre (par exemple, Helen Smith), applique les fonctions intégrées substring-before et substring-after, puis retourne deux valeurs : Helen et Smith.

mf_udf_01

 

Dans cette section

Cette section vous explique comment travailler avec des FDU et est organisé comme suit :

 

Notions fondamentales des FDU

Paramètres FDU

FDU récursives

Implémentation de la consultation

 

© 2018-2024 Altova GmbH