Working towards the next version of the SWIM Supporting Material

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleRequirement [+]
Panel
borderColorlightgrey
bgColorwhitesmoke
borderStyledashed

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.

...

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.

...

Code Block
languagexml
titleExample of SWIM-INFO-004
linenumberstrue
<xs:annotation>
 <xs:documentation>   documentation>
  <responsibleParty>     <responsibleParty>
   <responsiblePartyName>Donlon<organisationName>Donlon Airport Operator</responsiblePartyName>     organisationName>
   <contactDetails>http://www.donlon-airport.com/swim/service-request</contactDetails>     <contactInfo>service@donlon</contactInfo>
   <role>author</role>    role>
  </responsibleParty>   responsibleParty>
 </xs:documentation>
</xs:annotation>

...