Working towards the next version of the SWIM Supporting Material

Page tree

Working towards the next version of the SWIM Supporting Material

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

Page Table of Content

Requirement

Title

Information definition responsible party

Identifier

SWIM-INFO-004

Requirement

An information definition shall be accompanied by statements on the party or parties responsible for the information definition including:
  • the name of the responsible organisation or person;
  • the contact information of the responsible party; and
  • the role played by the responsible party.

Rationale

This requirement supports the identification of the contact for an information definition.

Verification

Completeness

Examples/Notes

Example: Example roles are “author” and “point of contact”.

Example: Service provider information contained in a service description.

Level of Implementation

Mandatory

Guidance

This requirements ensures that the user of an information definition knows where to contact in order to discuss the information definition.

The specification caters for the fact that information definitions are often contained in service descriptions. The responsible party information can, in effect, be considered as being the same as for the service being described. This will avoid unnecessary duplication (copy and paste) of information.

Verification Support

Completeness

Check that:

  • The information definition contains the name of the responsible person or organisation.
  • The information definition contains contact information for the responsible party.
  • The information definition contains the role played by the responsible party.

Examples

The example below shows how the responsible party information can be embedded into an XML schema. It makes use the annotation element within the XML schema definition language.

A complete example is available at: complete example.

Example of SWIM-INFO-004
<xs:annotation>
 <xs:documentation>   
  <responsibleParty>     
   <responsiblePartyName>Donlon Airport Operator</responsiblePartyName>     
   <contactDetails>http://www.donlon-airport.com/swim/service-request</contactDetails>     
   <role>author</role>    
  </responsibleParty>   
 </xs:documentation>
</xs:annotation>



  • No labels