The web service is implemented as a C# class. The code in this class executes on the web server system. For an application in production, the web server system is the ePortal platform. When you test your presentation project during development, the web server system is your development system. The purpose of the service implementation is to respond to service requests and return the service results. You might want to add new methods to the implementation.
Notes:
To program in the service implementation, do not edit the generated files directly. When you build the solution, the files are overwritten. Instead, follow the process below to program in the service implementation.
Throughout this section, <servicename> refers to the service name specified in the Presentation Generation Properties.
To program in the service implementation, you must create a new class file that implements a public partial class. A partial class allows you to define the code for a single class in multiple physical files. To add methods to the web service, you add to the Interface.
Perform the following steps:
In Solution Explorer, navigate to the App_Code folder in your WCF project.
Right-click the App_Code folder and select Open Folder in File Explorer.
In File explorer, copy file Service.cs to the same folder, and rename the copy to something appropriate, such as ServiceAdditions.cs.
Return to Visual Studio Solution Explorer.
Right-click the App_Code folder and select Add | Existing Item….
In the dialog, select the file that you just renamed.
In Solution Explorer, double-click the new file to open it in the editor.
Delete the entire contents of the partial class Service. Also delete any attributes in square brackets that appear on the lines just before the Service class, such as the ServiceBehavior attribute.
Inside the braces for the Service class, you can implement new methods.
If you add a new method that needs to appear in the service contract, add a corresponding new entry in the IService interface. Refer to the example code below.
Your code can also write messages to the ePortal log for debug or auditing purposes; refer to Logging Messages from your Code and Logging Errors and Tracing.
The following is a simple example of an override file for an implementation of a service named MyService. The example illustrates creating a new method named NewMethod, and writing messages to the ePortal log.
using System;
using System.ServiceModel;
using Unisys.Common.Shared;
namespace WcfService1
{
public partial interface IService
{
// Depending on how you specified RequiresSession in Presentation Generation Options,
// choose one of the following attributes
//[OperationContract] // RequiresSession = false
[OperationContract(IsInitiating = true, IsTerminating = false)] // RequiresSession = true
String NewMethod(String inputParam);
}
public partial class Service : IService
{
public virtual String NewMethod(String inputParam)
{
Logging.WriteLogs(Logging.LogLevel.Information,
"Inside NewMethod({0})", inputParam);
return "Results";
}
}
}