Nutzen von Arrays in Webdiensten
BizTalk Server bietet die Möglichkeit, Arrays zu nutzen, die in Webdiensten über eine BizTalk-Orchestrierung verfügbar gemacht werden.
So konfigurieren Sie eine Orchestrierung für die Nutzung eines Arrays, das in einem Webdienst verfügbar gemacht wird:
Bestimmen Sie die URL für den Webdienst, der Arrays bereitstellt. Dabei handelt es sich üblicherweise um eine ASMX-Webseite, auf der die von dem Webdienst unterstützten Vorgänge aufgelistet werden. Beispiel: http://localhost/ArrayWS/ArraySvc.asmx.
Fügen Sie in dem Visual Studio-Projekt, das die Orchestrierung enthält, einen Webverweis auf diese URL hinzu:
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und klicken Sie dann auf Dienstverweis hinzufügen.
Klicken Sie im Dialogfeld Dienstverweis hinzufügen auf Erweitert.
Klicken Sie im Dialogfeld Dienstverweiseinstellungen im Abschnitt Kompatibilität auf Webverweis hinzufügen.
Geben Sie im Dialogfeld Webverweis hinzufügen die URL für den Webdienst in das Textfeld URL ein, und klicken Sie dann auf Los.
Geben Sie im Textfeld Webverweisname einen Namen für den Webverweis ein, und klicken Sie auf die Schaltfläche Verweis hinzufügen .
Der Webverweis wird im Projektmappen-Explorer unter Webverweise angezeigt.
Tipp
Sobald Sie dem Projekt einen Webverweis hinzugefügt haben, ist der Befehl Webverweis hinzufügen direkt verfügbar, wenn Sie mit der rechten Maustaste auf den Projektnamen oder Verweise oder Webverweise klicken.
Fügen Sie Ihrer Orchestrierung einen Webport hinzu:
Ziehen Sie ein Port-Shape aus der Toolbox auf eine der Portoberflächen im Orchestrierungs-Designer, um den Portkonfigurations-Assistenten zu starten. Klicken Sie im Portkonfigurations-Assistenten auf die Schaltfläche Weiter, um das Dialogfeld Porteigenschaften anzuzeigen.
Geben Sie einen Wert in das Textfeld Name ein, um den Port zu identifizieren, und klicken Sie auf die Schaltfläche Weiter , um das Dialogfeld Porttyp auswählen anzuzeigen.
Wählen Sie die Option Einen vorhandenen Porttyp verwenden aus, wählen Sie den Webporttyp aus, der dem hinzugefügten Webverweis entspricht, und klicken Sie auf die Schaltfläche Weiter , um das Dialogfeld Portbindung anzuzeigen.
Wählen Sie im Dialogfeld Portbindung die entsprechende Portbindungsoption aus, klicken Sie auf die Schaltfläche Weiter , und klicken Sie dann auf die Schaltfläche Fertig stellen . Nun sollte im Orchestrierungs-Designer ein Webport angezeigt werden, der die von dem Webdienst unterstützten Vorgänge umfasst.
Fügen Sie Ihrer Orchestrierung "Senden" und "Empfangen" -Shapes nach Bedarf hinzu:
Ziehen Sie ein Shape senden aus der Toolbox auf eine Verbindungslinie in der Orchestrierungsoberfläche Designer, um die Orchestrierung so zu konfigurieren, dass eine Anforderungsnachricht an den Webport gesendet wird. Wenn Sie das Shape Senden mit einem der Webportanforderungsnachrichtenconnectors verbinden, erstellt BizTalk automatisch eine Nachricht des entsprechenden Typs, die beim Senden einer Anforderungsnachricht an diesen Port verwendet werden soll.
Ziehen Sie ein Receive-Shape aus der Toolbox auf eine Verbindungslinie in der Orchestrierungsoberfläche Designer, um die Orchestrierung so zu konfigurieren, dass eine Antwortnachricht vom Webport empfangen wird. Wenn Sie das Shape Empfangen mit einem der Webportantwortnachrichtenconnectors verbinden, erstellt BizTalk automatisch eine Nachricht des entsprechenden Typs, die beim Empfangen einer Antwortnachricht von diesem Port verwendet werden soll.
Hinweis
Verwenden Sie den SOAP-Adapter, um Nachrichten an einen Webdienst zu senden oder Nachrichten von einem Webdienst zu empfangen. Weitere Informationen zum Konfigurieren des SOAP-Adapters finden Sie unter Konfigurieren des SOAP-Adapters.
Die BizTalk Server-Orchestrierungs-Engine bietet Unterstützung für die Verwendung von eindimensionalen und zerklüfteten Arrays, die von Webdiensten verfügbar gemacht werden. Wenn Sie einen Webverweis auf einen Webdienst, der Arrays bereitstellt, hinzufügen, generiert der Orchestrierungs-Designer einen Webnachrichtentyp, der das Array beschreibt. Anschließend können Sie Nachrichten dieses Typs wie jede andere Nachricht senden und empfangen. In BizTalk Server ist das Senden von Webnachrichten mit Arrays nicht auf Webports beschränkt.
Ein Beispiel für die Nutzung von Webdienstarrays finden Sie im SDK-Beispiel "Nutzen von Webdiensten" und "Verwenden von Webdiensten mit Arrayparametern" unter https://go.microsoft.com/fwlink/?LinkId=73703.