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.

Frequently Asked Questions about the implementation of the SWIM Service Description specification. Including direct link to the supporting material when applicable. 

(green star) Answers to questions from (former) implementers may help newcomers. 

Note
titlework in progress

The list contains the received questions. We are not yet at a stage of frequently asked questions.

Many questions have not received an answer yet.

When more questions are available, re-organisation might be needed.

Table of Contents
maxLevel2

Questions from workshop

Expand
titleHow much detail to include for the filtering syntax?

Question (from workshop)

"SWIM-SERV-024 regarding the filter an syntax, into what level of detail it should be described here? For instance regarding OGC Webservices with Standard Filter, should the exact syntax here explained?"

"Or would it be sufficient to reference to the OGC Filter Standard or to an external Document?"

Answer

The service consumer, in order to make a good use of the service, needs to access the filtering syntax with all relevant details. xxx

Supporting Material

Note
titlework in progress

Answer Question

Make this available as sup mat for req SWIM-SERV-024.

Expand
titleWhere can I include product meta data?
Question (from workshop)

"Where can I reference product metadata to the service,assumed I have ISO metadata desribing a certain product that is delivered by this service? Maybe in SWIM-SERV-006,SWIM-SERV-007 as serviceProduct?"

Answer

Assumption: it's metadata about the product, not about the service (service metadata would probably go to SWIM-SERV-009 Service categories).

Assumption: it's product metadata that is defined statically, valid for all products delivred by the service (metadata defined dynamically for available products would probably be provided by a service operation, and would probably allow selection / searching).

xxx (Q: how much data does this represent?)

Supporting Material

Note
titlework in progress

Answer question

Expand
titleIs it allowed to reference a UI tool within the Service Description?

Question (from workshop)

"Assumed I have a service in form of a restful WebAPI, is it allowed to reference an UI tool within the Service Description and if so under which point/requirement?"

Answer

Supporting Material

Note
titlework in progress

Answer question

Expand
titleWhat is the link established with SWIM Governance IP?

Question (from workshop)

A close link to SWIM Governance needs to be established as a lot of the identified support materiel candidates are allready adressed there (operations issue, categories, ..)

Answer

Supporting Material

Note
titlework in progress

Answer question

Expand
titleWhere can I find the workshop presentations?

Question (from workshop)

Is it possible to download the slides that have been (and/or will be) presented yesterday and today?

Answer

The material presented during the EUROCONTROL SWIM Standards Evolution Workshop can be found here: http://www.eurocontrol.int/events/eurocontrol-swim-standards-evolution-workshop

Other questions

Expand
titleHow far to include technical / technological details?

Question

Answer

Although the Service Description specification is technology independent, a Service Description needs to contain technical and technological specific details of the implemented service. In order to allow the service consumer to build a consuming client, all required details need to be provided somehow. 

Supporting Material

Note
titlework in progress

refine

Expand
titleWhere can I find a video of a consumer request and reply?

Question

In terms of the SWIM consumer example, if possible I would love to see a video recording of a consumer configuring a request for an existing SWIM service, then pulling it, then 'seeing' the data in some post processed manner. This is more or less what Eik Kristansen did at the SWIM deployment manager meeting.

Answer

Supporting Material

Note
titlework in progress

Would be nice to provide related material.

Expand
titleHow will the consumer address competition between similar services?

Question

I have a query about competition between similar services that has been raised... e.g. UK Met Office has a precipitation service in the SWIM registry. Eurpoa Met Office also has a precipitation service in the SWIM registry. How will the consumer address this?

Answer

Supporting Material

Note
titlework in progress

Provide answer

Expand
titleDo old services require changes to be aligned with the AIRM?

Question

I have a hypothetical question over the usage of terminology in the actual data payload that the consumer will ingest. Imagine I have a data service that I wrote and launched '20' years ago. In the data content there is numerical data for temperatures and times for a point in space, but there is also the text "Aerodrome".

As the service was written '20' years ago there is a strong possibility that the meaning of the word "Aerodrome" in the data payload does not exactly fit the meaning of the word "Aerodrome" as laid out according to the AIRM definition. Under what circumstances would this payload be valid - or would it be advised to re-write the payload from scratch so that the definitions are always common in both the payload and service description?

I suppose what I am asking is 'do you see more SWIM services being developed with a pre-understanding of SWIM  from scratch' in favour of taking existing operational services and adding SWIM descriptions to them?

Answer - elements of answers (to be checked)

Interesting hypothetical question. Below some elements of  answers (from my point of view)

  • AIRM is not trying to take distance from the past and introduce a new way to name things. It’s just formalising it, and aligning to ICAO when possible. So chances are that if the word was chosen carefully in the past, it’s still the same word used in AIRM.
  • Being old or new, words in a system may take distance from the words in AIRM. That’s perfectly valid. And that’s where the “AIRM trace” comes into play: you make clear how your words map to the AIRM ones, so everyone may know precisely what you mean by “Aerodrome”.
  • In summary, I would not advice to rewrite payload just for the sake of being closer to AIRM. However, if you start something from scratch, it would make sense to genuinely use AIRM wording. (Note technical adaptation might however be necessary for aligning to Yellow Profile.)

Supporting Material

Note
titlework in progress

check answer

Table of Contents
maxLevel2


Questions



Question

What is the role of the registry?

Will the registry play a role in assessing the quality of services.

Answer

The Registry is where service providers publish their services and where service consumers discover services. The service description is expected to play a major role in this.

The Registry will most probably make a syntax check against the service description XML Schema.

Registries will be interoperable – there can be more than one registry.

Supporting Material

Check and refine answer
Expand
titleHow is conformance to the specifciation assessed?

Question

The conformance checking for our service was by self-assessment. Is this correct? Is there a role for governance? What about supervisory authorities.

Answer

The conformance to the specifications is done by self-assessment.

National supervisory authorities may be involved. EUROCONTROL is not involved.

Supporting Material

Expand
titleWhat is the role of the Registry?
Note
titlework in progress


More

Children Display