Working towards the next version of the SWIM Supporting Material

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleRequirement [+]
Panel
borderColorlightgrey
bgColorwhitesmoke
borderStyledashed

Title

Establish semantic correspondence

Identifier

SWIM-INFO-013

Requirement

An information definition shall document a semantic correspondence for each of its concepts.

Rationale

Documentation of semantic correspondence is the evidence that an information definition is an AIRM conformant information definition.

Verification

Completeness

Examples/Notes

Note: This requirement covers information concepts and data concepts.

Note: This requirement allows an information definition to:

  • be accompanied by a standalone resource containing the statements of semantic correspondence; or
  • have statements of semantic correspondence embedded in it; or 
  • be accompanied by a reference to an already existing set of semantic correspondences.

Note: The forms that a semantic correspondence can take are given in SWIM-INFO-014.

Note: It is important to ensure that the syntax used for mappings is self-explaining or appropriately explained. To this end, extra information can accompany the information definition in order to ensure that the mappings can be understood without having to read external documentation or make assumptions on how the mappings are technically and procedurally implemented.

Example: A statement that the “container’s traces” are considered as part of the concept mappings (as discussed in SWIM-INFO-018).

Level of Implementation

Mandatory

Guidance

Documenting semantic correspondences

...