Refer to Choosing WCF or Web API for additional information on WCF and Web API.
Note: If you are creating a new WCF web service, it is recommended that you use the Multi-Targeting Issues project type.
This presentation project provides a WCF service interface for a ClearPath Data Source application. This project does not rely on ASP.Net, rather it uses SOAP for session management and security.
Procedure 1 - Creating a WCF Service Application
To add a WCF Service Application project, do the following:
On the File menu, point to New and click Project.
In the Create a new project dialog box, do the following:
Notes:
Select C# or All Languages from the Language list.
Select Windows or All Platforms from the Platform list.
The ePortal templates are not displayed if other values are selected.
Select ePortal Presentation from the Project Type list.
The ePortal Presentation templates are displayed.
Do any one of the following to select the template:
From the templates list, select WCF Service Application, and then click Next.
Enter WCF Service Application in the search option, select the template from the search result, and then click Next.
Optionally, change the Project name, Location, and Framework, and click Create.
Notes:
If you do not select a desired Framework, a default Framework version is selected.
For information on selecting the .NET version, refer to Multi-Targeting Issues.
On the Presentation Generation Options dialog, enter values for the generation. Refer to Presentation Generation Properties for a WCF Service Application.
Click OK. The presentation project appears in Solution Explorer.
Procedure 2 - Building the Project
In Solution Explorer, right-click the WCF Service project node, and then click Build. Refer to Building Your ePortal Solution for more information.
When the project is built, ePortal generates the files to implement a WCF Service Application based on the data source.
Refer to Consuming the Web Service Methods by a Web Service Client for information about using the methods in a Web service client.
Generated Files
Building a WCF Service Application project generates the following files:
In the App_Data directory: data source specific data files
In the project root directory: Service.svc, ApplicationInfo.xml file, epconfig files, epuo file and Web.config
The Web.config file specifies the endpoint, binding, behavior, and security that ePortal Developer uses to test the Web Service Library as well as those used in the application. This file specifies wsHTTPBinding with Security Mode set to Message, and specifies Transport and Message Credential types set to Windows. These settings enable easy local testing of session based services. This file also specifies a wsHTTPBinding (name=”ReleaseBinding”) with Security Mode set to TransportWithMessageCredential, and specifies the Transport Credential to none, and the Message Credential to UserName. This binding is used by the deployed application. A third binding, basicHTTPBinging, is provided for use with sessionless applications.
In the App_Code directory: IService.cs, Service.cs
IService.cs contains the definition of the service contract. Service.cs contains the code that implements the service contract.
Procedure 3 - Preparing To Use the Presentation Project
To prepare the use a WCF Service Application project, do the following:
Modify the Web.config file.
Perform custom programming, if required.
Modifying the Web.config File
The Web.config file comes configured with three bindings:
basicHttpBinding (name=SessionlessBinding) for use with services that do not require a session
wsHttpBinding(name=ReleaseBinding) for use by a deployed application that requires a session
wsHttpBinding(name=TestBinding) for local testing of applications that require a session
For information on the use of these bindings refer to Modifying the Web.config File.
Performing Custom Programming
When you create and build the project, ePortal Developer generates code to implement your service. Refer to Testing a Presentation Project for information for customizing this implementation.
Procedure 4 - Testing
Refer to Testing a Presentation Project.
Procedure 5 - Modifying the Service.svc File
When you build the solution, ePortal Developer sets the Service.svc file as the following example shows:
<%@ ServiceHost Language="C#" Debug="true" Service="WcfService1 . Service" Factory="ServiceFactory" CodeBehind="~/App_Code/Service.cs, WebSupport.dll" %>
Before you stage the Web site to ePortal, set the Debug option to False.
Next Step