Programming in the Service Implementation for WCF Services Using Scaffolding

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 may wish to override existing methods in the generated implementation, or add new methods to the implementation.

Notes:

To program in the service implementation, do not edit the generated files directly. If you need to scaffold the data source again in the future, the files are overwritten. Instead, follow the process below to program in the service implementation.
Throughout this topic, <codenamefile> refers to the code file name specified on the Scaffold Unisys WCF Service for ePortal Data Source Dialog.
Throughout this topic, <servicename> refers to the service name specified on the Scaffold Unisys WCF Service for ePortal Data Source Dialog.

To program in the service implementation, you 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. In addition, to add additional methods to the web service, you add to the Interface.

Perform the following steps:

In Solution Explorer, navigate to your WCF project.
Right-click the project and select Open Folder in File Explorer.
In File explorer, copy the file <codenamefile>.svc.cs to the same folder, and rename the copy to something appropriate, such as <codenamefile>Overrides.cs.
Return to Visual Studio Solution Explorer.
Right-click the WCF project and select Add | Existing Item….
In the dialog, select the file you just renamed.
In Solution Explorer, double-click the new file to open it in the editor.
Delete the entire class <servicename>Base. You can do this easily by clicking the minus sign (-) in the margin to collapse the base class to a single line, then select the class and click the Delete button. Also delete any attributes in square brackets ([ ]) that appear on the lines just before the <servicename>Base class, such as the ServiceBehavior attribute.
Inside the braces for the <servicename> class, you can implement new methods or override existing methods.
For example, to override an existing method, go to a new line and type "public override" and press the space bar. Intellisense provides a list of all of the methods that you can override. Double-click your choice from the list to override that method.
If you add a new method that needs to appear in the service contract, add a corresponding new entry in the I<servicename> interface. See 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 overriding a method named SendLogin, creating a new method named NewMethod, and writing messages to the ePortal log.

using System;
using System.ServiceModel;
using Unisys.Common.Shared;
namespace eBankWcf
{
    public partial interface IMyService
    {
        // Depending on how you specified session required when scaffolding,
        // choose one of the following attributes
        //[OperationContract] // If session not required
        [OperationContract(IsInitiating = true, IsTerminating = false)]  // If session required 
        String NewMethod(String inputParam);
    }

    public partial class MyService : MyServiceBase, IMyService {
        public override eBankDataSource.Client.Home SendLogin(string Usercode, string Password)
        {
            Logging.WriteLogs(Logging.LogLevel.Information,
                "About to call SendLogin for user {0}", Usercode);
            return base.SendLogin(Usercode, Password);
        }
        public virtual String NewMethod(String inputParam)
        {
            Logging.WriteLogs(Logging.LogLevel.Information,
                "Inside NewMethod({0})", inputParam);
            return "Results";
        }
    }
}