...
Panel |
---|
borderColor | lightgrey |
---|
bgColor | whitesmoke |
---|
borderStyle | dashed |
---|
|
Title | Information definition scope | Identifier | SWIM-INFO-005 | Requirement | An information definition shall be accompanied by a textual description of the scope of the information it covers. | Rationale | This requirement supports decisions on whether an information definition is suitable for use in a particular situation. | Verification | Completeness | Examples/Notes | Example: The description provided by the Aeronautical Information Exchange Model is: “The objective of the Aeronautical Information Exchange Model (AIXM) is to enable the provision in digital format of the aeronautical information that is in the scope of Aeronautical Information Services (AIS).” Example: The service abstract contained in a service description. | Level of Implementation | Mandatory |
|
Explanations
This requirement imposes the need to describe the scope of the information covered by the information definition. It requires a brief narrative summary. It is clear that the requirement is not looking for “War and Peace”. This is generally implemented as free text in any implementation.
...
Completeness: Check that the textual description of the scope of the information covered is present in the information definition.
- Check that the scope clearly delineates what is covered and what is not.
Examples/Best Practice
Code Block |
---|
language | xml |
---|
title | Example of SWIM-INFO-005 |
---|
linenumbers | true |
---|
|
<xs:annotation>
<xs:appinfo>Information Definition</xs:appinfo>
<xs:documentation>
<generalInformation>
<scope>a really quite intriguing and self-referential schema</scope>
</generalInformation>
</xs:documentation>
</xs:annotation> |
...