Maintenance Guide

The following assets need to be updated periodically on nias2.

Each Release

• The unit tests for napval need to be rerun and potentially updated: https://github.com/nsip/nias2/blob/master/app/napval/validator_test.go, https://github.com/nsip/nias2/tree/master/unit_test_files

• The regression tests for naprrql need to be rerun and potentially updated: https://github.com/nsip/nias2/blob/master/app/naprrql/regression_test.sh, https://github.com/nsip/nias2/tree/master/app/naprrql/test/out, https://github.com/nsip/nias2/blob/master/app/naprrql/sif.minimal.xml.zip

• The latest version of the Australian Schools List needs to be downloaded as CSV from https://asl.acara.edu.au, and updated to https://github.com/nsip/nias2/blob/master/app/napval/schoolslist/asl_schools.csv

• Release notes need to list what functionality has changed

• The relevant documentation and user guides need to be updated to reference any new functionality, including the presence of new reports:

  • https://github.com/nsip/nias2/tree/master/app/nap-writing-print/NIASWritingExtractUserGuide_v09.pdf (on NSIP Dropbox: /Dropbox (NSIP)/NSIP/12. Products/naprr)

  • https://github.com/nsip/nias2/blob/master/app/naprrql/NIAS%20and%20NAPRR%20Install%20and%20User%20Guide%20v11.pdf (on NSIP Dropbox: /Dropbox (NSIP)/NSIP/12. Products/naprr)

SIF-AU updates

• Any new country codes and language codes need to be added to the JSON Schema for registration data: https://github.com/nsip/registration-data-set/blob/master/core.json

• Any SIF-AU updates that impact on StudentPersonal need to be coded into napval

• Any SIF-AU updates that impact on NAP objects need to be coded into naprrql

Yearly

• The year needs to be updated in app/napval/napval.toml

• The unit tests for napval, unit_test_files/*.csv, need to have their date of birth years updated, so that the error reported is not a birthdate error. This is fiddly: often the year needs to be advanced by 2 years, not 1, to stay within range.