Implementation of a default print service for case data.
Express application that allows an authorised user to retrieve case data in a printable format.
The output comprises a summary, with some key information such as Case Number and user requesting the printout, followed by a dump of the case details in JSON format.
- Node.js version >= 18.17.0
The following environment variables are required:
| Name | Default | Description |
|---|---|---|
| IDAM_BASE_URL | - | Base URL for IdAM's User API service (idam-app). http:https://localhost:4501 for the dockerised local instance or tunnelled dev instance. |
| IDAM_S2S_URL | - | Base URL for IdAM's S2S API service (service-auth-provider). http:https://localhost:4502 for the dockerised local instance or tunnelled dev instance. |
| IDAM_PRINT_SERVICE_KEY | - | Print Service's IdAM S2S micro-service secret key. This must match the IdAM instance it's being run against. |
| CASE_DATA_STORE_URL | - | Base URL for the Case Data Store service. http:https://localhost:4452 for the dockerised local instance. |
| APPINSIGHTS_INSTRUMENTATIONKEY | - | Secret for Microsoft Insights logging, can be a dummy string in local. |
The project uses npm. To build it, execute the following command:
npm installStart the application by executing the following command:
npm startNote: You can also use yarn in place of npm, in both commands above.
The application uses HTTP, port 3100 by default.
Access to any case data requires an authorised user that is already authenticated via IdAM (and thus, has been granted a Java Web Token (JWT) for the session).
Point your browser at http:https://localhost:3100/jurisdictions/{jid}/case-types/{ctid}/cases/{cid}?jwt={token}, where:
{jid}is the Jurisdiction ID, for example,PROBATE{ctid}is the Case Type ID, for example,GrantOfRepresentation{cid}is the Case ID, for example,1111222233334444{token}is the user's JWT, which is already stored as a browser cookie for an authenticated user
Alternatively, you can mimic the result of the OAuth 2.0 "lite" authentication flow, by omitting the jwt query parameter from the URL above, and setting the JWT as a cookie instead:
- Open your browser's Developer Tools window (typically by pressing F12).
- In the console, enter the JavaScript command:
document.cookie="accessToken={token}"where{token}is the user's JWT.
These can be used to render output using external Nunjucks templates. Routes should be added to the src/main/routes directory.
All routes should ensure the Case Print Service returns the correct character encoding (character set) in the HTTP response headers. It should be UTF-8. This is done by calling the following on the response object (res in this case):
res.set("charset", "utf-8");
This must be done prior to a final call on the response, such as res.send(...).
In addition, if the Nunjucks template to be rendered contains any "special" characters, such as currency symbols or "curly" versions of quote marks, then the template should be edited and encoded as UTF-8.
If, for whatever reason, this is not possible then these characters must be replaced with the regular ASCII versions where appropriate (e.g. straight quote marks), or (ideally) the corresponding HTML entities (e.g. £, ‘, ’).
The functional tests are located in aat folder. The tests are written using
befta-fw library. To find out more about BEFTA Framework, see the repository and its README here.
The tests can be run using:
$ yarn test:functional
or to run using gradle directly:
$ cd ./aat/
$ ./gradlew functional