Skip to content

This repository contains example ASP .NET code for interfacing with the Highways Agency NTIS system. IMPORTANT NOTE: this repository is now obsolete (retained for reference only); to receive data from the NTIS system, utilise the Release 2.4 repository at https://github.com/ntisservices/ntis-dotnet-web-services-Release2.4.

License

MIT, MIT licenses found

Licenses found

MIT
LICENSE.txt
MIT
copyright.txt

ntisservices/OBSOLETE-ntis-dotnet-web-services-R2.2

Repository files navigation

NTIS Subscriber Service - README

This project is an example implementation of the NTIS Subscriber Service. It has been created in Visual Studio 2012, and uses the 4.5 version of the .NET framework.

The example service has been created using WCF and small changes may be required in order to use it on older versions of the .NET framework.

Building and testing the website

Testing

You will be able to launch the webservice from within the visual studio debugger. This will allow you to verify that the solution builds, and that there are no configuration issues. Once the service is running, you can verify it's operation by using either the SoapUI example test project located in \SubscriberService\SoapUI Tests or by using the included test client located in \TestClient

Deploying the webservice on IIS 5

Instructions are as follows:

  1. Start up "Internet Information Services", by going to the "Control Panel", double clicking on "Administrative Tools", and double clicking on "Internet Information Services".
  2. Expand "local computer".
  3. Expand "Web Sites".
  4. Right click on "Default Web Site", and select "New", "Virtual Directory".
  5. On the "Virtual Directory Creation Wizard" dialogue that appears, click "Next".
  6. Enter an "Alias" (e.g. "SubscriberWebService" and click "Next".
  7. Enter or browse to the directory containing the published content (e.g. C:\SubscriberWebSite) and click "Next".
  8. Leave the default settings checked for "Read" and "Run scripts (such as ASP)", and click "Next".
  9. Click "Finish".

Deploying on Windows 7 using IIS 7

Deploying the website for use by IIS 7 on a Windows 7 machine depends on the type of Windows 7 installation that you have. Microsoft may have certain configuration files locked down. If you have a home edition of Windows 7, IIS 7 may not have been installed by default. In this case, you need to go to the Control Panel, click on "Programs and Features", then "Turn Windows features on or off", and install it via the check boxes under "Internet Information Services".

With IIS 7 running, the web site should then be added as an application with the Application Pool set as "DefaultAppPool". Depending on your Windows 7 setup, you may have to set path credentials for a specific user.

Example Requests

Found in the "exampleRequests" folder. These can be used to form requests for testing your own client that you build.

Testing Using SoapUI

SoapUI is an open source cross-platform tool which can be used for testing SOAP requests and responses. The version used for testing this example was V4.0.1. Because of its simple interface, it was used as a client for testing this Subscriber web service.

  1. Make sure that the Subscriber web service is running.
  2. Start soapUI.
  3. From the main menu select File -> New soapUI Project.
  4. Enter a Project Name, browse to the WSDL or manually enter the location. e.g. http://localhost/contract/subscriber.wsdl, then press "OK".
  5. The service and methods will then be exposed.
  6. Modify any of the requests and enter suitable values, or copy any of the example messages provided in the "exampleRequests" folder, which match the message to be tested, and paste over the contents of the "Request 1" sample generated.
  7. Press the green play arrow at the top of the request and check that a success response is sent.
  8. The message requests and responses will be logged in "C:\temp\logs\SOAP". Additionally, if a DeliverANPRTrafficData request was sent, it will be processed by a sample implementation of the AnprTrafficDataService class, and logged in "C:\temp\subscriberservice.log".

Note, that soapUI can also be used to test gzip compressed messages and responses, by selecting "Preferences" from the File menu and selecting "gzip" from the "Request compression" option, and checking/unchecking the "Disable Response Decompression" option.

Note that the "deflate" compression option is not catered for in this implementation.

About

This repository contains example ASP .NET code for interfacing with the Highways Agency NTIS system. IMPORTANT NOTE: this repository is now obsolete (retained for reference only); to receive data from the NTIS system, utilise the Release 2.4 repository at https://github.com/ntisservices/ntis-dotnet-web-services-Release2.4.

Resources

License

MIT, MIT licenses found

Licenses found

MIT
LICENSE.txt
MIT
copyright.txt

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages