Task Status
This page is part of the ongoing SWIM communities of interest discussions. The content is working material. It should not be treated as final as it is still subject to review, comment and change.
Glossary
Service definitions (and other service related artefacts) are defined in the SWIM reference glossary.
| Term | Definition |
|---|---|
| Service definition | A document, issued by a community of interest, used to harmonize service implementations. |
| Service description | Information needed in order to use, or consider using, a service. |
| Service overview | A set of information service metadata intended to promote service discovery and an initial evaluation of the information service characteristics. |
| Formal arrangement | An agreement, formally established between the Service Provider and the Service Consumer, to define the conditions for the provision of a Service. |
Disambiguation
It is important to disambiguate the terms as they share some commonalities in purpose and scope. It is possible to represent the commonalities and differences as follows:
| term | purpose | produced by | used by | concerns | contains | can be registered | applicable requirements |
|---|---|---|---|---|---|---|---|
| Service definition | harmonize service implementations | a community of interest (collaboratively) | service provider | type of service | service metadata | yes | SSCONE Confluence Page |
| Service description | in order to use a service consider using a service | service provider | service consumer | service instance | service metadata | yes | EUROCONTROL Service Description Specification |
| Service overview | initial evaluation of the information service characteristics | service provider | service consumer | service instance | service metadata | yes (once ready) | ICAO SWIM PANS / Manual |
| Formal arrangement | contract when using a service | agreement of service provider and service consumer | specific service consumer (and service provider) | service instance | agreements | no | Negotiation, Regulation, Specifications... |
Note: Service overviews "promote service discovery" according to the definition. However, this ability is not confined to service overviews. The SWIM Registry promotes service discovery.
Overview of artefacts landscape
