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.

<xs:annotation>
 <xs:documentation>
  <responsibleParty>
   <organisationName>Donlon Airport Operator</organisationName>
   <contactInfo>[email protected]</contactInfo>
   <role>author</role>
  </responsibleParty>
 </xs:documentation>
</xs:annotation>