The specification contains a conformity checklist. It sets out whether conformance with the requirement is "mandatory", "recommended" or "mandatory when the conditions apply". The organisation or person responsible for the service description is expected to complete the checklist. It is then possible to attach the checklist to the service description as evidence of conformance.
To conform with a requirement, the entire requirement has to be satisfied. This includes the need to perform verification. Each requirement contains a statement on the type of verification that is expected (i.e. "completeness", "correctness", "consistency"). The checklist below elaborates on these statements e.g. by spelling out the elements when the requirement states "Verify that the 3 elements are included".
The checklist below is a summary of all of the verification details for easy reference. It is possible to use the table within your own processes.
Requirement | Verification type | Check that: | Level of implementation | Notes |
---|---|---|---|---|
SWIM-SERV-010 Service description coverage | Correctness | [ ] The service description describes one and only one service. | Mandatory | |
SWIM-SERV-020 Service description language | Correctness | [ ] The textual descriptions in the service description are correct British English. | Mandatory | |
SWIM-SERV-030 Service description identification | Completeness | [ ] The service description has a title. [ ] The service description has an edition. [ ] The service description has a reference date. | Mandatory | |
SWIM-SERV-040 Service identification | Completeness | [ ] The service description includes a name for the service. [ ] The service description includes a version for the service. | Mandatory | |
SWIM-SERV-050 Service abstract | Completeness | [ ] The service description includes a short textual description summarising the service. | Mandatory | |
SWIM-SERV-060 Service provider | Completeness | [ ] The service description includes the service provider's name. [ ] The service description includes the service provider's abbreviated name (if applicable). [ ] The service description includes the description of the organisation responsible for the service. | Mandatory | |
SWIM-SERV-070 Provider point of contact | Correctness | [ ] The name of the provider point of contact is correct. [ ] The contact information of the provider point of contact is correct. [ ] The role of the provider point of contact is correct. | Recommended | |
SWIM-SERV-080 Support availability | Correctness | [ ] The name of the support point of contact is correct. [ ] The contact information of the support point of contact is correct. [ ] The role of the support point of contact is correct. | Recommended | |
SWIM-SERV-090 Geographical extent of information | Completeness | [ ] The service description includes information about the geographical coverage of the exchanged information service payload. | Mandatory | |
SWIM-SERV-100 Service categories | Completeness | [ ] The service description includes the service categories to which the service belongs. [ ] The service description includes, if applicable, the reference the service categorisation schemes used. | Mandatory | |
SWIM-SERV-110 Service lifecycle information | Completeness | [ ] The service description includes information on the lifecycle stage that the service is currently in. [ ] The service description includes, if applicable, qualifying dates for the lifecycle stage. | Mandatory | |
SWIM-SERV-120 Service standard reference | Completeness | [ ] The service description includes a reference to the service standard to which the service adheres. [ ] The service description includes a statement on any implemented options of the service standard. [ ] The service description includes a statement on any deviation from or addition to the service standard. | Mandatory (Conditional) | |
Consistency | [ ] If the service adheres to a service standard, verify that the reference to the service standard is included. | |||
SWIM-SERV-130 Operational environment | Completeness | [ ] The service description includes or refers to information about the operational environment. | Mandatory | |
SWIM-SERV-140 Service functions | Completeness | [ ] The service description includes or refers to information about the functions offered by the service in support of its capabilities. [ ] The service description includes or refers to information about their associated real-world effects. | Mandatory | |
Consistency | [ ] The functions and real-world effects are consistent with the operational needs. | |||
SWIM-SERV-150 Service access and use conditions | Completeness | [ ] The service description includes or refers to information about the legal constraints which apply to accessing and using the service. [ ] The service description includes or refers to information about the service policies which apply to accessing and using the service. [ ] The service description includes or refers to information about the service consumption constraints which apply to accessing and using the service. | ||
SWIM-SERV-160 Security constraints | ||||
SWIM-SERV-170 Additional technical information for the service consumer | ||||
SWIM-SERV-180 Quality of service | ||||
SWIM-SERV-190 Source of information | ||||
SWIM-SERV-200 Service validation information | ||||
SWIM-SERV-210 Application message exchange pattern | ||||
SWIM-SERV-220 Service behaviour | ||||
SWIM-SERV-230 Service monitoring | ||||
SWIM-SERV-240 Service interfaces | ||||
SWIM-SERV-250 SWIM TI Profile and interface bindings | ||||
SWIM-SERV-260 Service interface protocols and data format | ||||
SWIM-SERV-270 Service operations | ||||
SWIM-SERV-280 Service messages | ||||
SWIM-SERV-290 Information definition - minimum | ||||
SWIM-SERV-300 Information definition - extended | ||||
SWIM-SERV-310 Filter encoding | ||||
SWIM-SERV-320 Machine-readable service interface definition | ||||
SWIM-SERV-330 Model view | ||||
SWIM-SERV-340 Examples of code | ||||
SWIM-SERV-350 Abbreviations and acronyms |