XSLT-Transformations-Engine (Grid-Eigenschaft)
Ab BizTalk Server 2020 können Benutzer Saxon:registered: als XSLT-Transformations-Engine auswählen. Es ist auch möglich, Ihre eigene XSLT-Transformations-Engine zu plug-in. Verwenden Sie die XSLT-Transformations-Engine-Eigenschaft , um die XSLT-Transformations-Engine anzugeben, die Sie verwenden möchten.
Die Standardmäßigimplementierung der XSL-Transformations-Engine von BizTalk basiert auf XSLT-Transformationen von .NET Framework. Diese Unterstützung ist auf XSLT 1.0 beschränkt. Verwenden Sie diese Eigenschaft, um andere XSL-Transformations-Engines auf Zuordnungsebene zu konfigurieren. Dadurch können BizTalk-Serverzuordnungen neuere Versionen von XSLT unterstützen. Mit Saxon:registered kann xslt3.0 problemlos verwendet werden.
Category
Compiler
Zulässige Werte
| value | BESCHREIBUNG |
|---|---|
| Nicht definiert | Verwenden Sie die Einstellung der globalen XSLT-Transformations-Engine. Es wird keine zuordnungsspezifische Außerkraftsetzung angewendet. |
| .Net Framework | Verwenden Sie die XSLT-Transformations-Engine ".Net Framework" für diese Zuordnung. In diesem Fall wird die Eigenschaft "Use XSL Transform" (XSL-Transformation verwenden) angewendet. |
| Sachsen 9 HE | Verwenden Sie die XSLT-Transformations-Engine "Saxon-HE 9". Weitere Informationen finden Sie unter www.saxonica.com. |
| Andere benutzerdefinierte XSLT-Transformation | Verwenden Sie die benutzerdefinierte XSLT-Transformations-Engine. Weitere Informationen zum Implementieren und Verwenden der benutzerdefinierten XSLT-Transformations-Engine finden Sie im Folgenden. |
Standardwert
Nicht definiert
Erstellen einer benutzerdefinierten XSLT-Transformation
Schritte zum Anschließen einer benutzerdefinierten XSL-Transformations-Engine:
- Implementieren Sie eine abstrakte Klasse
Microsoft.XLANGs.BaseTypes.ITransform2in Ihrem Code. Eine Beispielimplementierung finden Sie unter Implementierung der benutzerdefinierten XSLT-Transformation. - Kopieren Sie die kompilierte DLL-Datei auf jedem BizTalk-Laufzeitcomputer in den Ordner "Transform Components" (z. B. "\Programme (x86)\Microsoft BizTalk Server\Transform Components").
- Optional. Um diese benutzerdefinierte Transformations-Engine in den Visual Studio-Entwicklertools zu verwenden, aktualisieren Sie die Datei "CustomTransform.xml" im Ordner "Entwicklertools" (z. B. "\Programme (x86)\Microsoft BizTalk Server\Developer Tools\CustomTransform.xml") wie folgt, und starten Sie Visual Studio neu:
- Hinzufügen eines neuen Transformationsknotens
- Hinzufügen des Unterknotens "DisplayName" mit Text, der in der Dropdownliste für die Eigenschaft "XSLT-Transformations-Engine" angezeigt werden soll
- Fügen Sie den Unterknoten "TypeAssemblyQualifiedName" mit Details zur Klasse hinzu, die Ihre benutzerdefinierte Transformations-Engine implementiert. Beispiel:
<Transform
DisplayName="Saxon 9 HE"
TypeAssemblyQualifiedName="Microsoft.XLANGs.BaseTypes.SaxonHEXsltTransform, Microsoft.XLANGs.BaseTypes, Version=3.0.1.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"
/>
Ihre benutzerdefinierte Transformations-Engine wird nach dem Neustart von Visual Studio in der Dropdownliste der XSLT-Transformations-Engine angezeigt.
Globale XSLT-Transformations-Engine
Wenn die XSLT-Tranform-Engine auf Zuordnungsebene auf "Undefined" festgelegt ist, wird die globale XSLT-Transformations-Engine verwendet.
Standardmäßig verwendet BizTalk ".Net Framework" als globale Engine. Um diesen Wert zu überschreiben, geben Sie den AssemblyQualifiedName der Klasse an, die die Transformations-Engine implementiert, als Zeichenfolgenwert "XsltEngine" in der BizTalk Server Registrierung:
- 64-Bit-Hostinstanzen:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\BizTalk Server\3.0\Configuration - 32-Bit-Hostinstanzen:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\BizTalk Server\3.0\Configuration
Saxon:registered: 9 transform engine
Wichtig
Saxon:registered: 9 unterstützt keine eingebettete Skripterstellung. Daher funktionieren Funktoide, die im Rahmen von BizTalk ausgeliefert werden, möglicherweise nicht gut mit Saxon 9.
Informationen zum Umfang der XSLT- und Xpath-Unterstützung finden Sie in der Dokumentation zu Saxon:registered. Wenn Sie andere Editionen verwenden möchten, erstellen Sie basierend auf diesen Editionen eine benutzerdefinierte XSLT-Transformation.
Benutzerdefinierte Erweiterungs-XML ist weiterhin eine unterstützte Möglichkeit zum Erstellen Ihrer benutzerdefinierten Erweiterung für saxon 9 HE Transformation Engine. Erstellen Sie benutzerdefinierte .NET-Erweiterungsfunktionen, indem Sie die Schnittstelle ExtensionFunction oder implementieren ExtensionFunctionDefinition, und fügen Sie Ihre Implementierungen in benutzerdefinierte Erweiterungs-XML hinzu. Die Transformations-Engine von Saxon 9 HE registriert Erweiterungsfunktionen, die in benutzerdefinierter Erweiterungs-XML definiert sind, und der Transformationsprozessor kann dann jeden Aufruf von XSLT erkennen und aufrufen.
Bemerkungen
Hinweis
Sie können die XSLT-Transformations-Engine-Eigenschaft nicht rückgängig machen oder wiederholen.