API issues for discussion

Dear all,

As you know Florian with me on updating the API document based on the conclusions from the F2F. There are many things to do, and we hope to have a draft with most of the changes implemented before the telco next week.

We also came across some issues which need discussion in the group:

1. Subtypes
The subtype argument in getMediaProperty (used to filter the results) refers to different attributes depending on the property, e.g. type, role. This is a similar problem as in the previous API draft, where MediaAnnotion .type and .value represented different things depending on the property. We see two possible solutions:
a) replace this argument with a pair (attribute,filterValue)
b) keep subtype, but define for each of the return type interfaces, which of the attributes is mapped to subtype (if any)

2. Subtype link/label
One conclusion at the F2F was to split attributes into link and label, depending on whether they are URIs or free text. This applies in many cases to type, role, etc. attributes of a property. When using subtype to filter the results of getMediaProperty, what does the filter value apply to?
- specify whether it applies to link or label (this needs the approach proposed in 1a)
- apply to both link and label and form the union of the results (assuming that we typically get matches only in link or label but not in both)

3. Normative JSON
We decided at the F2F to include in the API document a normative representation in JSON. The question is how to define this.
- There is JSON Schema [1], which is probably the most precise way of doing it. However, I'm not sure whether it is useful to add this (given that there is already the WebIDL) and confuses readers more than it helps.
- A complete set of examples (all attributes for all properties, might become lenghty).
- A complete MediaAnnotation example, and examples for each of the properties containing the specific attributes.

Best regards,
Werner

[1] http://json-schema.org/

-----------------------------------------------------------------------
  Werner Bailer
  Audiovisual Media Group
  
  DIGITAL - Institute of Information and Communication Technologies
  
  JOANNEUM RESEARCH Forschungsgesellschaft mbH
  Steyrergasse 17, A-8010 Graz, AUSTRIA
 
  phone:  +43-316-876-1218            personal fax: +43-316-876-91218             
  mobile: +43-699-1876-1218            general fax: +43-316-876-1191  
  web:    http://www.joanneum.at/digital        
  e-mail: mailto:werner.bailer@joanneum.at
-----------------------------------------------------------------------

Received on Tuesday, 1 March 2011 10:45:52 UTC