Verwenden des Verarbeitungs-Assistenten für BizTalk-WCF-Dienste zum Verarbeiten eines WCF-Diensts

Mithilfe des BizTalk-Adapterframeworks können BizTalk-Projekten Adapterschemas und BizTalk-Typen hinzugefügt werden. Der Verarbeitungs-Assistent für BizTalk-WCF-Dienste ermöglicht das Hinzufügen eines WCF-Sendeadapters zu einem einem BizTalk-Projekt. Für die WCF-Sendeadapter müssen Sie einen vorhandenen MEX-Endpunkt (Metadatenaustausch) für Sendeports auswählen. Dann müssen Sie die Informationen eingeben, die zum Generieren der Schemas und Typen verwendet werden. Nachdem der Assistent abgeschlossen wurde, werden die Schemas und Typen, die zum Verarbeiten der WCF-Dienste erforderlich sind, dem BizTalk-Projekt hinzugefügt.

So fügen Sie die Schemas und Typen für WCF-Sendeadapter dem Projekt hinzu

1. Klicken Sie in Ihrem Microsoft Visual Studio BizTalk-Projekt in Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, klicken Sie auf Hinzufügen und dann auf Generierte Elemente hinzufügen.

2. Wählen Sie im Dialogfeld Generierte Elemente hinzufügen – <Projektname> im Abschnitt Vorlagen die Option WCF-Dienst nutzen aus, und klicken Sie dann auf Hinzufügen.

3. Klicken Sie auf der Seite Willkommen beim BizTalk WCF-Dienstverbrauchs-Assistent auf Weiter.

4. Wählen Sie auf der Seite Metadatenquelle die Quelle der zu importierenden Metadaten aus, und klicken Sie dann auf Weiter.

   

   Um Metadatendokumente vom Metadatenaustauschendpunkt eines ausgeführten Diensts herunterzuladen, wählen Sie die Option Metadata Exchange (MEX)-Endpunkt aus. Auf diese Weise kann ein Sendeport erstellt werden, der als Client für den WCF-Dienst fungiert. Damit diese Option verwendet werden kann, muss der Dienstendpunkt Dienstmetadaten für den Abruf mithilfe einer HTTP/GET- oder HTTPS/GET-Anforderung veröffentlichen. Der Dienstendpunkt muss außerdem den Zugriff auf die Metadaten mit anonymen Benutzeranmeldeinformationen oder mit Anmeldeinformationen in Form eines Benutzernamens und Kennworts nach dem Standardauthentifizierungsschema erlauben.

   Hinweis

   Beim Standardauthentifizierungsschema werden die Anmeldeinformationen unverschlüsselt gesendet und können auf einfache Weise abgefangen werden. Das Schema bietet auch keinen Schutz für die Informationen, die der Dienst zurücksendet. Sie müssen SSL (Secure Sockets Layer) zum Verschlüsseln der Daten verwenden.

   Um andere Metadatendokumente zu importieren, wählen Sie die Option Metadatendateien (WSDL und XSD) aus, um Metadaten aus einem Dateisystem zu importieren.

   Hinweis

   Metadaten müssen nicht von allen Diensten veröffentlicht werden. Wird das Veröffentlichen von Metadaten nicht aktiviert, bietet der Dienst eine geringere Angriffsfläche, und auch das Risiko der ungewollten Preisgabe von Informationen ist geringer.

5. Wenn Sie auf der Seite Metadatenquelle die Option Metadata Exchange (MEX)-Endpunkt ausgewählt haben, wird die Seite Metadatenendpunkt angezeigt. Geben Sie auf der Seite Metadatenendpunkt die URL für den ausgeführten Dienst an, der Metadaten zum Herunterladen über WS-Metadata Exchange oder Http-Get bereitstellt. Klicken Sie auf Abrufen, um das Metadatendokument aus der URL abzurufen. Wenn für den ausgeführten Dienst Benutzeranmeldeinformationen mit dem Standardauthentifizierungsschema erforderlich sind, klicken Sie auf Bearbeiten , um das Dialogfeld BizTalk WCF-Dienstnutzungs-Assistent zu öffnen, in dem Sie Benutzernamen und Kennwort angeben können, die beim Zugriff auf die Ausführung des Diensts verwendet werden sollen.

   

   Hinweis

   Zum Herunterladen der Metadaten für WCF-Dienste, die über HTTP oder HTTPS veröffentlicht wurden, können Sie den MEX-Endpunkt nicht verwenden, z http://localhost:8087/CalculatorService/mex . B. für das Textfeld Metadatenadresse . Für die WCF-Dienste müssen Sie die WSDL-Metadaten verwenden, um die Metadaten wie folgt herunterzuladen: oder: http://localhost:8087/CalculatorServicehttp://localhost:8087/CalculatorService?wsdl

