Please note that this is work in progress currently only usable internally by the nhs mait team. The test suite has dependencies on internal artefacts not currently available in GitHub. If built by external users it will not pass many of the Junit tests.
TKW-x does not support the ITK 1 or ITK 2 standards. Any support issues for TKW should be raised with the ITK Accreditation team mailto:itk.accreditation@nhs.net .
NHS Digital Toolkit Workbench. Supersedes the ITK workbench and sunsets legacy protocols. Positioning for Micro Services/Distributed Execution environments.
Original TKW documentation is avalable at ITK Documentation
While detailed and accurate the documentation is somewhat old. This page summarises extensions and enhancements not covered in the original documentation. For definitive descritpions of the three domain specific languages the user should refer to the appropriate ANTLR Lexer and Parser syntaxes.
TKW-x adds support for FHIR and Restful services including:
- Migrations to ANTLR based grammars and syntaxes for the three domain specific languages
- Integration with Java HapiFhir libraries
- Access to Http headers and context paths
- Construction and testing of Java Web Tokens
- Multiple Http Verbs
- Support for MESH Transport
- Support for creation and consumption of 'on the wire' json payloads driven by http headers Content-type and Accept
- Support for compressed encodings (gzip and zip) and chunking
- Addition of two new modes httpInterceptor superseding simulator, and autotest
- Removal of support for SOAP based legacy transports (ITK1 and ITK2) Support for Synchronous and Asynchronous Spine Messaging is retained
- Removal of support for HL7v2 Pipe and Hat Messaging
- Implementation of HapiFhir Validator and many other validation enhancements
- Validation of Http headers and context paths
- Declaration of, and reference to, variables
- Capability to write bespoke test classes via the addition of unchecked tests
- ANTLR Lexer and ANTLR Parser
- Ability to add http headers to requests
- Construction of JWT authentication headers
- Ability to use a full set of Http methods
- Multiple named property file sources for substitution tags in addition to the existing default of system properties
- Expression classes allowing users to define their own java coded expressions
- Static http headers in responses
- Ability to return dynamic http headers based on substitution tags
- ANTLR Lexer and ANTLR Parser
- Not documented but present in the TKW5 release, allows the user to construct and send requests to provider systems and to validate and test the expected responses.
- Addition of Http header sets
- Addition of INCLUDE statments to assist with hand crafted test suites
- Substitution tags which are evaluated at test execution time
- ANTLR Lexer and ANTLR Parser