Freigeben über

Überprüfung zur Laufzeit für die Orchestrierungs-Engine

  • Artikel

Sie können die Orchestrierungs-Engine so konfigurieren, dass sie zur Laufzeit verschiedene Überprüfungen durchführt, mit deren Hilfe Sie die Orchestrierung testen und möglicherweise auftretende Konfigurations- oder Datenfehler untersuchen können.

Sie können in BTSNTSvc.exe.config Flags festlegen. Hierbei handelt es sich um eine Konfigurationsdatei, die Sie im selben Verzeichnis wie BTSNTSvc.exe (üblicherweise im BizTalk-Bereitstellungsverzeichnis) erstellen und bearbeiten können. In der Datei BTSNTSvc.exe.config können Sie die folgenden Flags festlegen:

  • Wenn Sie das ValidateAssemblies-Flag auf Truefestlegen, versucht die Engine, alle Assemblys zu laden, auf die von unmittelbar abhängigen Assemblys einer Orchestrierung verwiesen wird. Bei einem Fehler wird Microsoft.XLANGs.Core.AssemblyValidationException ausgelöst.

  • Wenn Sie das ValidateSchemas-Flag auf Truefestlegen, verwendet die Engine System.Xml. XmlValidatingReader zum Überprüfen jedes Schemas, das einen Nachrichtenteiltyp darstellt, und bei Einem Fehler wird System.Xml ausgelöst. Xmlexception.

  • Wenn Sie das ValidateCorrelations-Flag auf Truefestlegen, überprüft die Engine, ob in einer parallelen Konvoi alle Nachrichten, die mit einem der Konvoi empfangen werden, die gleichen Korrelationseigenschaftswerte aufweisen und bei einem Fehler Microsoft.XLANGs.Core.CorrelationValidationException auslöst.

  • Wenn Sie das Flag ExtendedLogging auf Truefestlegen, zeigt die Engine die heraufgestuften Eigenschaften in den Informationen für Microsoft.XLANGs.BaseTypes.PublishMessageException für die Meldung an, die nicht veröffentlicht werden konnte.

    Wenn Sie eine Überprüfung deaktivieren möchten, entfernen Sie das Flag vollständig aus der Konfigurationsdatei. Wenn alle Überprüfungen aktiviert sind, überprüft die Engine Assemblys, Schemas und Korrelationen. Weitere Informationen und Beispiele für BTSNTSvc.exe.config finden Sie unter Orchestrierungsmodulkonfiguration.

Überprüfen von Assemblys

Die Orchestrierungs-Engine überprüft, ob alle Assemblys, auf die die Orchestrierung verweist, verfügbar sind. Damit bei der Überprüfung keine Fehler auftreten, müssen sich alle Assemblys, auf die verwiesen wird, beim Aktivieren der ersten Instanz der Orchestrierung im globalen Assemblycache (GAC) befinden. Wenn bei der Überprüfung Fehler auftreten, wird im Anwendungsprotokoll ein Fehler gespeichert, und die Orchestrierung wird angehalten.

Überprüfen von Schemas

Jedes Mal, wenn ein XSD-Element zugeordnet wird, überprüft die Orchestrierungs-Engine die Daten des Elements anhand des eigenen Schemas. Wenn bei der Überprüfung Fehler auftreten, wird der Fehler im Anwendungsprotokoll gespeichert, und eine Ausnahme wird ausgelöst.

Überprüfen von Korrelationen

Die Orchestrierungs-Engine bestätigt, dass die Eigenschaftswerte, die für die Korrelation mit einer bestimmten Instanz einer Orchestrierung festgelegt sind, für jede Nachricht gelten, die von dieser Orchestrierungsinstanz gesendet wird. Wenn validateCorrelation nicht festgelegt ist, geht die Engine davon aus, dass die gesendete Nachricht die richtigen Korrelationswerte enthält, und es wird keine Überprüfung durchgeführt.

Wenn die Korrelationsüberprüfung fehlschlägt, protokolliert die Engine einen Fehler im Anwendungsprotokoll und löst eine Ausnahme vom Typ CorrelationValidationException aus.

Standardmäßig ist validateCorrelation nicht festgelegt.

Weitere Informationen

Debuggen von Orchestrierungen
Konfiguration der Orchestrierungs-Engine