Service Introduction for PAF, epic 1271

Please note: These will be uploaded as separate articles on Knowledgebase

Article 1 - Business Overview

Please note this functionality of integrating with Postcode Anywhere (PCA) changes three main areas:

1. Add address in My Account, Registration, and Non-JS Checkout2. Store Search (includes search by partial postcode or Town/County)3. Add address in JS checkout (includes Auto-suggest feature)

Article 2 – Solution Design

Please note that we implemented Option 2 (connection with PCA via IL, not through an API)

Martini will still use the internal PAF (GMO’s resiliency). GMO address found from Postcode Anywhere will be added to Martini and not overridden by internal PAF.

Article 3- Technical flow diagrams

Add address in My Account, Registration and Non-JS Checkout

Store Search

Add address JS Checkout

Article 4 – Resiliency, performance tracking and switch to turn on/off functionality

Switches

Functionality Turn on Turn off LocationStore Address enable

enablePostCodeAnyWhereStoreSearch (true)

disable enablePostCodeAnyWhereStoreSearch (false)

Component Name : /tesco/ecom/commerce/Configuration

Add address in Registration, My Account and Non-JS checkout

enable enablePostCodeAnywhere ( true)

disable enablePostCodeAnywhere ( false) in

Component Name : /tesco/ecom/commerce/Configuration

Add address in JS checkout

enable enablePCAForJSCheckout (true)

disable enablePCAForJSCheckout (false)

Component Name : /tesco/ecom/commerce/Configuration

Resiliency

Please note that resiliency is automatic upon failure of Postcode Anywhere unless resiliency is switched off. Resiliency is also triggered on timeout which is 1 Minute.

Resiliency switch

Turn on Turn off Locationenable pafResillencyRequired (true)

disable pafResillencyRequired (false)

Component Name : /tesco/ecom/commerce/Configuration

Following Exceptions will be caught in scenario where PCA is down and we hit resiliency. These are found in ATG server Logs.

AxisFault InfraStructureFault RemoteException IllegalConfigurationException

Resiliency is also triggered on a timeout which is 1 Minute. This is configurable by updating the property timeout in the following component.

/com/tesco/ecom/userprofiling/service/LocationServiceResourcePool/

Below are the resiliency flow error messages, these are not front end.

Store Search - Sorry, collect from store isn't available at the moment. Please select 'Delivery' or call 0845 600 44 11 to order by phone.

My Account add address, checkout add address - Sorry, We are having technical problems finding your address. Please try again later or call 0845 600 44 11.

Performance Tracking

Please note performance tracking is done in ATG layer can be triggered at run time. It gives consolidated time for webservice call from ATG – IL – PCA – IL – ATG.

Performance tracking

Turn on Turn off Location enable logExecTime flag to (true)

enable logExecTime flag to (false )

com/tesco/responsetracker/service/PerformanceLogger

Article 5 – The additional webservice calls

Please note there no additional DB calls

How is the call to the third party made?- IL is making a REST call with Postcode Anywhere system. The flow is - ATG will invoke

the Location Service component of IL. - Location Service component will receive the message from ATG and will make a call to

LocatePCA service. - LocatePCA service will make a REST call to Postcode Anywhere and return the response

back to ATG.

What additional archives, web services are being provided in GMO4 for this?

- IL is providing one more archive LocatePCAService to achieve the requirement. This archive is provided as part of GMO4.

- We have updated the existing LocationService to expose four new services to ATG.

WSDL

Please open via Notepad

Webservice URLs:

• http://services.postcodeanywhere.co.uk/PostcodeAnywhere/Interactive/Find/v1.10/json3.ws?Key=AA11-AA11-AA11-AA11&SearchTerm=LL11 5HJ&PreferredLanguage=English&Filter=None&UserName=David

• http://services.postcodeanywhere.co.uk/PostcodeAnywhere/Interactive/RetrieveById/v1.30/json3.ws?Key=AA11-AA11-AA11-AA11&Id=23747212.00&PreferredLanguage=English&UserName=David

• http://services.postcodeanywhere.co.uk/PostcodeAnywhere/Interactive/FindByStreet/v1.00/json3.ws?Key=AA11-AA11-AA11-AA11&Street=Moseley&LocalityOrPartialPostcode=WR2&UserName=David

• http://services.postcodeanywhere.co.uk/Geocoding/UK/Geocode/v2.00/json3.ws?Key=AA11-AA11-AA11-AA11&Location=WR2 6NJ

JS URL:

This is the URL for postcode anywhere JS api and CSS file we are pointing in checkout.

<link rel="stylesheet" type="text/css" href="http://services.postcodeanywhere.co.uk/css/captureplus-1.34.min.css?key=ed59-pz86-tg22-kf68" />

<script type="text/javascript" src="http://services.postcodeanywhere.co.uk/js/captureplus-1.34.min.js?key=ed59-pz86-tg22-kf68&app=5176"></script>

The key in the above URLs is generated using a control panel when creating a new product [we use capture+]. This key will act as a unique identifier in our requests to the service. Once the key is generated, add the above code [stylesheet and script] in the head section of checkout.

JS file included sends request to PCA service on every key press in the textbox and the gives the results back as a json response. We use callback functions to parse the JSON response and get the required fields that are required to add an address.

Article 6 – End User License Agreement

Article 7 – Support Model including key contacts from Postcode Anywhere

Support of products is free and for as long as we use the product with no expiry date

Maintenance window - There is no formal maintenance window because the service operates during planned and emergency maintenance and they apply the daily address updates. Current operations allow an entire data centre offline without service being affected and continue to run with the same response times (less than 20 milliseconds).

Capacity and Availability – Availability is 99.9%. Postcode Anywhere is running at around 10% capacity and service, approx. 4.5 million unique web service requests each day. All the equipment is new and they have a rolling programme of updating all kit and infrastructure regularly. As part of accreditation to ISO 27001 they take monthly performance stats across the server estate to check for reduced performance and replacing kit where necessary.

Performance – Live performance can be viewed at http://services.postcodeanywhere.co.uk/

Response times

Capture + <1second Measured to the network boundary) Other services < 2 seconds (measured to the network boundary)

Out of office hours: 24 hour call answering and there’s a process for escalating urgent issues out-of-hours. They’re in the process of extending our support hours, which will probably see “normal” support until 11pm during the week.The Support team checks enquiries twice a day at weekend, usually at 10am and 5pm. Enquiries are also checked during evening, up to around 10pm.

In practice, because service is monitored at all times, if there was a problem with their technology, they know about it immediately and would act straight away. If there is a problem with the service they are alerted within 60 seconds with the nature of the problem.

Contacts

Account Manager: Rachael Mackwell rachaelm@postcodeanywhere.com Tel: +44 1905 888601

Technical Main contact: Steve Roberts stever@postcodeanywhere.com Tel: +44 1905 888631

Support Telephone: 0800 047 0493. Email: support@postcodeanywhere.com Emergency contact number: 01905 888699

Article 8 – Services and costs of Postcode Anywhere integration

Please note Postcode Anywhere charges per call. Tesco forecasts 8 million add address calls and 16 million store search calls. A call will not be re-made upon refreshing, if it is the same postcode or address the address is from the cache. For Auto-Suggest add address in checkout, the call is after the customer selects the validated address i.e. not counted as a call while typing and getting suggestions.

Article 9 – Error Messages

Please note no support procedures needed for error messages however monitoring would be important

Article 10 – Infrastructure changes

Please note Infrastructure design for Production is in progress

VDI IST2 UAT NFT

Article 11 – Design and Wireframes