Veröffentlichen von Schemas als Webdienst in BizTalk
Zum Veröffentlichen von Schemas als Webdienst verwenden Sie den Assistenten für BizTalk-Webdienstpublishing.
Veröffentlichen von Schemas als Webdienst
Wählen Sie unter Programmedie Option BizTalk Server und dann BizTalk-Webdienstveröffentlichungs-Assistent aus.
Wichtig
Vor Ausführung des Assistenten für BizTalk-Webdienstpublishing müssen Sie die BizTalk-Projekte erstellen.
Klicken Sie auf der Seite Willkommenauf Weiter.
Wählen Sie auf der Seite Webdienst erstellen die Option Schemas als Webdienste veröffentlichen aus, und klicken Sie dann auf Weiter.
Definieren Sie auf der Seite Webdienst die zu veröffentlichenden Webdienste. Sie verwenden die Struktur im Dialogfeld Webdienstbeschreibung , um die Webdienstbeschreibungsknoten hinzuzufügen, zu entfernen, umzubenennen und zu bearbeiten. Das Dialogfeld Informationen enthält Informationen zum ausgewählten Knoten und zeigt alle Fehler im aktuellen Knoten oder unter knoten an:
Der Stammknoten der Struktur (Webdienstbeschreibung) beschreibt den Projektnamen des Webdiensts. Im Namen des virtuellen Verzeichnisses wird der Stammknoten als Standardname verwendet. Sie können die Webdienstbeschreibung ändern, indem Sie Webdienstbeschreibung umbenennen auswählen.
Klicken Sie zum Hinzufügen eines neuen Webdiensts mit der rechten Maustaste auf den Knoten Webdienstbeschreibung , und klicken Sie dann auf Webdienst hinzufügen. Auf diese Weise wird ein neuer Webdienst ohne Webmethoden erstellt. Klicken Sie zum Ändern des Namens des Webdiensts mit der rechten Maustaste auf den Knoten Webdienst, wählen Sie Webdienst umbenennen aus, und drücken Sie dann die EINGABETASTE, um den neuen Namen zu akzeptieren.
Um eine neue Webmethode hinzuzufügen, klicken Sie mit der rechten Maustaste auf den Webdienstknoten, zeigen Sie auf Webmethode hinzufügen, und klicken Sie dann im Kontextmenü auf Unidirektionale (für eine Anforderungswebmethode) oder Request-response (für eine Anforderung/Antwort-Webmethode).
Klicken Sie zum Festlegen der Anforderungs- und Antwortschematypen mit der rechten Maustaste auf den Knoten Anforderung oder Antwort , und klicken Sie dann auf Schematyp auswählen. Geben Sie im Dialogfeld Nachrichtentyp anfordern den Namen der Assembly mit dem Dokumentschema in das Textfeld BizTalk-Assemblydatei ein , oder klicken Sie auf Durchsuchen , um nach der Assembly zu suchen. In der Listenansicht Verfügbare Schematypen werden die einzelnen Stammelemente des Schemas angezeigt. Wählen Sie einen Stammknoten aus, um ihn als Schematyp für Anforderungen oder Antworten hinzuzufügen.
Hinweis
Wenn Sie die BizTalk-Assemblydatei im globalen Assemblycache (GAC) installiert haben, stellen Sie sicher, dass die Assembly im GAC mit der Assembly aktualisiert wurde, die Sie im Dialogfeld Meldungstyp anfordern 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.
Sie können die Knoten Anforderung und Antwort umbenennen, ohne dass sich dies auf den generierten Code auswirkt. Nachdem Sie Ihre Schemas definiert haben, können Sie die Teilelemente umbenennen und so den Parameternamen für die Webmethode ändern. Sie können die Änderungen anzeigen, indem Sie den generierten Webdienstcode anzeigen.
Hinweis
Beim Umbenennen von Webdienstbeschreibungsknoten dürfen Sie keine Leerzeichen verwenden.
Klicken Sie auf Weiter , um den Assistenten fortzusetzen.
Geben Sie auf der Seite Webdiensteigenschaften im Dialogfeld 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 Unterstützung für den Webdienst Sign-On 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. Standardmäßig wird das unidirektionale Flag nicht erzwungen. Hinweis
Die Auswahl der SOAP-Headeroptionen wird global auf alle Webdienste und Webmethoden angewendet, die beim Ausführen dieser Instanz des Assistenten erstellt werden.
Klicken Sie auf der Seite Webdiensteigenschaften auf Weiter.
Wenn Sie Zusätzliche SOAP-Header hinzufügen ausgewählt haben, werden die Seiten SOAP-Header undSoap-Antwortheader 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-Assemblyname (*.dll) den Assemblynamen ein, oder suchen Sie im Textfeld BizTalk-Assemblydatei 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-Kopfzeilenseite auf Weiter , um den Assistenten fortzusetzen.
Hinweis
Der Zielnamespace und der Stammelementname definieren den 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 Projektspeicherort den Projektspeicherort ein. Sie können den Standardspeicherort () akzeptieren,
http://localhost/your_project_nameeinen Speicherort für das Projekt 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 anderer Empfangsspeicherort vorhanden ist, wird er nicht ersetzt. Empfangsspeicherorte für den SOAP-Adapter werden im Format "/<Name >des virtuellen Verzeichnisses/<Orchestrierung 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. Wenn Sie auf einer nicht standardmäßigen Website veröffentlichen, fügen Sie die Portnummer der Website in die URL ein:
http://localhost:8080/<project_name>.Hinweis
Wenn Sie den Assistenten zum Erstellen von Empfangsspeicherorten verwenden, erstellt er die Empfangsspeicherorte mit zahlreichen Standardwerten. Die Standardwerte für Empfangs- und Sendepipelines sind Microsoft.BizTalk.DefaultPipelines.PassThruReceive und Microsoft.BizTalk.DefaultPipelines.PassThruTransmit. Wenn nachrichten, die über den veröffentlichten Webdienst empfangen werden, eine spezielle Pipelineverarbeitung erfordern (z. B. Validierung, Korrelation oder eingehende/ausgehende Zuordnungen), sollten Sie die Sende- und Empfangspipelines auf Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines.XMLSend oder auf eine benutzerdefinierte Pipeline festlegen.
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.