Teilen über

Bereitstellen einer BizTalk-Assembly aus Visual Studio

  • Artikel

Dieses Thema enthält Anweisungen zum Verwenden von Visual Studio Projektmappen-Explorer oder der Visual Studio-Eingabeaufforderung zum Bereitstellen der BizTalk-Assemblys aus Visual Studio in einer BizTalk-Anwendung. Sie können zwar eine einzelne Assembly auf Projektebene bereitstellen (z. B. indem Sie mit der rechten Maustaste auf das Projekt und dann auf Bereitstellen klicken) oder alle Assemblys in der Projektmappe auf Projektmappenebene bereitstellen (z. B. indem Sie mit der rechten Maustaste auf die Projektmappe und dann auf Bereitstellen klicken). Es wird jedoch dringend empfohlen, alle Assemblys sofort auf Projektmappenebene bereitzustellen.

Wenn in früheren Versionen von BizTalk Server mehrere Assemblys in einer Lösung bereitgestellt werden sollten und eine der Assemblys von einer der anderen Assemblys abhängig war, mussten die Assemblys in umgekehrter Reihenfolge ihrer Abhängigkeiten bereitgestellt werden. Wenn Assembly1 z. B. von Assembly2 abhängig war, mussten Sie zuerst Assembly2 bereitstellen, und danach konnte Assembly1 bereitgestellt werden.

Dies gilt weiterhin, wenn Sie Assemblys auf Projektebene bereitstellen. Bei BizTalk Server übernimmt BizTalk Server jedoch automatisch alle Bereitstellungsschritte, einschließlich der Bereitstellung von Assemblys in der richtigen Reihenfolge. Zur Vereinfachung der Bereitstellung sollten Sie die Assemblys daher auf Projektmappenebene bereitstellen, wenn eine andere Assembly von der Assembly abhängig ist, die Sie bereitstellen.

Wenn Sie die Option zum Bereitstellen eines Projekts oder einer Lösung in Visual Studio wählen, werden die Assembly oder Assemblys automatisch in der angegebenen BizTalk-Anwendung in der lokalen BizTalk-Gruppe erstellt und bereitgestellt. Falls die Anwendung noch nicht in der Gruppe vorhanden ist, wird sie im Zuge der Bereitstellung ebenfalls erstellt. Die Assemblys und die Elemente, die sie enthalten, werden registriert, und ihre Daten werden in der BizTalk-Verwaltungsdatenbank (Konfigurationsdatenbank) der BizTalk-Gruppe gespeichert. Wenn Sie diese Option zusätzlich in den Bereitstellungseigenschaften für das Projekt angeben, werden die Assemblys dem globalen Assemblycache (GAC) hinzugefügt.

Als "Element" (Artifact) wird jeder Bestandteil einer BizTalk-Anwendung bezeichnet. Hierzu zählen auch Ressourcen, mit denen Sie in Visual Studio arbeiten, beispielsweise Assemblys und Orchestrierungen sowie andere Elemente, die Sie erstellen oder nach der Bereitstellung der Anwendung später hinzufügen, beispielsweise Sende- und Empfangsports, Zertifikate und Skripts. Nach dem Bereitstellen der Assembly können Sie deren Elemente im Knoten Anwendungen der BizTalk Server-Verwaltungskonsole anzeigen und verwalten. Jede Anwendung wird in einem eigenen Ordner mit Unterordnern gespeichert, in denen die Elemente der Anwendung angezeigt werden. Weitere Informationen finden Sie unter Verwenden der BizTalk Server-Verwaltungskonsole. Weitere Informationen zum Erstellen und Verwalten von Anwendungen finden Sie unter Bereitstellen und Verwalten von BizTalk-Anwendungen.

Bevor Sie eine Assembly bereitstellen, müssen Sie die folgenden Schritte ausführen:

Wichtig

