Teilen über

Verwenden des Assistenten für BizTalk WCF-Dienstpublishing zum Veröffentlichen von Schemas als WCF-Dienste

  • Artikel

Sie verwenden den Assistenten für BizTalk WCF-Dienstpublishing zum Veröffentlichen von Schemas als WCF-Dienste.

Hinweis

Vor Ausführung des Assistenten für BizTalk WCF-Dienstpublishing müssen Sie Ihre BizTalk-Projekte erstellen. Die BizTalk-Projekte müssen Schemas zum Veröffentlichen als WCF-Dienste enthalten.

So veröffentlichen Sie Schemas als WCF-Dienste

  1. Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Microsoft BizTalk Server 20xx, und klicken Sie dann auf BizTalk WCF-Dienstveröffentlichungs-Assistent.

    Hinweis

    Zum Erstellen und Veröffentlichen von BizTalk-Orchestrierungen und -Schemas als WCF-Dienste mit den WCF-Adaptern wird der Assistent für BizTalk WCF-Dienstpublishing verwendet. Zum Veröffentlichen von Orchestrierungen und Schemas als Webdienste mit dem SOAP-Adapter verwenden Sie den Assistenten für BizTalk-Webdienstpublishing.

  2. Klicken Sie auf der Seite Willkommen beim BizTalk WCF-Dienstveröffentlichungs-Assistent auf Weiter.

  3. Wählen Sie auf der Seite WCF-Diensttyp die Option Dienstendpunkt aus, um die WCF-Dienste für ausgewählte BizTalk-Orchestrierungen in einer BizTalk-Assembly zu veröffentlichen.

    WCF-Diensttypseite

  4. Aktivieren oder deaktivieren Sie auf der Seite WCF-Diensttyp das Kontrollkästchen Metadatenendpunkt aktivieren , um anzugeben, ob der isolierte WCF-Empfangsspeicherort, der von Internetinformationsdiensten (IIS) gehostet wird, Dienstmetadaten zum Abrufen mithilfe einer HTTP/GET-Anforderung veröffentlicht.

    Wenn dieses Kontrollkästchen aktiviert ist, generiert der Assistent eine Web.config Datei, in der das attribut httpGetEnabled des <serviceMetadata-Elements> auf true festgelegt ist. Sie können zum Erstellen des Clientcodes, mit dem dieser Dienst in der Entwicklungsumgebung aufgerufen wird, ein Metadaten-Import-Dienstprogramm (z. B. SvcUtil.exe) verwenden. Die Adresse, an der die Metadaten veröffentlicht werden, ist die Endpunktadresse sowie eine ?wsdl-Abfragezeichenfolge .

    Hinweis

    Um unbeabsichtigtes Offenlegen sicherheitsrelevanter Dienstmetadaten zu verhindern, sollte dieses Verhalten in der Produktionsumgebung deaktiviert werden. Zu diesem Zweck können Sie den Wert für "httpgetenabled" auf "false" festlegen oder das virtuelle Verzeichnis "MEX" löschen.

  5. Wählen Sie auf der Seite WCF-Diensttyp in der Dropdownliste Adaptername (Transporttyp) den isolierten WCF-Adapter aus, mit dem die WCF-Dienste veröffentlicht werden. Sie können einen der folgenden Adapter auswählen:

    • WCF-BasicHttp. . Der WCF-BasicHttp-Adapter kann mit WS-I Basic Profile 1.1-konformen Webdiensten kommunizieren, wie z. B. mit ASMX-basierten Diensten.

    • WCF-WSHttp. . Der WCF-WSHttp-Adapter kann mithilfe von WS-*-Standards über HTTP und HTTPS mit einem Dienst kommunizieren.

    • WCF-CustomIsolated. . Mithilfe des WCF-CustomIsolated-Adapters können Sie Erweiterbarkeitsfeatures von Windows Communication Foundation (WCF) über den HTTP-Transport verwenden.

  6. Aktivieren Sie auf der Seite WCF-Diensttyp das Kontrollkästchen BizTalk-Empfangsspeicherorte in der folgenden Anwendung erstellen , um die Empfangsports und Speicherorte zu erstellen, die den einzelnen generierten SVC-Dateien für den WCF-Adapter entsprechen, den Sie in der Dropdownliste Adaptername ausgewählt haben. Wenn bereits ein Empfangsspeicherort vorhanden ist, wird er nicht ersetzt. Nachdem Sie diese Option ausgewählt haben, wählen Sie in der Dropdownliste BizTalk-Anwendungsname die Anwendung aus, in der die Empfangsports und Speicherorte generiert werden, und klicken Sie dann auf Weiter.

  7. Wählen Sie auf der Seite WCF-Dienst erstellen die Option Schemas als WCF-Dienst veröffentlichen aus, und klicken Sie dann auf Weiter.

    Seite

  8. Definieren Sie auf der Seite WCF-Dienst die zu veröffentlichenden WCF-Dienste. Verwenden Sie die Struktur im Dialogfeld Webdienstbeschreibung , um die Webdienstbeschreibungsknoten für die zu veröffentlichenden WCF-Dienste hinzuzufügen, zu entfernen, umzubenennen und zu bearbeiten. Das Dialogfeld Informationen enthält Informationen zum ausgewählten Knoten und zeigt alle Fehler in den aktuellen Knoten oder Unterknoten an:

    • Der Stammknoten der Struktur ("Webdienstbeschreibung") beschreibt die zu veröffentlichenden WCF-Dienste. Im Namen des virtuellen Verzeichnisses wird der Stammknoten als Standardname verwendet. Sie können den Namen der Webdienstbeschreibung für die zu veröffentlichenden WCF-Dienste ändern, indem Sie Webdienstbeschreibung umbenennen auswählen.

      WCF-Dienstseite

    • Der Webmethodenknoten Operation1 des Standarddienstknotens Service1, der standardmäßig im Dialogfeld Webdienstbeschreibung angezeigt wird, kann für einen Anforderungs-Antwort-Empfangsspeicherort verwendet werden. Wenn Sie einen unidirektionale WCF-Empfangsspeicherort für diese Dienstbeschreibung veröffentlichen möchten, klicken Sie mit der rechten Maustaste auf den Standardknoten Webmethoden, klicken Sie auf Webmethode löschen, und erstellen Sie dann wie folgt eine unidirektionale Webmethode: Klicken Sie mit der rechten Maustaste auf den Standarddienstknoten, zeigen Sie auf Webmethode hinzufügen, und klicken Sie dann auf Unidirektionale Methode.

    • Klicken Sie zum Hinzufügen eines neuen WCF-Diensts mit der rechten Maustaste auf den Namen der Webdienstbeschreibung, und klicken Sie dann auf Webdienst hinzufügen. Damit wird ein neuer WCF-Dienst ohne WCF-Vorgänge erstellt. Um den Namen des WCF-Diensts zu ändern, klicken Sie mit der rechten Maustaste auf den WCF-Dienstknoten, klicken Sie auf Webdienst umbenennen, und drücken Sie dann die EINGABETASTE, um den neuen Namen zu übernehmen.

    • Klicken Sie zum Hinzufügen eines neuen WCF-Vorgangs mit der rechten Maustaste auf den WCF-Dienstknoten, zeigen Sie auf Webmethode hinzufügen, und klicken Sie dann auf Unidirektionale (für einen WCF-Anforderungsvorgang) oder Auf Anforderungsantwort (für einen Anforderung-Antwort-WCF-Vorgang).

    • 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 globale Assemblycache denselben vollqualifizierten Namen hat, verwendet der Assistent für BizTalk WCF-Dienstpublishing die Assemblydatei in diesem Cache und nicht die von Ihnen ausgewählte Assemblydatei.

      Seite

    • 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 den WCF-Vorgang ändern. Sie können die Änderungen sehen, indem Sie die Dienstmetadaten für die zu veröffentlichenden WCF-Dienste anzeigen.

      Hinweis

      Beim Umbenennen von Webdienstbeschreibungsknoten dürfen Sie keine Leerzeichen verwenden.

  9. Klicken Sie auf Weiter , um den Assistenten fortzusetzen.

  10. Geben Sie auf der Seite WCF-Diensteigenschaften im Textfeld Zielnamespace des WCF-Diensts einen Zielnamespace für die WCF-Dienste ein, und klicken Sie dann auf Weiter.

    Wcf-Diensteigenschaftenseite

  11. Geben Sie auf der Seite Speicherort des WCF-Diensts im Textfeld Speicherort den Namen des Webverzeichnisses ein, in dem die WCF-Dienste generiert werden. Sie können den Standardspeicherort (http://localhost/<Web service description name>) akzeptieren, einen Speicherort für die WCF-Dienste in das Textfeld Speicherort 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 das Webverzeichnis bereits vorhanden ist. Das Veröffentlichen im selben Speicherort kann nur erfolgen, wenn Sie diese Option auswählen. Andernfalls müssen Sie einen anderen Projektspeicherort eingeben.

    • Anonymen Zugriff auf WCF-Dienst 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).

      Wenn Sie diese Seite abgeschlossen haben, klicken Sie auf Weiter.

      Seite

    Hinweis

    Der Projektspeicherort kann sich auf einem anderen Server befinden. Um die WCF-Dienste auf einem anderen Server zu veröffentlichen, geben Sie den Projektnamen als http://<servername>/<WCF service location>ein.

    Hinweis

    Der Projektspeicherort kann sich auf einer anderen Website als der Standardwebsite befinden. Fügen Sie bei einer Veröffentlichung auf einer nicht standardmäßigen Website der URL die Portnummer der Website hinzu. Beispiel: http://<servername>:8080/<WCF service location>.

    Hinweis

    Wenn Sie den Assistenten zum Erstellen von Empfangsspeicherorten verwenden, erstellt er die Empfangsspeicherorte mit den Standardwerten. Der Standardwert für die Empfangspipeline ist die Pipeline Microsoft.BizTalk.DefaultPipelines.PassThruReceive . Wenn nachrichten, die über die veröffentlichten WCF-Dienste empfangen werden, eine spezielle Pipelineverarbeitung erfordern (z. B. Validierung, Korrelation/Eigenschaftsheraufstufung oder ein-/ausgehende Zuordnungen), sollten Sie die Empfangspipeline auf Microsoft.BizTalk.DefaultPipelines.XMLReceive oder auf eine benutzerdefinierte Pipeline festlegen, indem Sie die BizTalk-Verwaltungskonsole verwenden.

  12. Überprüfen Sie auf der Seite WCF-Dienstzusammenfassung Ihre Einstellungen für die WCF-Dienste.

  13. Klicken Sie auf Erstellen , um die WCF-Dienste zu erstellen.

  14. Klicken Sie auf Fertig stellen , um den BizTalk WCF-Dienstveröffentlichungs-Assistenten abzuschließen.

  15. Nachdem Sie die WCF-Dienste mit dem Assistenten für BizTalk WCF-Dienstpublishing veröffentlicht haben, müssen Sie sie ordnungsgemäß konfigurieren. Informationen zum Konfigurieren des isolierten WCF-Empfangsadapters finden Sie unter Konfigurieren von WCF-Diensten, die mit dem BizTalk WCF-Dienstveröffentlichungs-Assistenten veröffentlicht wurden.

Weitere Informationen

Konfigurieren von WCF-Diensten, die mit dem Assistenten für BizTalk WCF-Dienstpublishing veröffentlicht wurden
Exemplarische Vorgehensweise: Veröffentlichen von WCF-Diensten mit dem WCF-BasicHttp-Adapter
Verwenden des Assistenten für BizTalk-Webdienstpublishing zum Veröffentlichen von Orchestrierungen als WCF-Dienste