Ongoing discussions within the SWIM communities of interest
Artefacts to describe services
- WILSON Scott
This page covers work on:
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 published and Registry adapted accordingly) | 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
Status: Working Material