Tagging API

fulfills use case: UseCaseTagging

implemented in gnowsis-server and the PIMO.

The code of the tagging-api is here: source:branches/gnowsis0.9/gnowsis-server/src/java/org/gnowsis/pimo/TaggingApi.java

Using Tagging API from other applications via HTTP

To use the TagingAPI from Mozilla Firefox and Thunderbird, tags are transmitted as comma separated list via httprequest.

Request from Mozilla Thunderbird:

• get me tags that contain this string X. Things have to have X in label, altLabel, wikiname or wikitext
  • string x
• result:
  • list of:tag-uri + tag + class of tag

• get me tags fitting to this email:
  • message-id
  • subject
  • body
• result:
  • list of:tag-uri + tag + class of tag

• get me the tags that are already associated to this email(s) (input either one e-mail or many) (has to be fast-as-hell). Used to augment the display of large lists of emails, for example the inbox.
  • message-id
• result:
  • list of:tag-uri + tag + class of tag

• tag this e-mail using that tag:
  • message-id
  • tag-uri
  • operation: add tag/remove tag
• result:
  • ok/error

• tag this e-mail using that tag-name:
  • message-id
  • tag-name (the label)
  • operation: add tag/remove tag
• result:
  • has to create a NEW TAG if tag-name does not exists, creates a URI for the tag.
  • return new tag-uri + ok/error

To identificate an email, we should use the Message-ID and not the mail-uri, because if an email is moved to another folder we will loss the relation of the tags to this mail.