A service description shall describe the elements of the exchanged information including:
- the name of the element;
- the definition of the element;
- the cardinality applicable to the element, including whether the element is optional, conditional or mandatory in the exchange;
- constraints applicable to the element, such as:
- value ranges;
- special values;
- character set restrictions;
- the semantic correspondence of the element with the AIRM; and
- the structure and relevant relationships between the elements.
This requirement ensures that the precise meaning of the exchanged information is shared by all parties of the information exchange.
Completeness: Verify that the service description describes all elements of the exchanged information and that the required details are provided.
Consistency: Verify that the elements are consistent with each other and with the AIRM concepts used in the semantic correspondence.
Correctness: Not Applicable.
Note: The service description must describe all elements of the exchanged information at all levels, down from the service operation parameters to attributes and data types.
Note: It is best practice to base the information definition on the requirements found in the EUROCONTROL Specification for SWIM Information Definition [RD 2], ensuring that it contains the extra details required by this requirement.
Note: The information definition can be provided by reference, for example when using an AIRM conformant standardised information exchange models, such as Aeronautical Information Exchange Model (AIXM) [RD 15] and ICAO Meteorological Information Exchange Model (IWXXM) [RD 16].
Level of Implementation
This requirements sets out the minimum detail needed to describe each element of the information that is exchanged. For example, if the exchange involves information about "aerodromes" the "aerodrome" element should be described. This means the element should be given a name, a description, etc based on the bulleted list in the requirement.
SWIM-SERV-023 AIRM conformance requires that the service description contains a statement on AIRM conformance. This requirement affects SWIM-SERV-022 - the description of the elements of the exchanged information should follow the requirements in the SWIM Information Definition Specification. Of particular relevance here are:
However, all of the requirements should be followed.
The semantic correspondence of the element with the AIRM is established following the requirements found in the Guidance on semantic correspondence section of the SWIM Information Definition Handbook.
See the Information Definition section within the Donlon TOBT Setting Service Description.