Hinzufügen einer COM-Komponente zu einer Anwendung

In diesem Thema wird erläutert, wie Sie mithilfe der BizTalk Server-Verwaltungskonsole oder der Befehlszeile eine COM-Komponente zu einer BizTalk-Anwendung hinzufügen.

Beachten Sie beim Hinzufügen einer COM-Komponente zu einer Anwendung die folgenden wichtigen Punkte:

• Legen Sie die Option Überschreiben fest, wenn Sie eine in der Anwendung vorhandene COM-Komponente überschreiben möchten. Die Option Überschreiben ist nur erforderlich, wenn beide Elemente über dieselbe lokal eindeutige Kennung (LUID) verfügen. Wenn diese Option nicht angegeben wird und in der Anwendung bereits eine COM-Komponente mit der gleichen LUID wie die hinzuzufügende existiert, kann die COM-Komponente nicht hinzugefügt werden. Sie können die LUIDs für die Artefakte in einer Anwendung anzeigen, indem Sie den ListApp-Befehl verwenden.

• Die Abhängigkeiten für COM-Komponenten und deren Vorhandensein werden von BizTalk Server nicht überprüft. Daher sollten Sie sicherstellen, dass alle Elemente, von denen die Komponente abhängig ist, vorhanden sind.

• Wenn Sie eine nicht verwaltete 64-Bit-COM- oder -COM+-Komponente hinzufügen und versuchen, die Anwendung mit der COM- oder COM+-Komponente auf einem 32-Bit-Computer zu installieren, wird die Komponente nicht installiert. Es wird nur auf einem 64-Bit-Computer installiert.

Voraussetzungen

Zum Durchführen der Schritte in diesem Thema müssen Sie mit einem Konto angemeldet sein, das Mitglied der Gruppe BizTalk Server-Administratoren ist. Ausführlichere Informationen zu Berechtigungen finden Sie unter Erforderliche Berechtigungen für das Bereitstellen und Verwalten einer BizTalk-Anwendung.

So fügen Sie einer Anwendung eine COM-Komponente hinzu

Mithilfe der BizTalk Server-Verwaltungskonsole

1. Klicken Sie auf Start, auf Programme, auf Microsoft BizTalk Server 20xx und dann auf BizTalk Server Verwaltung.

2. Erweitern Sie in der Konsolenstruktur BizTalk Server Administration, die Gruppe BizTalk, Anwendungen und dann die Anwendung, der Sie eine COM-Komponente hinzufügen möchten.

3. Klicken Sie mit der rechten Maustaste auf den Ordner Ressourcen , zeigen Sie auf Hinzufügen, und klicken Sie dann auf Ressourcen.

4. Klicken Sie auf Hinzufügen, wählen Sie die COM-Komponente aus, und klicken Sie dann auf Öffnen.

5. Klicken Sie in der Dropdownliste Dateityp auf System.BizTalk:Com.

6. Aktivieren oder deaktivieren Sie unter Optionen das Kontrollkästchen Datei am Ziel registrieren (regsvr32), je nachdem, ob die Komponente der Windows-Registrierung hinzugefügt werden soll, wenn die Anwendung installiert wird.

7. Geben Sie unter Ziel den vollständigen Pfad des Speicherorts ein, an den die COM-Komponente kopiert werden soll, wenn die Anwendung aus der .msi-Datei installiert wird, einschließlich des Dateinamens. Bei fehlender Angabe dieses Pfades wird die Datei während der Installation nicht in das lokale Dateisystem kopiert. Dieser Pfad ist erforderlich, wenn Sie im vorherigen Schritt das Kontrollkästchen Datei am Ziel registrieren (regsvr32) aktiviert haben.

   Beispiel: %BTAD_InstallDir%\MyComponent.dll

8. Wenn Sie fertig sind, klicken Sie auf OK.

Verwenden der Befehlszeile

1. Öffnen Sie eine Eingabeaufforderung wie folgt: Klicken Sie auf Start, klicken Sie auf Ausführen, geben Sie ein cmd, und klicken Sie dann auf OK.

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

   BTSTask AddResource [/ApplicationName:value] /type:System.BizTalk:Com [/Overwrite] /source:value [/Destination:value] [/Options:Regsvr32OnInstall] [/Server:value] [/Database:value]

   Beispiel:

   BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Com /Overwrite /Source:"C:\Source Components\COM.dll" /Destination:"C:\New Components\COM.dll" /Options:Regsvr32OnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb

   Parameter	Wert
   /Applicationname	Der Name der BizTalk-Anwendung, der die COM-Komponente hinzugefügt werden soll. Wenn der Anwendungsname nicht angegeben ist, wird die BizTalk-Standardanwendung für die Gruppe verwendet. Wenn der Name Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen.
   /Typ	System.BizTalk:Com (Bei diesem Wert wird nicht zwischen Groß-/Kleinschreibung unterschieden.)
   /Überschreiben	Option zum Aktualisieren einer vorhandenen COM-Komponente. Wenn diese Option nicht angegeben ist und die Anwendung bereits eine COM-Komponente mit der gleichen LUID wie die hinzuzufügende COM-Komponente enthält, kann der Vorgang AddResource nicht ausgeführt werden. Sie können die LUIDs für die Artefakte in einer Anwendung anzeigen, indem Sie den ListApp-Befehl verwenden.
   /Quelle	Der vollständige Pfad der DLL-Datei der COM-Komponente einschließlich des Dateinamens. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen.
   /Ziel	Vollständiger Pfad des Speicherorts, an den die DLL-Datei der COM-Komponente kopiert werden soll, wenn die Anwendung aus der MSI-Datei installiert wird. Bei fehlender Angabe wird die Datei bei der Installation nicht in das lokale Dateisystem kopiert, sodass die Komponente dann auch nicht der Windows-Registrierung hinzugefügt werden kann. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn in doppelte Anführungszeichen (") setzen. Wenn Sie die Option "Regsvr32OnInstall" angeben, müssen Sie auch "Destination" festlegen.
   /Optionen	Regsvr32OnInstall. Mit dieser Option geben Sie an, dass die COM-Komponente der Windows-Registrierung hinzugefügt werden soll, wenn die Anwendung aus der MSI-Datei installiert wird. Wenn Sie diese Option angeben, müssen Sie auch den Parameter "Destination" festlegen.
   /Server	Der Name der SQL Server-Instanz, die als Host für die BizTalk-Verwaltungsdatenbank dient, im Format Servername\Instanzname,Port. Der Instanzname ist nur erforderlich, wenn sich der Instanzname vom Servernamen unterscheidet. Der Port ist nur erforderlich, wenn in SQL Server eine andere Portnummer als der Standardwert 1433 verwendet wird. Beispiele: Server=MyServer Server=MyServer\MySQLServer,1533 Bei fehlender Angabe wird der Name der SQL Server-Instanz verwendet, die auf dem lokalen Computer ausgeführt wird.
   /Datenbank	Der Name der BizTalk-Verwaltungsdatenbank. Bei fehlender Angabe wird die BizTalk-Verwaltungsdatenbank verwendet, die in der lokalen Instanz von SQL Server ausgeführt wird.

Weitere Informationen

Verwalten von .NET-Assemblys, Zertifikaten und anderen Ressourcen
Befehl „AddResource“: COM-Komponente
Erstellen und Bearbeiten von BizTalk-Anwendungen