Freigeben über

Erweitern des BizTalk-Editors

BizTalk Editor wurde entwickelt, um Erweiterungen zuzulassen, die alternative Instanznachrichtenformate unterstützen. Tatsächlich ist das XML-Format das einzige Format, das in BizTalk Editor integriert ist. Auch die Unterstützung für flache Dateiformate, die in Microsoft BizTalk Server enthalten ist, wird als BizTalk Editor-Erweiterung implementiert und dient somit als gutes Beispiel für die Art der Funktionalität, die von solchen Erweiterungen hinzugefügt werden kann.

Im Allgemeinen speichern BizTalk Editor-Erweiterungen ihre benutzerdefinierten Daten als XSD-Sprachanmerkungen (XML Schema Definition), die den XSD-Elementen zugeordnet sind, die den Knoten in der Schemastruktur entsprechen. Auch hier dient der umfangreiche Satz von Anmerkungen, die von der Flat File Extension zum BizTalk Editor hinzugefügt wurden, als gutes Beispiel dafür, wie BizTalk Editor-Erweiterungen ihre benutzerdefinierten Daten im Schema speichern können.

BizTalk-Editor-Erweiterungen sind .NET-Assemblys, die die Funktionalität des BizTalk-Editors erweitern. Um als Erweiterung identifiziert zu werden, muss eine Assembly über eine Klasse verfügen, die die IExtension-Schnittstelle implementiert, und muss sich im Ordner "Entwicklertools\Schema-Editorerweiterungen" im Produktinstallationsverzeichnis befinden.

Der Entwickler einer Erweiterung muss über einen Assemblyverweis auf die Microsoft.BizTalk.SchemaEditor.Extensibility.dllverfügen, die die Definition aller Schnittstellen enthält, die zum Verfügbarmachen erweiterter Funktionen für den BizTalk-Editor erforderlich sind. Diese Schnittstellen werden unter dem Namespace "Microsoft.BizTalk.SchemaEditor.Extensibility " definiert.

Die IExtension-Schnittstelle ist der Einstiegspunkt für die Erweiterung, von dem BizTalk Editor auf die erweiterte Funktionalität zugreift, z. B. Eigenschaftenmanager, benutzerdefinierte Ansichten, Schemaüberprüfung, Systeminstanzgenerierung und systemeigene Instanzüberprüfung.

Ein bestimmtes Schema kann mehrere Erweiterungen zugeordnet haben, aber nur eine kann zu einem bestimmten Zeitpunkt als Standard festgelegt werden. dies wird in der Standard-Eigenschaft des Schemaknotens festgelegt. Die zurzeit als Standard festgelegte Erweiterung ist die erweiterung, die für die systemeigene Instanzgenerierung und -validierung sowie für die Schemaüberprüfung verwendet wird.

Erweiterungen können einem bestimmten Schema zugeordnet werden, indem die Schema-Editor-Erweiterungseigenschaft des Schemaknotens bearbeitet wird. Die Informationen zu den Erweiterungen, die einem Schema zugeordnet sind, werden im Schema selbst im Anmerkungselement des Schemaelements gespeichert, wie im folgenden XSD-Fragment dargestellt.

<?xml version="1.0" encoding="utf-16" ?>   
<xs:schema xmlns="http://BizTalk_Server_Project1.Schema11"  
        xmlns:b="http://schemas.microsoft.com/BizTalk/2003"  
        targetNamespace="http://BizTalk_Server_Project1.Schema11"  
        xmlns:xs="http://www.w3.org/2001/XMLSchema">  
    <xs:annotation>  
        <xs:appinfo>  
            <schemaEditorExtension:schemaInfo namespaceAlias="b"  
                extensionClass="Microsoft.BizTalk.FlatFileExtension.FlatFileExtension"  
                standardName="Flat File"  
                xmlns:schemaEditorExtension="http://schemas.microsoft.com/BizTalk/2003/SchemaEditorExtensions" />  
            <b:schemaInfo schema_type="document" root_reference="Root"  
                is_receipt="no" schema_name="abc"  
                standard="Flat File"  
                count_positions_by_byte="false" />   
        </xs:appinfo>  
    </xs:annotation>  
    <xs:element name="Root">  
        ...

Nach dem Instanziieren des Erweiterungsobjekts ruft das Framework die Initialize-Methode der IExtension-Schnittstelle auf und übergibt ein ITree-Objekt , sodass die Erweiterung auf Informationen zur Schemastruktur zugreifen kann. Die Erweiterung könnte beispielsweise alle untergeordneten Knoten durchlaufen, indem sie auf die ITree.RootNode-Eigenschaft zugreift.

In diesem Abschnitt werden die Möglichkeiten beschrieben, wie eine BizTalk Editor-Erweiterung in die BizTalk Editor-Umgebung integriert und sich in vorhandene BizTalk Editor-Befehle integrieren kann.

In diesem Abschnitt