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