Skip to end of banner
Go to start of banner

SMS data exchange set up and configuration

Skip to end of metadata
  • Created by Former user, last modified by Former user on Feb 25, 2017
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Current »

The SMS data exchange project allows data to be exchanged between school management systems (SMS), such as Synergetic, and the New Zealand Ministry of Education (NZ MOE).

Web Service
The web service is provided by the NZ MOE. To locate and connect to the web service, the following items are required:

  • WSS Wrapper (Wrapper)
  • internet Connection between the Wrapper and the web service
  • web address of the web service (expressed as a Web Service Definition Language (WSDL) URL with parameters)
  • correct certificates and password.

Wrapper
For Electronic roll returns (eReturns), the wrapper:

  • accepts the MOE file from eReturns
  • wraps (encrypts) the MOE file
  • forwards this encrypted MOE file to the NZ MOE's web service.

When Managing New Zealand student NSNs and identity details (Roll returns), the wrapper:

  • accepts data from the Get/Check NSN function
  • wraps (encrypts) the data
  • forwards this encrypted data to the NZ MOE's web service.

Optionally, the Wrapper can check the status of connectivity to the web service.

Installation of WSS Wrapper
Before commencing you must first install the Wrapper application on a computer. These instructions assume that you are installing the Wrapper on the same machine that the Synergetic database runs on.
Install the wrapper as distributed with Synergetic:
WssWrapper_windows_1.exe
This will install the application as a service (WssWrapper_Java5) which is configured to auto start. See Checking, disabling and restarting Wrapper.
In the folder where the Wrapper is installed, there is a simple application testInstall.exe which you can run to test if the Wrapper can communicate with the Web Service.
Possible causes for the test application to fail to connect to the web service:

  • No internet connection is available. Please check that you are properly connected to the Internet.
  • Firewall. Please make sure that the connection between the Wrapper and the web service is clear and not restricted. By default, the Wrapper runs at port 7123.

Note: It is also important to note that the Wrapper is not using standard HTML content, even though it's communicating through HTTP protocol. Therefore it is advisable to configure the firewall to allow these contents as well.

  • Incorrect WSDL URL. The Wrapper will not be able to locate the web service if the WSDL is incorrect.
  • Incorrect certificates (please see below).

Wrapper certificates
For new installations, the Wrapper comes with:

  • .keystore factory default certificate
  • dextest.xml is the XML test file to test the installation.

From time to time, the NZ MOE issues new certificates. See Renewing certificates for eReturns.

  • No labels