Freigeben über


Zuordnen von Orchestrierungen zu Webdiensten

Eine Orchestrierung kann mehrere Empfangsports aufweisen. Mit dem Assistenten für BizTalk-Webdienstpublishing wählen Sie Empfangsports für die Veröffentlichung als Webdienste aus. Der Assistent erstellt für jeden Empfangsport einen Webdienst (ASMX-Datei). Alternativ kann der Assistent einen Webdienst für alle Empfangsports erstellen, sofern es sich bei allen um denselben Empfangsporttyp handelt (unidirektional oder Anforderung/Antwort). Vorgänge werden zu Funktionsaufrufen. Jeder Vorgang im Empfangsport wird zu einer Webmethode. Anforderungsvorgänge werden zu Eingabeparametern. Antwortvorgänge werden zu Rückgabetypen.

Wenn die Anforderungs- und Antwortvorgänge derselbe Webnachrichtentyp sind, wird der Eingabeparameter zu einem Ref , und der Rückgabetyp ist void. ASP.NET-Webclients können die Signaturen der Webmethoden ändern, indem die Ein- und Ausgabeparameter desselben Typs miteinander kombiniert werden. Beispielsweise kann ein ASP.NET Webclient eine BizTalk Web-Methode von Zeichenfolge myService(string part) in void myService(ref string part)ändern.

Die Signaturen der Webmethoden werden von den Nachrichtentypen der Vorgänge definiert. Jeder Teil des Nachrichtentyps ist ein Parameter in der Webmethode.

Namen von Nachrichtentypteilen und Zielnamespaces

Dokumentschemas und benutzerdefinierte Klassen mit angegebenem XmlRootAttribute sind Nachrichtentypteile, die über definierte Zielnamespaces verfügen. EDI-Schemas, benutzerdefinierte Klassen ohne angabe von XmlRootAttribute und integrierte Typen wie System.String sind Nachrichtentypteile ohne definierte Zielnamespaces.

Namespacedefinition für Namen von Nachrichtentypeilen Verwendeter Parametername
Definierter Zielnamespace Stammelementname
Kein definierter Zielnamespace Name des Nachrichtentypteils

Hinweis

Wenn für die Antwortnachricht ein mehrteiliger Nachrichtentyp verwendet wird, verwendet der Assistent für BizTalk-Webdienstpublishing den ersten Nachrichtenteil als Rückgabewert und die übrigen Nachrichtenteile als Ausgabeparameter.

Orchestrierungen mit mehreren Vorgängen

Wenn eine Orchestrierung mehrere Vorgänge umfasst, sollte sie nur einen Empfangsport und nicht mehrere aufweisen. Dadurch wird verhindert, dass der Assistent für BizTalk-Webdienstpublishing mehrere Webdienstdateien (ASMX-Dateien) erstellt. Dies funktioniert nur, wenn alle Vorgänge dasselbe Aufrufmuster aufweisen, es sich also bei allen um unidirektionale Vorgänge oder um Vorgänge vom Typ „Anforderungsantwort“ handelt. Ein einzelner Empfangsport kann nicht sowohl unidirektionale als auch Vorgänge vom Typ „Anforderungsantwort“ enthalten.

Hinweis

Im Assistenten für BizTalk-Webdienstpublishing werden öffentliche Empfangsports angezeigt. Öffentliche Empfangsports sind Porttypen mit dem Typmodifizierer Öffentlich. Sie können nur öffentliche Ports als Webdienst veröffentlichen. Der Standardporttyp lautet Intern.

Hinweis

Wenn Ihr Empfangsport als unidirektionale Schnittstelle definiert ist, ist der Antworttyp der Webmethode ungültig , und es werden keine Informationen an den Webclient zurückgegeben. Vom SOAP-Adapter oder einer Orchestrierung ausgelöste Ausnahmen werden nicht an den Webclient zurückgegeben.

Konventionen für die Benennung von Webdiensten für veröffentlichte Orchestrierungen

Der BizTalk Web Services-Veröffentlichungs-Assistent generiert Webdienste (ASMX)-Dateinamen basierend auf dem Orchestrierungsnamespace, gefolgt von einem Unterstrich (), gefolgt vom Typnamen, gefolgt von einem Unterstrich (\) und dem Namen des Empfangsports. Teile, die Punkte enthalten, werden durch Unterstriche (_) ersetzt. An den Namen des Webdiensts wird immer der Portname angefügt.

Die folgende Tabelle zeigt, wie der Assistent für BizTalk-Webdienstpublishing Webdienstnamen generiert.

Orchestrierung(en) mit Webport(s) Generierter Webdienstname
Eine Orchestrierung mit einem Webport orchestrierung1_port1.asmx
Eine Orchestrierung mit zwei Webports orchestrierung1_port1.asmx und orchestrierung1_port2.asmx
Zwei Orchestrierungen mit je einem Webport orchestrierung1_port1.asmx und orchestrierung2_port2.asmx

Weitere Informationen

Veröffentlichen einer Orchestrierung als Webdienst
Verwenden des BizTalk-Webdienstveröffentlichungs-Assistenten zum Veröffentlichen einer Orchestrierung als Webdienst