Altova MapForce 2027 Professional Edition

Une exception est un type de composant spécial qui vous permet d'interrompre le processus de mappage et d'afficher un message d'erreur lorsqu'une condition renvoyée par un filtre se produit. Vous pouvez ajouter une exception lorsque votre mappage inclut un filtre qui vérifie une condition true/false (voir Filtres et conditions). Par exemple, vous pouvez souhaiter déclencher une exception si la valeur d’un élément de mappage est supérieure à un seuil personnalisé.

 

Pour ajouter une exception au mappage :

 

1.dans le menu Insérer, cliquez sur Exception.

2.Cliquez sur le bouton Insérer exception ( ic-component_exception ) de la barre d’outils.

3.Connectez l’entrée throw de l’exception soit à une sortie on-true, soit à une sortie on-false d’un filtre.

4.Vous pouvez également connecter l’entrée error-text de l’exception à un autre composant (généralement une constante) qui fournit le texte de l’erreur lorsque cette exception est levée.

 

Note : Les sorties on-true et on-false du filtre doivent toutes deux être connectées. Plus précisément, l’une de ces sorties doit être connectée directement à l’exception (sans aucune fonction ni composant intermédiaire). L’autre sortie doit être connectée au composant cible, soit directement, soit via d’autres composants intermédiaires.

 

Lorsque le mappage rencontre une exception, vous en êtes informé comme suit :

 

•Dans MapForce, la fenêtre Messages affiche une erreur ainsi que le texte de l’exception (dans ce cas, « Limite de dépenses dépassée »).

except-xslt2

Si le langage de mappage est XSLT 2.0 ou XQuery, une erreur « Échec de l’exécution » s’affiche dans la fenêtre Messages, et l’onglet XSLT2 ou XQuery correspondant s’ouvre. La ligne d’erreur est mise en surbrillance dans la fenêtre Messages.

 

•Si vous exécutez le mappage avec MapForce Server, l’erreur « Exception was thrown! » est renvoyée, suivie du texte d’exception personnalisé que vous avez défini dans MapForce.

exception_mfs

•Si vous exécutez le mappage à partir du code C#, C++ ou Java généré, l’erreur « USER EXCEPTION » est renvoyée, suivie du texte d’exception personnalisé que vous avez défini dans MapForce.

exception_codegen

© 2020-2026 Altova GmbH