Die in diesem Thema beschriebenen Aufgaben sollten auf keinen Fall auf einem Produktionscomputer ausgeführt werden. Während des Entwicklungsprozesses muss der Entwickler häufig Assemblys aus Visual Studio erneut bereitstellen. Um die erneute Bereitstellung zu ermöglichen, kann Visual Studio die Bereitstellung von Elementen in der gleichen oder in anderen Anwendungen aufheben, deren Bindung entfernen, diese Elemente beenden oder austragen. In der Entwicklungsumgebung ist dies zwar notwendig und zweckmäßig, in einer Produktionsumgebung können diese Vorgänge jedoch unerwartete und unerwünschte Folgen haben. Um zu vermeiden, dass der Versuch unternommen wird, eine Assembly aus Visual Studio auf einem Produktionscomputer bereitzustellen, wird empfohlen, Visual Studio nicht auf Produktionscomputern zu installieren.

Hinweis

Die Laufzeitsicherheitsrichtlinie von .NET Framework verhindert standardmäßig die Bereitstellung von Assemblys über eine Netzwerkfreigabe. Wenn Sie versuchen, eine Assembly über eine Netzwerkfreigabe bereitzustellen und Schwierigkeiten auftreten, wenden Sie sich an Ihren .NET Framework Sicherheitsadministrator, oder lesen Sie "Sicherheitsrichtlinienverwaltung" in der kombinierten Visual Studio-Sammlung.

Voraussetzungen

Zum Durchführen der Schritte in diesem Thema müssen Sie mit einem Konto angemeldet sein, das Mitglied der BizTalk Server-Administratorengruppe ist. Wenn Sie in den Bereitstellungseigenschaften die Option zum Installieren einer Assembly im globalen Assemblycache (GAC) aktiviert haben, benötigen Sie auch Lese-/Schreibberechtigungen für den GAC. Das Administratorkonto auf dem lokalen Computer verfügt über diese Berechtigung. Ausführlichere Informationen zu Berechtigungen finden Sie unter Erforderliche Berechtigungen für das Bereitstellen und Verwalten einer BizTalk-Anwendung.

So stellen Sie BizTalk-Assemblys bereit

Mithilfe des Projektmappen-Explorers von Visual Studio

  • Klicken Sie in Visual Studio Projektmappen-Explorer mit der rechten Maustaste auf ein BizTalk-Projekt oder eine BizTalk-Projektmappe, und klicken Sie dann auf Bereitstellen.

    Die Assembly im Projekt oder Assemblys in der Projektmappe werden in der angegebenen BizTalk-Anwendung bereitgestellt. Der Status des Erstellungs- und Bereitstellungsprozesses wird auf der Seite links unten angezeigt.

Mithilfe der Eingabeaufforderung von Visual Studio

  1. Starten Sie die Visual Studio-Eingabeaufforderung.

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

    devenv /deploySolnConfigNameSolutionName [/projectProjName] [/projectconfigProjConfigName]

    Beispiel:

    devenv /deploy Release "C:\Dokumente und Einstellungen\<Benutzername>\Eigene Dateien\Visual Studio\Projekte\EigeneProjektmappe\MySolution.sln" /project "MyBizTalkApp\MyBizTalkApp.csproj" projectconfig Release

    Parameter Wert
    /Bereitstellen Stellt eine Projektmappe nach einer Erstellung oder Neuerstellung bereit.
    SolnConfigName Name der Projektmappenkonfiguration, die zum Erstellen der unter Projektmappenname angegebenen Projektmappe verwendet wird.
    SolutionName Vollständiger Pfad und Name der Projektmappendatei.
    /projectProjName Pfad und Name der Projektdatei innerhalb der Projektmappe. Sie können einen relativen Pfad vom Ordner Projektmappenname zur Projektdatei, den Anzeigenamen des Projekts oder aber den vollständigen Pfad und Namen der Projektdatei angeben.
    /projectconfigProjConfigName Name einer Projektbuildkonfiguration, der beim Erstellen des Projekts verwendet werden soll.

    Beim erstmaligen Bereitstellen einer Assembly, die eine Orchestrierung enthält, wird eventuell die Warnmeldung angezeigt, dass die Orchestrierung nicht in der Bindungsdatei enthalten ist. Diese Meldung wird angezeigt, da Orchestrierungen bei der Bereitstellung nicht automatisch an den Host gebunden werden. Diesen Schritt müssen Sie manuell ausführen.

Weitere Informationen

Bereitstellen von BizTalk-Assemblys aus Visual Studio in einer BizTalk-Anwendung