6. Wenn Sie auf der Seite Metadatenquelle die Option Metadatendateien (WSDL und XSD) ausgewählt haben, wird die Seite Metadatenendpunkt angezeigt. Geben Sie auf der Seite Metadatenendpunkt die zu importierenden Metadatendateien an. Klicken Sie auf Hinzufügen , um die Metadatendateien hinzuzufügen, die in die Ansicht Metadatendateien importiert werden sollen. Dadurch wird das Dialogfeld Metadatendateien hinzufügen geöffnet, in dem Sie Datenträgerspeicherorte nach Metadatendateien durchsuchen können.

   Wählen Sie im Dialogfeld Metadatendateien hinzufügen einen vollständigen Satz von WSDL- und XSD-Dateien aus, die für Metadaten verwendet werden sollen. Sie können diese Metadatendateien generieren, indem Sie den folgenden Befehl an einer Eingabeaufforderung eingeben:

   svcutil.exe /t:metadata http://localhost/service.svc/mex

   Klicken Sie auf Entfernen , um die in der Ansicht Metadatendateien ausgewählten Metadatendateien zu entfernen.

   

   Hinweis

   "SvcUtil.exe" ist im Microsoft Windows Software Development Kit (SDK) für Windows Vista und die .NET Framework-Laufzeitkomponenten enthalten.

   Hinweis

   Werden die Dienstmetadaten auf unsichere Weise abgerufen, können die Daten manipuliert oder gespooft werden. Manipulierte Metadaten können Ihren Client ggf. an einen böswilligen Dienst umleiten oder möglicherweise bloßgelegte Sicherheitseinstellungen oder bösartige XML-Strukturen enthalten. Metadatendokumente können sehr groß sein und werden häufig im Dateisystem gespeichert. Sie müssen sicherstellen, dass die Metadatendateien nicht manipuliert wurden.

7. Überprüfen Sie auf der Seite Zusammenfassung der Metadaten des WCF-Diensts Ihre Einstellungen. Sie können auf Zurück klicken, um Änderungen vorzunehmen. Klicken Sie dann auf Importieren , um die BizTalk-Artefakte und -Typen zu erstellen, die für die Nutzung des WCF-Diensts verwendet werden sollen.

8. Klicken Sie auf der Seite Assistent zum Abschließen des BizTalk WCF-Diensts auf Fertig stellen. Wenn Sie diesen Assistenten erneut ausführen möchten, wählen Sie die Option Diesen Assistenten erneut ausführen aus, und klicken Sie dann auf Fertig stellen.

   Der Verarbeitungs-Assistent für den BizTalk-WCF-Dienst erstellt in Ihrem BizTalk-Projekt die BizTalk-Schemas und -Typen, die zum Verarbeiten von WCF-Diensten erforderlich sind. Die BizTalk-Typen, z. B. Porttypen und mehrteilige Nachrichtentypen, werden in einer Orchestrierung erstellt. Es wird daher empfohlen, die vom Assistenten erstellte Orchestrierung nicht zu ändern. Stattdessen können Sie neue Orchestrierungen im BizTalk-Projekt für Ihre Zwecke hinzufügen. Der BizTalk WCF-Dienstverbrauchs-Assistent erstellt auch zwei Bindungsdateien, BizTalkServiceInstance.BindingInfo.xml und BizTalkServiceInstance_Custom.BindingInfo.xml. BizTalkServiceInstance.BindingInfo.xml ist eine BizTalk-Bindungsdatei, die vom Befehlszeilentool oder Assistenten für die Entwicklung importiert werden kann, um die Sendeports mit den STANDARDMÄßIGen WCF-Bindungsadaptern zu konfigurieren, z. B. den WCF-NetMsmq- und WCF-WSHttp-Adaptern. BizTalkServiceInstance.BindingInfo.xml ist eine BizTalk-Bindungsdatei, die vom Befehlszeilentool oder Assistenten für die Entwicklung importiert werden kann, um die Sendeports mit dem WCF-Custom-Adapter zu konfigurieren.

   Wenn Sie die generierte Bindungsdatei importieren, wird der WCF aufgefüllt . Action-Eigenschaft im Aktionszuordnungsformat. Um zu sehen, wie diese Eigenschaft konfiguriert ist, sehen Sie sich das Textfeld Aktion auf der Registerkarte Allgemein im Dialogfeld WCF-Sendeporttransporteigenschaften in der BizTalk-Verwaltungskonsole an.

   Sie können den WCF angeben. Action-Eigenschaft auf zwei verschiedene Arten: das einzelne Aktionsformat und das Aktionszuordnungsformat. Wenn Sie diese Eigenschaft beispielsweise im Einzelaktionsformat festlegen, http://contoso.com/Svc/Op1 wird der SOAPAction-Header für ausgehende Nachrichten immer auf den in dieser Eigenschaft angegebenen Wert festgelegt. Wenn Sie diese Eigenschaft im Aktionszuordnungsformat festlegen, wird der ausgehende SOAPAction-Header vom BTS bestimmt. Vorgangskontexteigenschaft . Wenn diese Eigenschaft beispielsweise auf das folgende XML-Format und das BTS festgelegt ist. Die Operation-Eigenschaft ist auf Op1 festgelegt, die der WCF-Sendeadapter für den ausgehenden SOAPAction-Header verwendethttp://contoso.com/Svc/Op1.

   <BtsActionMapping>

   <Operation Name="Op1" Action="http://contoso.com/Svc/Op1" />

   <Operation Name="Op2" Action="http://contoso.com/Svc/Op2" />

   </BtsActionMapping>

   Wenn ausgehende Nachrichten von einem Orchestrierungsport stammen, legen Orchestrierungsinstanzen den BTS dynamisch fest. Operation-Eigenschaft mit dem Vorgangsnamen des Ports. Wenn ausgehende Nachrichten mit inhaltsbasiertem Routing weitergeleitet werden, können Sie den BTS festlegen. Operation-Eigenschaft in Pipelinekomponenten. Die vom BizTalk WCF-Nutzungs-Assistenten generierten Ports verfügen über Vorgänge mit Namen, die den Name-Attributen im <BtsActionMapping-Element> entsprechen. Sie müssen den BTS nicht explizit festlegen . Operation-Eigenschaft in Orchestrierungen, wenn Sie Nachrichten über Ports senden, die vom Assistenten generiert wurden.

Weitere Informationen

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