Working towards the next version of the SWIM Supporting Material
Working towards the next version of the SWIM Supporting Material
Requirement
Title | Service validation |
Identifier | SWIM-SERV-027 |
Requirement | A service description shall include a statement indicating
|
Rationale | This requirement ensures the service description contains sufficient statements on the testing done to enable the consumer to have confidence in the quality of the service. |
Verification | Completeness: Verify that the validation statement is included. Consistency: If validation has been performed, verify that the statement includes the method and the results of the validation. Correctness: Not Applicable. |
Examples/Notes | Example service validation statement:
|
Level of Implementation | Mandatory |
Guidance
No guidance provided.
Guidance for JSON service description
Schema
The guidance concerns JSON Schema v0.0.3 (see Schema releases).
Guidance
2 cases can be distinguished, depending on whether validation has been performed or not.
- case 1 - validation activities have been performed
- case 2 - no validation activity
Requirement: indicate whether a validation of the service has been performed; and if so, the method used; and the results achieved.
Rationale: User needs to know how the information service was validated in order to have confidence in the service.
Case 1 - Validation activities performed
Within field validation, itself within field serviceGeneralDescription, list one or more instance of ValidationOfService, describing the validation activities.
Optionally provide a validation report.
ValidationOfService - Mandatory (one or more)
An activity whereby a service is checked for conformance with the service objectives and requirements.
attribute name | description | type | guidance | rule |
---|---|---|---|---|
type | The validation method used | Select the validation method used for this validation activity. | Mandatory | |
description | The description of the service validation | string | Include a brief statement on the validation results, and if/how the potential consumers may obtain the validation evidence. Example: This information service has undergone extensive testing prior to deployment by the information service provider “LMN”, infrastructure service provider “ABC”, and regulator “XYZ” to ensure that specific QoS standards are met. Operational monitoring by the information service provider is in place and the information service continues to meet all QoS requirements. For more information on this organization’s validation policies please see <URL>. Specific information regarding the validation by the regulator is available in a validation report upon request. | Mandatory |
Validation report - Optional
Documents of type SERVICE_VALIDATION_REPORT may optionally be provided. See Guidance on serviceDocument.
Case 2 - No validation activity
Within field validation, itself within field serviceGeneralDescription, list one instance of ValidationOfService.
ValidationOfService - Mandatory (one)
An activity whereby a service is checked for conformance with the service objectives and requirements.
attribute name | description | type | guidance | rule |
---|---|---|---|---|
type | The validation method used | Do not select a value | No use | |
description | The description of the service validation | string | Make explicit that no validation has been performed. Eg "The service has not been validated yet." | Mandatory |
Example
"serviceGeneralDescription": { "validation": [ { "type": "SELF_VALIDATION", "description": "The service has been subject to intensive Verification and Validation, in alignment with our Quality Management System." }, { "type": "COLLABORATIVE_VALIDATION", "description": "The service has been subject to two validation sessions with service consumers. The validation report is available upon request." } ] }
"serviceGeneralDescription": { "validation": [ { "description": "The service has not been validated yet." } ] }
A complete JSON example is available in page JSON example - Donlon TOBT Setting service description.