Northgate - Sx3 Housing - Exchange process

Document data
Document Date: 17 January 2006 - revision 2
Keyfax version : 3.2.0.0 (or greater)
Software required: Northgate Sx3 Housing & Integrator
User skill requirements: NT administration. SQL Server DBA. IIS configuration. NT security policies. MSXML editing.
Author: Technical Services keyfax@touch-base.com

Keyfax exchange process with Northgate Sx3 Housing.

The Sx3 Housing applications have integration code to support the Keyfax web service. The basic principles utilised in the exchange process are as follows:

The numbered steps above are explained in more detail below:

  1. The Sx3 Housing application receives a repair request call from a tenant or caller.
  2. The Sx3 Housing application calls the Sx3 Integrator to create XML instructions to pass to Keyfax. This includes details of tenant, their property (asset), repair history and planned maintenance.
  3. The Sx3 Integrator adds a unique session ID, and wraps the XML data in a SOAP envelope and passes to the Keyfax web service.
  4. The Keyfax web service (KF31WS/KF32WS) receives the XML SOAP request and extracts the Keyfax request data.
  5. The Keyfax web service puts the Keyfax request data in the Keyfax 3.2 database, using the Sx3 unique session ID as the key.
  6. The Keyfax web service validates the XML data, and returns a status in the SOAP request response.
  7. The Sx3 Integrator processes the SOAP request response, and if OK, will pause the Sx3 application while the Keyfax is processed.
  8. The Sx3 Integrator loads an Internet Explorer window to the Keyfax 3.2 URL (ws_login.asp) to begin diagnostic script.
  9. The Keyfax application guides the user through a repair diagnostic.
  10. Keyfax completes and generates repair data to export, or the user cancels a script / exits the application.
  11. Keyfax builds a return XML packet, and includes the Keyfax status (i = Complete, 2=Cancelled, 3=Exited).
  12. Keyfax wraps the XML packet in a SOAP envelope and sent it to a Sx3 web service, where the Sx3 KEYFAX_DATA API will process the results.
  13. The Sx3 Integrator validates the XML packet, and returns a validation response to Keyfax for logging.
  14. The Sx3 Housing application receives focus back from the Integrator and if Works Order data is received; displays a new Works Order populated from Keyfax data.