Hinzufügen einer Bindungsdatei zu einer Anwendung

Überblick

Verwenden Sie die BizTalk Server-Verwaltungskonsole oder die Befehlszeile, um einer BizTalk-Anwendung eine Bindungsdatei hinzuzufügen. Sie können dies tun, um die Bereitstellung von Anwendungen oder Assemblys zu vereinfachen, wie in Bindungsdateien und Anwendungsbereitstellung beschrieben.

Sie können Bindungen in eine .xml-Datei aus einer BizTalk-Anwendung für eine Assembly, Anwendung oder Gruppe exportieren, wie in exporting Bindings beschrieben, und dann eines der Verfahren in diesem Thema verwenden, um die Bindungsdatei einer Anwendung hinzuzufügen.

In diesem Fall wird die Bindungsdatei der BizTalk Management-Datenbank hinzugefügt und in der BizTalk Server-Verwaltungskonsole im Ordner "Ressourcen" der Anwendung angezeigt. Im Gegensatz zum Importieren einer Bindungsdatei wendet das Hinzufügen einer Bindungsdatei die Bindungen nicht sofort an. Stattdessen werden die Bindungen angewendet, wenn die Anwendung in eine andere BizTalk-Gruppe importiert wird.

Von Bedeutung

Aus Sicherheitsgründen entfernt BizTalk Server beim Exportieren von Bindungen die Kennwörter für die Bindungen aus der Datei. Nach dem Importieren der Bindungen müssen Sie die Kennwörter für die Sendeports und Empfangsorte neu konfigurieren, bevor sie funktionieren. Sie konfigurieren Kennwörter im Dialogfeld "Transporteigenschaften" der BizTalk Server-Verwaltungskonsole für den Sendeport oder empfangsspeicherort. Siehe Erstellen eines Sendeports oder Erstellen eines Empfangsstandorts.

Hinweis

Wenn Sie eine Bindungsdatei verwenden, sollten Sie überprüfen, ob die Artefakte an den richtigen Host gebunden wurden und dass die Vertrauensstufe geeignet ist.

Wenn Sie einer Anwendung eine Bindungsdatei hinzufügen, können Sie einen Wert für die Zielbereitstellungsumgebung mit einer Zeichenfolge angeben, die die Umgebung darstellt, z. B. Test oder Produktion. Sie können eine beliebige Zeichenfolge für diesen Wert verwenden. Wenn Sie die Anwendung importieren, können Sie dann auswählen, welche Bindungsdatei angewendet werden soll, indem Sie den Wert angeben, der für die Zielumgebung angegeben wurde. Wenn Sie dies tun, werden die Bindungen aus der Bindungsdatei angewendet. Alle vorhandenen Bindungen in der Anwendung mit demselben Namen wie Bindungen in der Datei werden automatisch überschrieben.

Wenn Sie eine Anwendung importieren, werden Bindungen in der folgenden Reihenfolge angewendet. Wenn Bindungen während des Importvorgangs angewendet werden, werden Bindungen, die bereits angewendet wurden, durch neue Bindungen mit demselben Namen überschrieben. Mit anderen Worten, die letzte Bindung eines bestimmten Namens, der angewendet werden soll, wird wirksam.

1. Anwendungsbindungen, die von BizTalk Server generiert wurden, die der Anwendung nicht explizit über eine Bindungsdatei hinzugefügt wurden, die jedoch explizit vom Benutzer für den Export in die Anwendung .msi Datei ausgewählt wurden.

2. Bindingsdateien, die explizit hinzugefügt wurden und für die keine Zielbereitstellungsumgebung angegeben ist. Bindungen in diesem Satz werden in keiner bestimmten Reihenfolge angewendet.

3. Bindungen, die explizit hinzugefügt wurden und über eine zugeordnete Zielbereitstellungsumgebung verfügen, die der für den Anwendungsimport ausgewählten Bereitstellungsumgebung entspricht. Bindungen in diesem Satz werden in keiner bestimmten Reihenfolge angewendet.

   Weitere Informationen zum Importieren von Anwendungen und anwenden von Bindungen finden Sie unter Importieren einer BizTalk-Anwendung.

Voraussetzungen

Melden Sie sich mit einem Konto an, das Mitglied der Gruppe "BizTalk Server-Administratoren" ist. Berechtigungen, die für die Bereitstellung und Verwaltung einer BizTalk-Anwendung erforderlich sind , enthält weitere Details.

Hinzufügen einer Bindungsdatei mithilfe der BizTalk-Verwaltung

1. Öffnen Sie die BizTalk Server-Verwaltung (im Startmenü).

2. Erweitern Sie die BizTalk Server-Verwaltung, erweitern Sie die BizTalk-Gruppe, erweitern Sie Anwendungen, und klicken Sie mit der rechten Maustaste auf die Anwendung, der Sie eine Bindungsdatei hinzufügen möchten.

