RE : API issues for discussion

Dear Werner,

I had a look at the JSON schema.

Actually the situation is such that although I am not entirely convinced with the capacity for JSON to do all that XML can do, it may work for a structure as simple as MAWG's ma-ont.

But because the structure is so simple maybe it is not worth the effort and only a complete instance expressed in JSON is sufficent and not too bulky.

Regards,

Jean-Pierre


________________________________________
De : public-media-annotation-request@w3.org [public-media-annotation-request@w3.org] de la part de Bailer, Werner [werner.bailer@joanneum.at]
Date d'envoi : mardi, 1. mars 2011 11:13
À : public-media-annotation@w3.org
Objet : 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
-----------------------------------------------------------------------
-----------------------------------------
**************************************************
This email and any files transmitted with it 
are confidential and intended solely for the 
use of the individual or entity to whom they
are addressed. 
If you have received this email in error, 
please notify the system manager.
This footnote also confirms that this email 
message has been swept by the mailgateway
**************************************************

Received on Tuesday, 1 March 2011 12:57:09 UTC