Working towards the next version of the SWIM Supporting Material
Working towards the next version of the SWIM Supporting Material
Role of the handbook
The Specification for SWIM Information Definition v1.0 sets out a number of requirements to be met by an information definition. It provides some basic examples to illustrate the requirements. However, the specification does not give exhaustive details on how to satisfy the requirements.
This handbook gives guidance to help information definition authors and AIRM conformance report authors to satisfy the requirements.
The guidance contained in the handbook promotes the creation of better information definitions. It will lead to greater harmonisation in the implementation of the specification.
Target audiences
- Information definition authors
- AIRM conformance report authors
- AIRM conformance report auditors and readers
Content structure
The handbook is organised into key topics.
Introduction to the specification. This introduces the purpose and context for the specification. It introduces semantic correspondence and semantic interoperability. It gives an overview of the requirements in the specification.
Guidance on the general requirements. This provides support in order to satisfy the general requirements contained in the specification.
Guidance on semantic correspondence. This provides support in order to satisfy the semantic correspondence requirements contained in the specification.
Resources. This provides examples, recommendations on how to satisfy the requirements in various formats and a verification checklist.
Full table of contents
- Introduction to the information definition specification
- Guidance on the general requirements
- SWIM-INFO-001 Need for information definitions
- SWIM-INFO-002 Information definition language
- SWIM-INFO-003 Information definition identification
- SWIM-INFO-004 Information definition responsible party
- SWIM-INFO-005 Information definition scope
- SWIM-INFO-006 Information definition namespace
- SWIM-INFO-007 Information definition concepts
- SWIM-INFO-008 Unique identifiers for concepts
- SWIM-INFO-009 Preservation of meaning
- SWIM-INFO-010 Principles for definitions for concepts
- SWIM-INFO-011 Semantics of metadata
- SWIM-INFO-012 Use of data types
- Guidance on semantic correspondence
- SWIM-INFO-013 Establish semantic correspondence
- SWIM-INFO-014 Forms of semantic correspondence
- SWIM-INFO-015 Out-of-scope or no correspondence
- SWIM-INFO-016 Mapping of information concepts
- SWIM-INFO-017 Mapping of data concepts
- SWIM-INFO-018 Additional traces to clarify the mapping
- SWIM-INFO-019 Use of the AIRM's unique identifiers in traces
- Resources for information definitions
- FAQ - Semantic correspondence
It is an evolution of the agreed and published content found on the SWIM Reference website.
If you are looking for the "official" versions of the supporting material, please go to the SWIM Reference website.
The SWIM Information Definition Handbook is advisory in nature. It is created and maintained by a community of interest and evolves over times as the community identifies new examples and good practices. To become a member of the community, please send an email to [email protected].
The handbook includes the requirements found in the Specification for SWIM Information Definition. However, it does not replace the specification. Users of the handbook are advised to download the specification using the quick links above.
The specification has a dependency on the ATM Information Reference Model (AIRM). This can be downloaded, or viewed online using the quick links above.