This topic applies to a presentation project which implements WCF RESTful Service Application. Refer to Creating a WCF RESTful Service Application.
The WCF RESTful Service Test Client project supports testing RESTful Web Service projects whose RequestFormat and ResponseFormat are either JSON or XML, and for cases where a session is required or not required.
Procedure 1 - Creating a WCF RESTful Service Test Client Project
If you have not already done so, build your solution. In Solution Explorer, right-click the solution node and click Build Solution. Refer to Building Your ePortal Solution for more information.
In Solution Explorer, right-click the solution node, click Add, click New 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 Previous Versions from the Project Type list.
The ePortal Previous Versions templates are displayed.
Do any one of the following to select the template:
From the templates list, select WCF RESTful Service Test Client, and then click Next.
Enter WCF RESTful Service Test Client 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.
The test client project is always configured to use .NET Framework 4; the test client is never deployed to the platform, and the .NET 4 client works when testing a .NET 4 or higher WCF RESTful Web Service.
If your solution contains one or more RESTful Web service projects, you will see a dialog listing all of the RESTful Web service projects. Check one or more projects to be tested and click OK. You can use a single test client project to test multiple RESTful Web Service projects.
Build the solution again.
Procedure 2 – Testing Under the Debugger
Perform the following steps to test your WCF RESTful Service Application locally, before it is deployed to the platform:
In Solution Explorer, right-click the WCF RESTful Service Application project to be tested and click Set as StartUp Project. Do not set the test client itself as the startup project.
On the Debug menu, click Start Debugging. Visual Studio automatically starts one copy of IIS Express to host your Web service, and a second copy to host the test client. Then, the test client Web page opens in a Web browser window.
Refer to Using the Web API RESTful Test Client for instructions for using the test client.
If you encounter unexpected errors during your testing, refer to the Troubleshooting section of this help file.
Procedure 3 – Stopping the Debugger
When you are finished testing under the debugger, perform the following steps to stop the debugger:
On the Debug menu, click Stop Debugging.
If applicable, in the Windows system tray (at the right end of your Taskbar), right-click the icon for IIS Express and click Exit. If there are multiple copies of IIS Express running, you must stop each one.
Procedure 4 – Testing After Deployment
After you deploy the WCF RESTful Web Service to the ePortal platform, perform the following steps to test it:
In Solution Explorer, right-click the WCF RESTful Service Test Client project and click Set as StartUp Project. Do not set the web service project itself as the startup project.
On the Debug menu, click Start Debugging. Visual Studio automatically starts a copy of IIS Express to host the test client, then the test client Web page opens in a Web browser window.
Refer to Using the Web API RESTful Test Client for instructions for using the test client.