Version
This page concerns v2.0 of the Specification. Supporting material on v1.0 is SWIM-SERV-008 Service provider
Requirement
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:
|
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:
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:
|
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 information | URL: http://www.donlon-airport.com/swim/service-request | ||
| role | To request access to the service. |
The following example shows an extract of the content of a JSON file that conforms to the Service Metadata Schemas
"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.