SWIM Supporting Material
SWIM-SERV-030 Service description identification
Requirement
Title | Service description identification |
Identifier | SWIM-SERV-030 |
Requirement | A service description shall include:
|
Rationale | This requirement supports the identification and citation of a service description. |
Verification | Completeness: Verify that the 3 elements are included. Consistency: Not Applicable. Correctness: Not Applicable. |
Examples/Notes | Example service description identification:
Note: The edition of the service description is not to be confused with the version of the service. A service description can evolve to a new edition while still describing the same service version. |
Level of Implementation | Mandatory |
Guidance
The ability to provide an exact citation, a standardised reference to the service description, is very basic.
The ISO 8601 format can be used for the reference date i.e. "yyyy-mm-dd"
Verification Support
Completeness | Check that: [ ] The service description has a title. [ ] The service description has an edition. [ ] The service description has a reference date. |
Examples
The following example shows the content as a table.
service description identification | title | Donlon TOBT Setting Service Description |
---|---|---|
edition | 0.93i | |
reference date | 2020-06-02 |
The following example shows an extract of the content of a JSON file that conforms to the Service Metadata Schema
"descriptionIdentification": { "title": "Donlon TOBT Setting Service Description", "edition": "0.93i", "referenceDate": "2020-06-02" }
Complete examples are available at Example service description.
Status: Living Material