Versions Compared

Version Old Version 8 New Version 9
Changes made by

WILSON Scott

WILSON Scott

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
titlePage Table of Content

Table of Contents

Info
titleVersion

This page concerns v2.0 of the Specification. Supporting material on v1.0 is SWIM-SERV-008 Service provider

Requirement

Panel
borderColorlightgrey
bgColorwhitesmoke
borderStyledashed

Title

Provider point of contact

Identifier

SWIM-SERV-070

Requirement

A service description should include information about where additional information on the service can be obtained, including:

  • name;
  • contact information; and
  • role.

Rationale

This provides the service consumer with a link to be used if more information on the service is needed and details on where to require access.

Point of contact allows getting additional information regarding the service.

Verification

Completeness: Not Applicable.

Consistency: Not Applicable.

Correctness: If provided, check that the information is correct.

Examples/Notes

Note: The additional information could be more technical information on the service.

It is best practice to provide a link to where the information is found.

Example contact information:

  • email address;
  • postal address;
  • phone number;
  • URL.

Note: The point of contact’s name is usually that of a role acting as a single point of contact rather than the name of a specific person.

Example:

  • “Customer Relations, to request access to the service, http://www.donlon-airport.com/swim/service-request”;

Level of Implementation

Recommended

Guidance

Verification Support

Correctness

Check that:

[  ] The name of the provider point of contact is correct.

[  ] The contact information of the provider point of contact is correct.

[  ] The role of the provider point of contact is correct.

Examples

The following example shows the content as a table.

service provider

provider point of contact

name

Customer Relations

contact informationURL: http://www.donlon-airport.com/swim/service-request
roleTo request access to the service.

The following example shows an extract of the content of a JSON file that conforms to the Service Metadata SchemaSchemas

Code Block
languagejs
titleExample of SWIM-SERV-070 using Service Metadata Schema
tbd"serviceProvider": {
...
 "pointOfContact": [{
  "name": "Customer Relations",
  "contactInformation": [{
   "type": "URL",
   "address": "http://www.donlon-airport.com/swim/service-request"
  }],
 "role": "To request access to the service."
 }]
}

Complete examples are available at Example service description.