Verwenden des BizTalk Web Services-Veröffentlichungs-Assistenten zum Veröffentlichen einer Orchestrierung als Webdienst
Zum Veröffentlichen einer Orchestrierung als Webdienst verwenden Sie den Assistenten für BizTalk-Webdienstpublishing.
Hinweis
Vor Ausführung des Assistenten für BizTalk-Webdienstpublishing müssen Sie Ihre BizTalk-Projekte erstellen.
Hinweis
Zum Veröffentlichen einer Orchestrierung als Webdienst können Sie das Befehlszeilentool BTSWebSvcPub.exe verwenden. Weitere Informationen finden Sie unter BTSWebSvcPub Command-Line Referenz.
So veröffentlichen Sie eine Orchestrierung als Webdienst
Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Microsoft BizTalk Server, und klicken Sie dann auf BizTalk Web Services-Veröffentlichungs-Assistent.
Klicken Sie auf der Seite Willkommen beim BizTalk-Webdienstveröffentlichungs-Assistenten auf Weiter.
Wählen Sie auf der Seite Webdienst erstellen die Option BizTalk-Orchestrierungen als Webdienste 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
Kopieren Sie vor dem Auswählen einer BizTalk-Assemblydatei alle abhängigen Assemblys in den Ordner, in dem die BizTalk-Assembly enthalten ist, oder installieren Sie die abhängigen Assemblys in den 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 der GAC denselben vollqualifizierten Namen besitzt, verwendet der Assistent für BizTalk-Webdienstpublishing die Assemblydatei im globalen Assemblycache und nicht die von Ihnen ausgewählte Assemblydatei.
Hinweis
Wenn Sie den Assistenten für BizTalk-Webdienstpublishing in Visual Studio mit einer Orchestrierung öffnen, wird die BizTalk-Assemblydatei mit der Assembly aufgefüllt, die die Orchestrierung enthält.
Hinweis
Pfade mit mehr als 260 Zeichen können die Fehlermeldung auslösen, dass der Pfad zu lang ist.
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, indem Sie die entsprechenden Kontrollkästchen im Strukturknoten aktivieren. Wenn Sie einen Webdienst (ASMX) für alle ausgewählten Empfangsports anstelle eines Webdiensts für jeden Empfangsport erstellen möchten, wählen Sie die Option Alle ausgewählten Ports in einem einzelnen Webdienst zusammenführen aus, und klicken Sie dann auf Weiter.
Hinweis
Wenn Sie alle ausgewählten Ports in einem einzelnen Webdienst zusammenfassen, besitzen alle ausgewählten Ports denselben Typ, und die Vorgangsnamen in den Ports sind eindeutig.
Geben Sie auf der Seite Webdiensteigenschaften im Feld Zielnamespace des Webdiensts einen Zielnamespace für den Webdienst ein, und wählen Sie die entsprechenden Felder aus, um anzugeben, wie der Assistent SOAP-Header und SharePoint Portal Server 2007 Single Sign-On (Single Sign-On, SSO) für den Webdienst behandeln soll. Wenn Sie die Webdienstimplementierung weiter anpassen möchten, klicken Sie auf die Schaltfläche Erweitert . Es werden weitere verfügbare Optionen angezeigt:
Option Wert BESCHREIBUNG SOAP-Parameterstil Standard Diese Option gibt an, wie Parameter in einer SOAP-Nachricht formatiert werden. Weitere Informationen finden Sie unter SoapParameterStyle-Enumeration unter https://go.microsoft.com/fwlink/?LinkId=62259. SOAP-Parameterstil Bare Diese Option gibt an, wie Parameter in einer SOAP-Nachricht formatiert werden. Weitere Informationen finden Sie unter SoapParameterStyle-Enumeration unter https://go.microsoft.com/fwlink/?LinkId=62259. SOAP-Parameterstil Wrapped Diese Option gibt an, wie Parameter in einer SOAP-Nachricht formatiert werden. Weitere Informationen finden Sie unter SoapParameterStyle-Enumeration unter https://go.microsoft.com/fwlink/?LinkId=62259. Übereinstimmungsansprüche Keine Diese Option gibt die WSI-Spezifikation (Web Services Interoperability) an, mit der die Bindung konform ist. Weitere Informationen finden Sie unter WebServiceBindingAttribute.ConformsTo-Eigenschaft unter https://go.microsoft.com/fwlink/?LinkId=193064. Übereinstimmungsansprüche WS-I Basic Profile 1.1 Diese Option gibt die WSI-Spezifikation (Web Services Interoperability) an, mit der die Bindung konform ist. Weitere Informationen finden Sie unter WebServiceBindingAttribute.ConformsTo-Eigenschaft unter https://go.microsoft.com/fwlink/?LinkId=193064. Anforderungsantwort erzwingen [Default] Diese Option gibt an, ob unidirektionale BizTalk-Vorgänge als Webmethoden vom Typ „Anforderungsantwort“ veröffentlicht werden sollen. Die Standardeinstellung erzwingt das Übertragungskennzeichen nicht. Anforderungsantwort erzwingen No Diese Option gibt an, ob unidirektionale BizTalk-Vorgänge als Webmethoden vom Typ „Anforderungsantwort“ veröffentlicht werden sollen. Die Standardeinstellung erzwingt das Übertragungskennzeichen nicht. Anforderungsantwort erzwingen Yes Diese Option gibt an, ob unidirektionale BizTalk-Vorgänge als Webmethoden vom Typ „Anforderungsantwort“ veröffentlicht werden sollen. Die Standardeinstellung erzwingt das Übertragungskennzeichen nicht. Klicken Sie auf der Seite Webdiensteigenschaften auf Weiter.
Hinweis
Die Auswahl einer der SOAP-Headeroptionen wird global auf alle Webdienste und Webmethoden angewendet, die beim Ausführen dieses instance des Assistenten erstellt werden.
Wenn Sie die Option Zusätzliche SOAP-Header hinzufügen ausgewählt haben, werden die Seiten SOAP-Header undAntwort-SOAP-Header anfordern angezeigt. Mithilfe der Schaltflächen Hinzufügen und Entfernen in den folgenden Dialogfeldern können Sie Anforderungs- und Antwort-SOAP-Header hinzufügen und entfernen:
Klicken Sie auf Hinzufügen, um eine SOAP-Kopfzeile hinzuzufügen. Geben Sie im Textfeld BizTalk-Assemblydatei (*.dll) die Assembly ein, oder suchen Sie nach der Assembly, die das SOAP-Headerschema enthält. In der Listenansicht Verfügbare Schematypen werden die einzelnen Stammelemente des Schemas angezeigt. Wählen Sie einen hinzuzufügenden Stammknoten als SOAP-Header für Anforderungen oder Antworten aus. Um mehrere Elemente auszuwählen, halten Sie die STRG-TASTE gedrückt, und klicken Sie auf OK.
Um einen SOAP-Header aus der Liste zu entfernen, wählen Sie ihn aus der Liste der hinzugefügten SOAP-Header aus, und klicken Sie dann auf Entfernen.
Klicken Sie auf jeder SOAP-Headerseite auf Weiter, um den Assistenten fortzusetzen.
Hinweis
Ein Zielnamespace und ein Stammelementname definieren einen SOAP-Header.
Hinweis
Wenn die gleiche Kombination aus Zielnamespace/Stammelementname als SOAP-Header für Anforderung oder Antwort hinzugefügt wird, wird dieser nicht als ein eingehender/ausgehender Header behandelt. Sie müssen den eingehenden Header in einer Orchestrierung manuell in den ausgehenden Header kopieren.
Hinweis
Die gleiche Kombination aus Zielnamespace/Stammelementname kann nur ein Mal als SOAP-Header für Anforderung und ein Mal als SOAP-Header für Antwort hinzugefügt werden.
Geben Sie auf der Seite Webdienstprojekt im Textfeld Projektname den Namen für das Projekt ein. Sie können den Standardspeicherort (
http://localhost/<project_name>) akzeptieren, einen Speicherort für das Projekt in das Textfeld Projektspeicherort eingeben oder auf Durchsuchen klicken und ein Webverzeichnis auswählen. Aktivieren Sie eine der folgenden Optionen:Vorhandenes Projekt überschreiben. Diese Option ist nur verfügbar, wenn der Projektspeicherort bereits vorhanden ist. Die Veröffentlichung am gleichen Speicherort kann nur erfolgen, wenn Sie diese Option auswählen. Andernfalls müssen Sie einen anderen Projektspeicherort eingeben.
Anonymen Zugriff auf Webdienst 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).
BizTalk-Empfangsspeicherorte erstellen. Diese Option erstellt automatisch die SOAP-Adapterempfangsports und -Speicherorte, die jeder generierten ASMX-Datei entsprechen. Wenn bereits ein Empfangsspeicherort vorhanden ist, wird er nicht ersetzt. Empfangsspeicherorte für den SOAP-Adapter werden im Format /<Name>/<Orchestrierung desvirtuellen Verzeichnisses namespace_typename_portname.asmx >aufgelöst. Nachdem Sie diese Option ausgewählt haben, wählen Sie die Anwendung aus, in der die Empfangsports und -speicherorte generiert werden.
Hinweis
Der Projektspeicherort kann sich auf einem anderen Server befinden. Um einen Webdienst auf einem anderen Server zu veröffentlichen, geben Sie den Projektnamen als
http://<servername>/<project_name>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://localhost:8080/<project_name>.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 den veröffentlichten Webdienst empfangen werden, eine spezielle Pipelineverarbeitung erfordern (z. B. Validierung, Korrelation/Eigenschaftsaufstufung oder ein-/ausgehende Zuordnungen), sollten Sie die Empfangspipeline auf Microsoft.BizTalk.DefaultPipelines.XMLReceive oder auf eine benutzerdefinierte Pipeline festlegen.
Hinweis
Wen Sie Webdienste aus einer Orchestrierung aufrufen, unterstützt der SOAP-Adapter ausschließlich Pass-Through-Sendepipelines. Sie können eine benutzerdefinierte Sendepipeline verwenden. Diese darf jedoch keine Komponenten enthalten, mit denen die Textteile der Nachricht verändert werden. Zu diesen Komponenten gehören die XML-Assembler- und alle Codierungskomponenten.
Hinweis
Wenn Sie auf diese Seite zugreifen und sich von der Option Veröffentlichungsschemas als Webdienste abmelden möchten, wird auf der Seite Webdienstemöglicherweise die Dienst - und Methodennamen aus der zuvor ausgewählten BizTalk-Assembly angezeigt, bevor Sie die Option BizTalk-Orchestrierungen als Webdienste veröffentlichen aussteigen. Der Grund liegt darin, dass die Webdienstbeschreibung im Arbeitsspeicher nicht gelöscht wird, wenn die Veröffentlichungsmethode geändert wird.
Klicken Sie auf Weiter , um Die Einstellungen für das ASP.NET-Webdienstprojekt zu überprüfen.
Klicken Sie auf Erstellen , um den ASP.NET Webdienst zu erstellen.
Klicken Sie auf Fertig stellen , um den BizTalk Web Services-Veröffentlichungs-Assistenten abzuschließen.
Hinweis
Wenn Sie eine Orchestrierung als Webdienst unter Windows Vista veröffentlichen, müssen Sie das virtuelle Verzeichnis aktualisieren, das den Dienst hostet. Führen Sie hierzu den folgenden Befehl an der Eingabeaufforderung aus, und <ersetzen Sie vdir> durch den Namen des virtuellen Verzeichnisses: %systemroot%\system32\inetsrv\APPCMD.EXE migrieren sie die Konfiguration "Standardwebsite/<Vdirname>".
Weitere Informationen
Veröffentlichen einer Orchestrierung als WebdienstGewusst wie: Zuordnen von Orchestrierungen zu Webdiensten