Export (0) Print
Expand All

BizTalk WCF Service Publishing Wizard

[Unless specifically noted, the content in this topic applies to BizTalk Server 2013 and 2013 R2.]

Use the BizTalk WCF Service Publishing Wizard to create and publish BizTalk orchestrations as WCF services, and to publish schemas as WCF services for the isolated WCF adapters hosted by Web applications running in IIS. You can also use the BizTalk WCF Service Publishing Wizard to publish service metadata for any WCF locations for the in-process WCF adapters. For general usage information about the BizTalk WCF Service Publishing Wizard, see Using WCF Services.

note
When running the BizTalk WCF Service Publishing Wizard on a Windows operating system that uses User Access Control (UAC), such a Windows Server 2008 SP2 and Windows 7, you may need to disable UAC to run the wizard to completion. This can be done through the MSCONFIG.EXE system utility.

note
You may need to register the .svc extension with Internet Information Server (IIS) before you are able to browse to the service using the WCF Service Location Page. You can find information on this topic at either Deploying an Internet Information Services-Hosted WCF Service or Deploying an IIS-Hosted WCF Service.

WCF Service Type

Use this page to select the type of WCF service to publish.

 

Use this To do this

Service endpoint

Publish the WCF services based on selected BizTalk orchestrations or schemas in a BizTalk assembly.

Adapter name (Transport type)

Specify the WCF adapter with which to publish these WCF services. Valid values only include the isolated WCF receive adapters as the following:

  • WCF-BasicHttp

  • WCF-WSHttp

  • WCF-CustomIsolated

You have to republish the WCF services if you want to change this adapter type.

Enable metadata endpoint

Indicate whether the isolated WCF receive location hosted by Internet Information Services (IIS) publish service metadata for retrieval using an HTTP/GET request. By enabling this check-box, the wizard generates Web.config where the httpGetEnabled attribute of the <serviceMetadata> element is set to true. You can use a metadata import tool (such as SvcUtil.exe) to generate the client code required to call this service in the development environment. To prevent unintentional disclosure of potentially sensitive service metadata, it is recommended to disable this behavior on the production environment.

Create BizTalk receive locations in the following application

Specify whether to create the receive locations for the WCF services in the BizTalk application specified in the BizTalk application name property.

BizTalk application name

Specify the BizTalk application where the receive locations for the WCF services are created.

Metadata only endpoint (MEX)

Use this option for to publish service metadata of the existing WCF receive locations for retrieval using an HTTP/GET request. By using this option, you can publish service metadata of an in-process WCF receive adapter through IIS. By enabling this option, the wizard generates Web.config where the httpGetEnabled attribute of the <serviceMetadata> element is set to true. You can use a metadata import tool (such as SvcUtil.exe) to generate the client code required to call this service in the development environment. To prevent unintentional disclosure of potentially sensitive service metadata, it is recommended to disable this behavior on the production environment.

noteNote
When you select the Metadata only endpoint (MEX), make sure not to leave the Publish metadata for receive location drop-down list blank.

Publish metadata for receive location

Specify the WCF receive location for which to publish service metadata through IIS.

Create WCF Service Page

Use this page to select a method of creating your WCF service.

 

Use this To do this

Publish BizTalk orchestrations as WCF service

Publish WCF services based on selected orchestrations and ports in a BizTalk assembly.

Publish schemas as WCF service

Publish WCF services by specifying operations and messages of WCF services using selected schemas from BizTalk assemblies as request and/or response message parts.

BizTalk Assembly Page

Use this page to select a BizTalk assembly to publish WCF services from.

 

Use this To do this

BizTalk assembly file (*.dll)

Select a BizTalk assembly.

Your assembly does not need to be deployed to publish WCF services at design time.

If your assembly has dependencies, you must resolve any dependencies in your assembly before you can publish WCF services from it. The assembly must be deployed and properly bound to be used at run time.

Orchestrations and Ports Page

Use this page to select orchestrations and ports to publish in WCF services.

 

Use this To do this

BizTalk assembly description

Select the orchestrations and ports that you want to export. You can select the orchestrations and ports in the assembly to expose in your published WCF services. Only public ports are visible.

Merge all selected ports into a single WCF service

Specify whether to merge all the selected ports into a single WCF service. If this check box is cleared, one service can have only one port, which can result in multiple services being generated.

noteNote
If you select this check box, all operations in a single WCF service must have unique names in the service.

The default value is cleared.

WCF Service Properties Page

Use this page to specify the properties for the WCF services.

 

Use this To do this

Target namespace of WCF service

Select a target namespace of the WCF services. The target namespace appears in the Web Services Description Language (WSDL) file. The System.Uri constructor is used to determine the validity of this namespace.

WCF Service Location Page

Use this page to specify the location of the WCF services to create.

 

Use this To do this

Location (http://host[:port]/path)

Specify the path name of the virtual directory where the WCF services are published.

ImportantImportant
You must use ANSI characters.

Overwrite existing location

Overwrite the existing location when you republish the WCF services.

Browse button

Search the virtual directory for the WCF services.

Allow anonymous access to WCF service

Set the AuthAnonymousflag on the published virtual directory.

WCF Service Page

Use this page to describe the WCF service that you are creating. Right-click a node to view properties and menu options to add, rename, or delete a WCF service or Web method.

 

Use this To do this

Web service description

Display the detail information about the WCF services published. When you click a node in this tree view, the Information text box displays more detail information about the node.

The default value is BizTalkWcfService.

Information

Display more detail information about the node selected in the Web service description view.

Add web service

Add a WCF service. To run this command, right-click the Web service description name, and then click Add web service.

Rename web service description

Rename a Web service description. To run this command, right-click the Web service description name, and then click Rename web service description.

Add web method

Add a Web method in the WCF service selected in the Web service description view. To run this command, right-click a WCF service, click Add web method, and then click the message exchange pattern for the Web method: One-way or Request-response.

Rename web service

Rename the WCF service selected in the Web service description view. To run this command, right-click a WCF service, and then click Rename web service.

Delete web service

Delete the WCF service selected in the Web service description view. To run this command, right-click a WCF service, and then click Delete web service.

Rename web method

Rename the Web method selected in the Web service description view. To run this command, right-click a Web method, and then click Rename web method.

Delete web method

Delete the Web method selected in the Web service description view. To run this command, right-click a Web method, and then click Delete web method.

Select schema type

Select a schema type in the Request Message Type or Response Message Type dialog box. To run this command, right-click a WCF message, and then click Select schema type. This command opens the Request Message Type or Response Message Type dialog box depending on the direction of the selected WCF message: Input or Output.

Rename web message

Rename the WCF message selected in the Web service description view. To run this command, right-click a WCF message, and then click Rename web message.

Request Message Type/Response Message Type

Use these dialog boxes to select a message type from BizTalk assemblies to use as a request or response WCF message.

 

Use this To do this

BizTalk assembly file (*.dll)

Select a BizTalk assembly.

Browse

Search disk locations for a file location.

Available schema types

Display the message types included in the BizTalk assembly selected in the BizTalk assembly file (*.dll) property. You can select a message type to use as a request or response WCF message.

WCF Service Summary Page

Use this page to review your settings. Click Back to make any changes to your published WCF services. Click Create to create your published WCF services.

Completing the BizTalk WCF Service Publishing Wizard Page

Use this page to determine if you have successfully published your WCF service.

 

Use this To do this

Run this wizard, click Finish

Specify whether to run this wizard again.

See Also

© 2014 Microsoft Corporation. All rights reserved.

Community Additions

ADD
Show:
© 2014 Microsoft