3. Zeigen Sie auf "Hinzufügen", und klicken Sie dann auf "Ressourcen".

4. Klicken Sie auf "Hinzufügen", wählen Sie die hinzuzufügende Datei aus, und klicken Sie dann auf "Öffnen".

5. Wenn Sie eine vorhandene Bindungsdatei in dieser Anwendung mit demselben Dateinamen überschreiben möchten, aktivieren Sie das Kontrollkästchen "Alle überschreiben ". Wenn eine andere Datei mit demselben Namen vorhanden ist und Sie dieses Kontrollkästchen nicht aktivieren, schlägt der Vorgang zum Hinzufügen fehl.

6. Wählen Sie in der Dropdownliste " Dateityp " "System.BizTalk:BizTalkBinding" aus.

7. Geben Sie in "Zielumgebung" eine Zeichenfolge ein, die die Zielbereitstellungsumgebung darstellt, in der die Bindungen in dieser Datei angewendet werden sollen, z. B. "Testen", und klicken Sie auf "OK".

   Von Bedeutung

   Wenn Sie dieses Feld leer lassen, werden die Bindungen in dieser Datei immer beim Anwendungsimport angewendet.

   Die Bindungsdatei wird hinzugefügt und im Ordner "Ressourcen" der Anwendung angezeigt.

Hinzufügen einer Bindungsdatei mithilfe der Befehlszeile

1. Öffnen Sie eine Eingabeaufforderung (Startmenü> geben Sie cmd>Eingabeaufforderung ein und wählen Sie sie aus).

2. Geben Sie den folgenden Befehl ein, und ersetzen Sie die entsprechenden Werte, wie in der folgenden Tabelle beschrieben:

   BTSTask AddResource [/ApplicationName:"value"] /Type:System.BizTalk:BizTalkBinding [/Overwrite] /Source:value/Property:TargetEnvironment="value" [/Server:value] [/Database:value]

   Beispiel:

   BTSTask AddResource /ApplicationName:"My Application" /Type:System.BizTalk:BizTalkBinding /Source:"C:\Binding Files\MyBinding.xml" /Property:TargetEnvironment="Production" /Server:MyDatabaseServer /Database:BizTalkMgmtDb

   Parameter	Wert
   /ApplicationName	Name der BizTalk-Anwendung, der die Bindungsdatei hinzugefügt werden soll. Wenn der Anwendungsname nicht angegeben ist, wird die Standardmäßige BizTalk-Anwendung verwendet. Wenn der Name Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") einschließen.
   /Art	System.BizTalk:BizTalkBinding (Bei diesem Wert wird die Groß-/Kleinschreibung nicht beachtet.)
   /Überschreiben	Option zum Aktualisieren einer vorhandenen Bindungsdatei. Wenn sie nicht angegeben ist und die Bindungsdatei bereits in der Anwendung vorhanden ist, die denselben Dateinamen wie die hinzugefügte Datei aufweist, schlägt der AddResource-Vorgang fehl.
   /Quelle	Vollständiger Pfad der Bindungsdatei, einschließlich des Dateinamens. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") einschließen.
   /Property:TargetEnvironment=	Eine Zeichenfolge, die die Zielbereitstellungsumgebung angibt. Sie können eine beliebige Zeichenfolge verwenden, z. B. "Produktion". Beispiel: /Property:TargetEnvironment="Production" Wenn nicht angegeben, wird automatisch ein Standardwert <> angewendet. Der Wert ist groß-/kleinschreibungssensitiv. Wenn der Wert Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") einschließen. Die maximale Länge des Umgebungswerts beträgt 128 Zeichen.
   /Server	Name der SQL Server-Instanz, die die BizTalk Management-Datenbank hosten, im Format ServerName\InstanceName,Port. Der Instanzname ist nur erforderlich, wenn sich der Instanzname von dem Servernamen unterscheidet. Port ist nur erforderlich, wenn SQL Server eine andere Portnummer als die Standardnummer verwendet (1433). Beispiele Server=MyServer Server=MyServer\MySQLServer,1533 Falls nicht angegeben, wird der Name der SQL Server-Instanz verwendet, die auf dem lokalen Computer ausgeführt wird.
   /Datenbank	Name der BizTalk-Verwaltungsdatenbank. Wenn nicht angegeben, wird die BizTalk Management-Datenbank verwendet, die in der lokalen Instanz von SQL Server ausgeführt wird.

Siehe auch

Verwalten von .NET-Assemblys, Zertifikaten und anderen Ressourcen
AddResource-Befehl: BizTalk Binding
Erstellen und Ändern von BizTalk-Anwendungen