Bereitstellen von Pipelines

Artikel
05/04/2023

Pipelines werden im Rahmen der Projektmappenerstellung und -bereitstellung kompiliert und bereitgestellt. Der Compiler ruft die Validate-Methode für jede Komponente auf, sodass die Komponenten Kompilierungsfehler für die konfigurierten Informationen zurückgeben können. Nach dem Erstellen wird die Pipeline in derselben Assembly mit der übrigen Projektmappe bereitgestellt, wenn diese bereitgestellt wird.

Pipelinekonfiguration pro Instanz

Die Pipelinekonfiguration pro Instanz dient dazu, die Eigenschaften der Pipelinekomponenten innerhalb einer bereitgestellten Pipeline auf der Sendeport- oder der Empfangsspeicherortebene zu ändern. Die Pipelinekonfiguration pro Instanz ist nützlich, wenn nur wenige Eigenschaften der Pipelinekomponente pro Instanz geändert werden müssen. Wenn beispielsweise verschiedene Nachrichtentypen an mehreren Empfangsspeicherorten unterstützt werden müssen, und es ist eine einzelne benutzerdefinierte XML-Empfangspipeline vorhanden, können Sie die Pipeline mit der Pipelinekonfiguration pro Instanz bereitstellen und die Standardkonfiguration überschreiben (dies schließt die Festlegung verschiedener Namen für Umschlag- und Dokumentspezifikationen ein). Dieser Mechanismus wird in der BizTalk-Verwaltungskonsole und programmgesteuert über das Explorer-Objektmodell unterstützt.

Pipelinekonfiguration pro Instanz mithilfe der BizTalk-Verwaltungskonsole

Die Pipelinekonfiguration pro Instanz kann mit der BizTalk-Verwaltungskonsole ausgeführt werden. Nach dem Bereitstellen der benutzerdefinierten Pipeline können Sie beliebig viele Empfangsspeicherorte oder Sendeports erstellen. Im Dialogfeld Pipeline konfigurieren können Sie anschließend die Standardeigenschaftswerte für jeden Empfangsspeicherort oder Sendeport überschreiben. Um beispielsweise ein anderes Dokumentschema anzugeben, geben Sie einen Schemanamen für die EnvelopeDocSpecNames-Eigenschaft ein.

Warnung

Die im Empfangsspeicherort oder Sendeport angegebenen Konfigurationswerte werden nicht überprüft. Wenn die Konfiguration nicht korrekt ist, kommt es zur Laufzeit bei Nachrichten, die die Pipeline durchlaufen, zu Fehlern.

Pipelinekonfiguration pro Instanz mit dem Explorer-Objektmodell

Beim Lesen der XML-Datei, die die Konfiguration der Pipelinekomponenten pro Instanz beschreibt, werden die in der Pipelinedatei festgelegten Eigenschaften überschrieben.

Die Pipelinekonfiguration pro Instanz wird mit dem Objektmodell für BizTalk-Explorer festgelegt. Das BizTalk-Explorer-Objektmodell stellt die ReceivePipelineData-Eigenschaft auf den IReceiveLocation- und ISendPort-Schnittstellen zum Festlegen der Konfiguration der Empfangspipelinekomponenten bereit. Das BizTalk-Explorer-Objektmodell stellt auch die SendPipelineData-Methode auf den IReceivePort- und ISendPort-Schnittstellen zum Festlegen der Konfiguration von Sendepipelinekomponenten bereit.

Die folgenden Vorgänge werden bei der Pipelinekonfiguration pro Instanz nicht unterstützt:

Neuanordnen von Stufen innerhalb der Pipeline
Hinzufügen oder Entfernen von Stufen
Neuanordnen von Komponenten innerhalb von Stufen
Hinzufügen oder Entfernen von Komponenten

Es werden nur Änderungen in der Konfiguration der Pipelinekomponenten unterstützt. Die Konfiguration einer Pipelinekomponente pro Instanz überschreibt die allgemeine Konfiguration der Pipelinekomponente. Wenn ein Parameter einer Komponente in der Pipelinekonfiguration pro Instanz nicht angegeben ist, wird für diesen Parameter die allgemeine Konfiguration (wie im Pipeline-Designer konfiguriert) verwendet.

Das folgende Beispiel zeigt die Daten einer Konfiguration pro Instanz.

<?xml version="1.0" encoding="utf-16"?>  
<Root xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
    <Stages>  
        <Stage CategoryId="9d0e4103-4cce-4536-83fa-4a5040674ad6">  
            <Components>  
                <Component Name=Microsoft Microsoft.BizTalk.Component.MIME_SMIME_Decoder>  
                    <Properties>  
                        <AllowNonMIMEMessage vt=11>true</AllowNonMIMEMessage>  
                    </Properties>  
                </Component>  
            </Components>  
        </Stage>  
        <Stage CategoryId="9d0e4105-4cce-4536-83fa-4a5040674ad6">  
            <Components>  
                <Component Name=Microsoft.BizTalk.Component.XmlDasmComp>  
                    <Properties>  
                        <EnvelopeSpecNames vt=8>MySchemas.EnvelopeSpecNames</EnvelopeSpecNames>  
                        <AllowUnrecognizedMessage vt=11>false</AllowUnrecognizedMessage>  
                    </Properties>  
                </Component>  
            </Components>  
        </Stage>  
        <Stage CategoryId="9d0e410d-4cce-4536-83fa-4a5040674ad6" ExecutionSequence="2">  
            <Components>  
                 <Component Name=Microsoft.BizTalk.Component.XmlValidator >  
                    <Properties>  
                        <DocumentSpecName vt=8>MySchemas.DocspecName</DocumentSpecName>  
                    </Properties>  
                </Component>  
            </Components>  
        </Stage>  
    </Stages>  
</Root>

Weitere Informationen

Entwickeln von benutzerdefinierten Pipelinekomponenten

Teilen über