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.
...
[ ] The service description has a title.
[ ] The service description has an edition.
[ ] The service description has a reference date.
...
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 a name for information on the lifecycle stage that the service is currently in. [ ] The service description includes a version , if applicable, qualifying dates for the servicelifecycle stage. | Mandatory | ||||||||||
| SWIM-SERV- | 050120 Service | abstractstandard reference | Completeness | [ ] The service description includes a short textual description summarising the service. | Mandatory | SWIM-SERV-060 Service provider | Completeness reference to the service standard to which the service adheres. [ ] The service description includes a statement on any implemented options of the service provider's namestandard. [ ] The service description includes the service provider's abbreviated name (if applicable).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 the description of the organisation responsible for the serviceor refers to information about the operational environment. | Mandatory | ||||||||||
| SWIM-SERV- | 070 Provider point of contactCorrectness140 Service functions | Completeness | [ ] The name of the provider point of contact is correct.[ ] The contact information of the provider point of contact is correctservice description includes or refers to information about the functions offered by the service in support of its capabilities. [ ] 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.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 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 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 geographical coverage of the exchanged information service payloadservice consumption constraints which apply to accessing and using the service. | Mandatory | |||||||
| SWIM-SERV-100 Service categories160 Security constraints | Completeness | [ ] The service description includes the service categories to which the service belongs.or refers to information about the security constraints which apply to accessing and using the service. | Mandatory | ||||||||||
| SWIM-SERV-170 Additional technical information for the service consumer | Consistency | [ ] The service description includes, if applicable, the reference the service categorisation schemes usedinformation about the technical constraints corresponds to the described service. | Mandatory (Conditional) | ||||||||||
| SWIM-SERV-110 Service lifecycle information180 Quality of service | Completeness | [ ] The service description includes or refers to information on the lifecycle stage that the service is currently inabout the minimum quality of service offered with regards to performance. [ ] The service description includes or refers to information about the minimum quality of service offered with regards to reliability. [ ] The service description includes , if applicable, qualifying dates for the lifecycle stageor refers to information about the minimum quality of service offered with regards to security. | Mandatory | ||||||||||
| SWIM-SERV- | 120 Service standard referenceCompleteness190 Source of information | Correctness | [ ] The service description includes a reference to the service standard to which the service adheres source(s) of the information provided is correct. a statement on any implemented options of the service standard.[ ] The service description includes details concerning any modifications that have been applied to the information are correct. | Recommended | |||||||||
| SWIM-SERV-200 Service validation information | Completeness | [ ] The service description includes a statement on any deviation from or addition to the service standardor refers to information about the validation that has occurred. | Mandatory (Conditional) | ||||||||||
| Consistency | [ ] If the service adheres to a service standard, verify that the reference to the service standard is includedvalidation has been performed, that the statement includes the method and the results of the validation. | ||||||||||||
| SWIM-SERV- | 130 Operational environment210 Application message exchange pattern | Completeness | [ ] The service description includes or refers to information about the operational environmentthe application message exchange pattern(s) used by the service. | Mandatory | |||||||||
| Consistency | [ ] The information is consistent with the selected service interface binding. | ||||||||||||
| SWIM-SERV-140 220 Service functionsbehaviour | Completeness | [ ] The service description includes or refers to information about the functions offered by typical behaviour of the service in support of its capabilities. [ ] The service description includes or refers to information about their associated real-world effectserror handling during the typical behaviour of the service. | Mandatory | ||||||||||
| Consistency | [ ] The functions and real-world effects names of the interfaces, service operations and exchanged information are consistent with the operational needsinterface definitions. | ||||||||||||
| SWIM-SERV-150 Service access and use conditions230 Service monitoring | Completeness | [ ] The service description includes or refers to information about the legal constraints which apply to accessing and using the service.that describe how to use the service monitoring mechanism. | Mandatory (Conditional) | ||||||||||
| SWIM-SERV-240 Service interfaces | Completeness | [ ] The service description includes or refers to information about the service policies which apply to accessing and using the serviceexposed service interfaces. [ ] The service description includes or refers to The information about the service consumption constraints which apply to accessing and using exposed service interfaces includes the name of the service interface. | 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 [ ] The information about the exposed service interfaces includes a textual description of the service interface including its purpose. [ ] The information about the exposed service interfaces includes an indication that the interface is a provider side interface or a consumer side interface. | Mandatory | |
| Consistency | [ ] For each provider side interface, verify that the network address is provided. | ||||||||||||
| 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 |
...