Verwenden des Assistenten für BizTalk-Webdienstpublishing zum Veröffentlichen von Orchestrierungen als WCF-Dienste
Sie verwenden den Assistenten für BizTalk WCF-Dienstpublishing zum Veröffentlichen von Orchestrierungen als WCF-Dienste.
Hinweis
Vor Ausführung des Assistenten für BizTalk WCF-Dienstpublishing müssen Sie Ihre BizTalk-Projekte erstellen. Die BizTalk-Projekte müssen Orchestrierungen mit mindestens einem Empfangsport enthalten, dessen Typmodifizierer öffentlich ist. Dieser Typmodifizierer ist in den Eigenschaften für die Orchestrierung vorhanden, wenn der Port erstellt wird.
So veröffentlichen Sie eine Orchestrierung als WCF-Dienst
Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf BizTalk Server, und klicken Sie dann auf BizTalk WCF-Dienstveröffentlichungs-Assistent.
Hinweis
Zum Erstellen und Veröffentlichen von BizTalk-Orchestrierungen und -Schemas als WCF-Dienste mit den WCF-Adaptern wird der Assistent für BizTalk WCF-Dienstpublishing verwendet. Zum Veröffentlichen von Orchestrierungen und Schemas als Webdienste mit dem SOAP-Adapter verwenden Sie den Assistenten für BizTalk-Webdienstpublishing.
Klicken Sie auf der Seite Willkommen beim BizTalk WCF-Dienstveröffentlichungs-Assistent auf Weiter.
Wählen Sie auf der Seite WCF-Diensttyp die Option Dienstendpunkt aus, um die WCF-Dienste für ausgewählte BizTalk-Orchestrierungen in einer BizTalk-Assembly zu veröffentlichen.
Aktivieren Sie auf der Seite WCF-Diensttyp das Kontrollkästchen Metadatenendpunkt aktivieren , um anzugeben, ob der isolierte WCF-Empfangsspeicherort, der von Internetinformationsdiensten (IIS) gehostet wird, Dienstmetadaten für den Abruf mithilfe einer HTTP/GET-Anforderung veröffentlicht. Durch Aktivieren dieses Kontrollkästchens generiert der Assistent Web.config, bei dem das httpGetEnabled-Attribut des <serviceMetadata-Elements> auf true festgelegt ist. Sie können zum Erstellen des Clientcodes, mit dem dieser Dienst in der Entwicklungsumgebung aufgerufen wird, ein Metadaten-Import-Dienstprogramm (z. B. SvcUtil.exe) verwenden. Die Adresse, an der die Metadaten veröffentlicht werden, ist die Endpunktadresse sowie eine ?wsdl-Abfragezeichenfolge .
Hinweis
Um unbeabsichtigtes Offenlegen sicherheitsrelevanter Dienst-Metadaten zu verhindern, sollte dieses Verhalten in der Produktionsumgebung deaktiviert werden. Zu diesem Zweck können Sie den Wert für "httpgetenabled" auf "false" festlegen oder das virtuelle Verzeichnis "MEX" löschen.
Wählen Sie auf der Seite WCF-Diensttyp in der Dropdownliste Adaptername (Transporttyp) den isolierten WCF-Adapter aus, mit dem die WCF-Dienste veröffentlicht werden. Sie können einen der folgenden Adapter auswählen:
WCF-BasicHttp. . Der WCF-BasicHttp-Adapter kann mit WS-I Basic Profile 1.1-konformen Webdiensten kommunizieren, wie z. B. mit ASMX-basierten Diensten.
WCF-WSHttp. . Der WCF-WSHttp-Adapter kann mithilfe von WS-*-Standards über HTTP und HTTPS mit einem Dienst kommunizieren.
WCF-CustomIsolated. . Mithilfe des WCF-CustomIsolated-Adapters können Sie Erweiterbarkeitsfeatures von Windows Communication Foundation (WCF) über den HTTP-Transport verwenden.
Aktivieren Sie auf der Seite WCF-Diensttyp das Kontrollkästchen BizTalk-Empfangsspeicherorte in der folgenden Anwendung erstellen , um die Empfangsports und Speicherorte zu erstellen, die den einzelnen generierten SVC-Dateien für den WCF-Adapter entsprechen, den Sie in der Dropdownliste Adaptername ausgewählt haben. Wenn bereits ein Empfangsspeicherort vorhanden ist, wird er nicht ersetzt. Nachdem Sie diese Option ausgewählt haben, wählen Sie in der Dropdownliste BizTalk-Anwendungsname die Anwendung aus, in der die Empfangsports und Speicherorte generiert werden, und klicken Sie dann auf Weiter.
Wählen Sie auf der Seite WCF-Dienst erstellen die Option BizTalk-Orchestrierungen als WCF-Dienst veröffentlichen aus, und klicken Sie dann auf Weiter.
Geben Sie auf der Seite BizTalk-Assembly im Textfeld BizTalk-Assemblydatei (*.dll) den Namen der BizTalk-Assemblydatei ein, oder klicken Sie auf Durchsuchen , um zu der Assembly zu navigieren, die die zu veröffentlichenden Orchestrierung(en) enthält, und klicken Sie dann auf Weiter.
Hinweis
Bevor Sie eine BizTalk-Assemblydatei auswählen, kopieren Sie alle abhängigen Assemblys in den gleichen Ordner mit der BizTalk-Assembly, oder installieren Sie die abhängigen Assemblys im globalen Assemblycache (GAC).
Hinweis
Wenn Sie die BizTalk-Assemblydatei im GAC installiert haben, stellen Sie sicher, dass die Assembly im GAC mit der Assembly aktualisiert wurde, die Sie im Dialogfeld BizTalk-Assembly auswählen. Falls die Assembly im globalen Assemblycache denselben vollqualifizierten Namen hat, verwendet der Assistent für BizTalk-WCF-Dienstpublishing die Assemblydatei im globalen Assemblycache und nicht die von Ihnen ausgewählte Assemblydatei.
Hinweis
Pfade mit über 260 Zeichen können die Fehlermeldung auslösen, dass der Pfad zu lang sei.
Erweitern Sie auf der Seite Orchestrierungen und Ports die Strukturknoten für jede Assembly und Orchestrierung, indem Sie auf das Pluszeichen (+) klicken. Wählen Sie Orchestrierungen und Ports aus, die veröffentlicht werden sollen, indem Sie die Kontrollkästchen für den entsprechenden Strukturknoten aktivieren. Wenn Sie einen WCF-Dienst (SVC-Datei) für alle ausgewählten Empfangsports anstelle eines WCF-Diensts für jeden Empfangsport erstellen möchten, wählen Sie die Option Alle ausgewählten Ports in einem einzelnen WCF-Dienst zusammenführen aus, und klicken Sie dann auf Weiter.
Hinweis
Wenn Sie alle ausgewählten Ports in einem einzelnen WCF-Dienst zusammenfassen, haben alle ausgewählten Ports denselben Typ, und die Vorgangsnamen in den Ports sind eindeutig.
" Geben Sie auf der Seite WCF-Diensteigenschaften im Textfeld Zielnamespace des WCF-Diensts einen Zielnamespace für die WCF-Dienste ein, und klicken Sie dann auf Weiter.
Geben Sie auf der Seite Speicherort des WCF-Diensts im Textfeld Speicherort den Namen des Webverzeichnisses ein, in dem die WCF-Dienste generiert werden. Sie können den Standardspeicherort (
http://localhost/<BizTalk Assembly Name>) akzeptieren, einen Speicherort für die WCF-Dienste in das Textfeld Speicherort eingeben oder auf Durchsuchen klicken und ein Webverzeichnis auswählen. Aktivieren Sie eine der folgenden Optionen:Vorhandenes Projekt überschreiben. Diese Option ist nur dann verfügbar, wenn das Webverzeichnis bereits vorhanden ist. Das Veröffentlichen im selben Speicherort kann nur erfolgen, wenn Sie diese Option auswählen. Andernfalls müssen Sie einen anderen Projektspeicherort eingeben.
Anonymen Zugriff auf WCF-Dienst zulassen. Diese Option ermöglicht den anonymen Zugriff auf das erstellte virtuelle Verzeichnis. Das virtuelle Verzeichnis übernimmt standardmäßig die Zugriffsberechtigungen von seinem übergeordneten virtuellen Verzeichnis oder der Website (falls es sich um ein virtuelles Verzeichnis auf höchster Ebene handelt).
Wenn Sie diese Seite abgeschlossen haben, klicken Sie auf Weiter.
Hinweis
Der Projektspeicherort kann sich auf einem anderen Server befinden. Um die WCF-Dienste auf einem anderen Server zu veröffentlichen, geben Sie den Projektnamen als
http://<servername>/<WCF service location>ein.Hinweis
Der Projektspeicherort kann sich auf einer anderen Website als der Standardwebsite befinden. Fügen Sie bei einer Veröffentlichung auf einer nicht standardmäßigen Website der URL die Portnummer der Website hinzu. Beispiel:
http://<servername>:8080/<WCF service location>.Hinweis
Wenn Sie den Assistenten zum Erstellen von Empfangsspeicherorten verwenden, erstellt er die Empfangsspeicherorte mit den Standardwerten. Der Standardwert für die Empfangspipeline ist die Pipeline Microsoft.BizTalk.DefaultPipelines.PassThruReceive . Wenn nachrichten, die über die veröffentlichten WCF-Dienste empfangen werden, eine spezielle Pipelineverarbeitung erfordern (z. B. Validierung, Korrelation/Eigenschaftsheraufstufung oder ein-/ausgehende Zuordnungen), sollten Sie die Empfangspipeline auf Microsoft.BizTalk.DefaultPipelines.XMLReceive oder auf eine benutzerdefinierte Pipeline festlegen, indem Sie die BizTalk Server Verwaltungskonsole verwenden.
Hinweis
Wenn Sie sich entscheiden, die Option Orchestrierung als WCF-Dienst veröffentlichen nicht zu verwenden, nachdem Sie diese Seite erreicht haben, sehen Sie möglicherweise auf der Seite WCF-Dienst erstellen , dass in der Webdienstbeschreibung die Dienst- und Methodennamen aus der BizTalk-Assembly angezeigt werden, die Sie ausgewählt haben, bevor Sie die Veröffentlichungsoption geändert haben. Dies liegt daran, dass die Beschreibung des In-Memory-Webdiensts nicht gelöscht wird, wenn die Veröffentlichungsmethode geändert wird.
Überprüfen Sie auf der Seite WCF-Dienstzusammenfassung Ihre Einstellungen für die WCF-Dienste.
Klicken Sie auf Erstellen , um die WCF-Dienste zu erstellen.
Klicken Sie auf Fertig stellen , um den BizTalk WCF-Dienstveröffentlichungs-Assistenten abzuschließen.
Nachdem Sie die WCF-Dienste mit dem Assistenten für BizTalk WCF-Dienstpublishing veröffentlicht haben, müssen Sie sie ordnungsgemäß konfigurieren. Informationen zum Konfigurieren des isolierten WCF-Empfangsadapters finden Sie unter Konfigurieren von WCF-Diensten, die mit dem BizTalk WCF-Dienstveröffentlichungs-Assistenten veröffentlicht wurden.
Weitere Informationen
Konfigurieren von WCF-Diensten, die mit dem Assistenten für BizTalk WCF-Dienstpublishing veröffentlicht wurden
Exemplarische Vorgehensweise: Veröffentlichen von WCF-Diensten mit dem WCF-BasicHttp-Adapter
Verwenden des Assistenten für BizTalk WCF-Dienstpublishing zum Veröffentlichen von Schemas als WCF-Dienste
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter: https://aka.ms/ContentUserFeedback.
Einreichen und Feedback anzeigen für