Title

Service identification

Identifier

SWIM-SERV-040

Requirement

A service description shall include:

• the name of the service; and
• the version of the service.

Rationale

This requirement ensures that a specific version of a service from a service provider can be uniquely identified. It makes clear what the subject of the service description is. It enables the identification and referencing of the service being described.

Verification

Completeness: Verify that the 2 elements are included

Consistency: Not Applicable.

Correctness: Not Applicable. 

Examples/Notes

Example service identifications:

• “TargetOffBlockTimeSetting service, version 1.3.0”;
• “FlightManagement service, version 20.0”.

Note: To improve readability across service descriptions, it is best practice to apply following conventions for a service name:

• the name provides an indication of the purpose of the information service;
• be a maximum of five words in length;
• be represented using UpperCamelCase, and not use snake_case; and
• not end with the ‘service’ suffix.

Note: It is a best practice for the service version to be provided in numerical format (n.n[.n]).

Level of Implementation

Mandatory