Freigeben über


So verwenden Sie Webdienstarrays

BizTalk Server bietet die Möglichkeit, Arrays zu nutzen, die in Webdiensten von einer BizTalk Orchestration verfügbar gemacht werden.

So konfigurieren Sie eine Orchestration für die Nutzung eines Arrays, das in einem Webdienst verfügbar gemacht wird:

Bestimmen Sie die URL für den Webdienst, der Arrays verfügbar macht. Dies ist in der Regel eine Asmx-Webseite, die die vom Webdienst unterstützten Vorgänge auflistet. Beispiel: http://localhost/ArrayWS/ArraySvc.asmx.

  1. Fügen Sie im Visual Studio-Projekt, das Ihre Orchestrierung enthält, einen Webverweis zu dieser URL hinzu:

    • Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und klicken Sie auf "Dienstverweis hinzufügen".

    • Klicken Sie im Dialogfeld " Dienstreferenz hinzufügen " auf "Erweitert".

    • Klicken Sie im Dialogfeld "Dienstreferenzeinstellungen" 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 "Gehe zu".

    • Geben Sie einen Namen für den Webverweis in das Textfeld "Webverweisname " ein, und klicken Sie auf die Schaltfläche " Verweis hinzufügen ".

    • Der Webverweis wird im Projektmappen-Explorer unter "Webverweise " angezeigt.

      Tipp

      Nachdem 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.

  2. Fügen Sie Ihrer Orchestrierung einen Webport hinzu:

    • Ziehen Sie ein Port-Shape aus der Toolbox auf eine der Portoberflächen im Orchestration 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 zum Verwenden eines vorhandenen Porttyps 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, und klicken Sie auf die Schaltfläche " Weiter ", und klicken Sie dann auf die Schaltfläche " Fertig stellen ". Nun sollte im Orchestration Designer ein Webport angezeigt werden, der die vom Webdienst unterstützten Vorgänge enthält.

  3. Fügen Sie Ihrer Orchestrierung bei Bedarf Senden und Empfangen Shapes hinzu:

    • Ziehen Sie ein Send Shape aus der Toolbox auf eine Verbindungslinie in der Orchestration Designer-Oberfläche, um die Orchestrierung so zu konfigurieren, dass eine Anforderungsnachricht an einen Web-Port gesendet wird. Wenn Sie das Sende-Shape mit einem der Webport-Anforderungsnachrichten-Connectors verbinden, erstellt BizTalk automatisch eine Nachricht des entsprechenden Typs, um eine Anforderungsnachricht an diesen Port zu senden.

    • Ziehen Sie ein Empfangs-Shape aus der Toolbox auf eine Verbindungslinie in der Orchestration Designer-Oberfläche, um die Orchestrierung so zu konfigurieren, dass eine Antwortnachricht vom Webport empfangen wird. Wenn Sie das Empfangs-Shape mit einem der Webport-Antwortnachrichten-Connectoren verbinden, erstellt BizTalk automatisch eine Nachricht des entsprechenden Typs zur Verwendung beim Empfang einer Antwortnachricht von diesem Port.

Hinweis

Verwenden Sie den SOAP-Adapter, um Nachrichten an einen Webdienst zu senden oder 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 unregelmäßigen Arrays, die von Webdiensten bereitgestellt werden. Wenn Sie einen Webverweis zu einem Webdienst hinzufügen, der Arrays verfügbar macht, generiert der Orchestration Designer einen Webnachrichtentyp, der das Array beschreibt. Sie können dann Nachrichten dieses Typs wie jede andere Nachricht senden und empfangen. BizTalk Server beschränkt nicht das Senden von Webnachrichten, die Arrays enthalten, nur auf Webports.

Ein Beispiel für die Verwendung von Webdienstarrays finden Sie im SDK-Beispiel "Nutzung von Webdiensten" und "Verwenden von Webdiensten mit Arrayparametern" unter https://go.microsoft.com/fwlink/?LinkId=73703.

Siehe auch

Verwenden von Nachrichten in Orchestrierungen