Moteur de transformation XSLT (propriété Grid)

Article
07/21/2023

À compter de BizTalk Server 2020, l’utilisateur peut choisir Saxon:registered: comme moteur de transformation XSLT. Il est également possible de brancher votre propre moteur de transformation XSLT. Utilisez la propriété Moteur de transformation XSLT pour spécifier le moteur de transformation XSLT que vous souhaitez utiliser.

L’implémentation du moteur de transformation XSL par défaut de BizTalk est basée sur les transformations XSLT .Net Framework. Cette prise en charge est limitée à XSLT 1.0. Utilisez cette propriété pour configurer d’autres moteurs de transformation XSL au niveau de la carte. Cela permet aux mappages de serveur BizTalk de prendre en charge les versions plus récentes de XSLT. À l’aide de Saxon:registered : on peut facilement utiliser XSLT3.0.

Valeurs autorisées

Valeur	Description
Indéfini	Utilisez le paramètre global du moteur de transformation XSLT. Aucune substitution spécifique à la carte n’est appliquée.
.NET Framework	Utilisez le moteur de transformation XSLT de .Net Framework pour cette carte. La propriété « Use XSL Transform » sera appliquée dans ce cas.
Saxon 9 HE	Utilisez le moteur de transformation XSLT « Saxon-HE 9 ». Pour plus d’informations, consultez www.saxonica.com.
Autre transformation XSLT personnalisée	Utilisez le moteur de transformation XSLT personnalisé. Vous trouverez plus d’informations sur l’implémentation et l’utilisation du moteur de transformation XSLT personnalisé.

Valeur par défaut

Indéfini

Créer une transformation XSLT personnalisée

Étapes pour brancher un moteur de transformation XSL personnalisé :

Implémentez une classe Microsoft.XLANGs.BaseTypes.ITransform2 abstraite dans votre code. Pour obtenir un exemple d’implémentation, consultez Implémentation de transformation XSLT personnalisée
Copiez le fichier DLL compilé dans le dossier « Transform Components » (par exemple, « \Program Files (x86)\Microsoft BizTalk Server\Transform Components ») sur chaque machine d’exécution BizTalk.
Optionnel. Pour utiliser ce moteur de transformation personnalisé dans les outils de développement Visual Studio, mettez à jour le fichier « CustomTransform.xml » dans le dossier « Outils de développement » (par exemple, « \Program Files (x86)\Microsoft BizTalk Server\Developer Tools\CustomTransform.xml ») comme ci-dessous, puis redémarrez Visual Studio :
- Ajouter un nouveau nœud « Transformer »
- Ajoutez le sous-nœud « DisplayName » avec le texte à afficher dans la liste déroulante de la propriété « Moteur de transformation XSLT »
- Ajoutez le sous-nœud « TypeAssemblyQualifiedName » avec les détails de la classe qui implémente votre moteur de transformation personnalisé Par exemple :

<Transform
  DisplayName="Saxon 9 HE"
  TypeAssemblyQualifiedName="Microsoft.XLANGs.BaseTypes.SaxonHEXsltTransform, Microsoft.XLANGs.BaseTypes, Version=3.0.1.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"
/>

Votre moteur de transformation personnalisé s’affiche dans la liste déroulante moteur de transformation XSLT après le redémarrage de Visual Studio.

Moteur de transformation XSLT global

Lorsque le moteur de tranforme XSLT au niveau de la carte est défini sur « Undefined », le moteur de transformation XSLT global est utilisé.

Par défaut, BizTalk utilise .Net Framework » comme moteur global. Pour remplacer cette valeur, spécifiez le AssemblyQualifiedName de la classe implémentant le moteur de transformation comme valeur de chaîne « XsltEngine » dans le registre BizTalk Server :

Instances hôtes 64 bits : HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\BizTalk Server\3.0\Configuration
Instances hôtes 32 bits : HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\BizTalk Server\3.0\Configuration

Saxon:registered: moteur de transformation 9

Important

Saxon:registered: 9 ne prend pas en charge les scripts incorporés . Par conséquent, les fonctoids expédiés dans le cadre de BizTalk peuvent ne pas fonctionner correctement avec Saxon 9.

Vous devez vous référer à la documentation Saxon:registered: pour connaître l’étendue de la prise en charge de XSLT et Xpath. Si vous souhaitez utiliser d’autres éditions, créez une transformation XSLT personnalisée basée sur ces éditions.

Le xml d’extension personnalisée est toujours un moyen pris en charge pour la création de votre extension personnalisée pour le moteur de transformation Saxon 9 HE. Créez des fonctions d’extension .Net personnalisées en implémentant l’interface ExtensionFunction ou ExtensionFunctionDefinition, et ajoutez vos implémentations dans l’extension XML personnalisée. Le moteur de transformation Saxon 9 HE inscrit les fonctions d’extension définies dans custom Extension XML, et le processeur de transformation peut ensuite reconnaître et appeler n’importe quel appel à partir de XSLT.

Remarques

Notes

Vous ne pouvez pas annuler ou rétablir la propriété du moteur de transformation XSLT .

Voir aussi

Propriétés de la grille

XML avec extensions personnalisées

Partager via