Changes between Version 7 and Version 8 of TaggingApi


Ignore:
Timestamp:
05/18/06 11:49:53 (19 years ago)
Author:
sauermann
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TaggingApi

    v7 v8  
    44implemented in gnowsis-server and the PIMO. 
    55 
    6 The code of the tagging-api is here: source:branches/gnowsis0.9/gnowsis-server/src/java/org/gnowsis/pimo/TaggingApi.java 
     6 * javadoc: [http://www.gnowsis.org/statisch/0.9/doc/gnowsis-server/javadoc/org/gnowsis/pimo/TaggingApi.html TaggingApi] 
     7 * code: [source:branches/gnowsis0.9/gnowsis-server/src/java/org/gnowsis/pimo/TaggingApi.java TaggingApi.java] 
    78 
    89Example to use the tagging API from inside gnowsis: 
    910 
    1011{{{ 
    11  // tag the file c:/semanticweb/blub.pdf with the ontology instance Semantic+Web 
    12  Gnowsis.getTaggingApi().addTagToResource("gnowsis://sauermann@serv-3100.dfki.uni-kl.de/resources/pimo/Semantic+Web", "file:/c:/semanticweb/blub.pdf"); 
     12// tag the file c:/semanticweb/blub.pdf with the ontology instance Semantic+Web 
     13Gnowsis.getTaggingApi().addTagToResource( 
     14  "gnowsis://sauermann@serv-3100.dfki.uni-kl.de/resources/pimo/Semantic+Web",  
     15  "file:/c:/semanticweb/blub.pdf"); 
    1316}}} 
    1417 
    15 = Using Tagging API from other applications via HTTP = 
     18= Using Tagging API from other applications = 
    1619 
    17 To use the TagingAPI from Mozilla Firefox and Thunderbird, tags are transmitted as comma separated list via httprequest. 
    18  
    19 Request from Mozilla Thunderbird: 
    20  
    21  * get me tags that contain this string X. Things have to have X in label, altLabel, wikiname or wikitext 
    22    * string x 
    23  * result:  
    24    * list of:tag-uri + tag + class of tag  
    25  
    26  
    27  * get me tags fitting to this email:  
    28    * message-id 
    29    * subject 
    30    * body 
    31  * result:  
    32    * list of:tag-uri + tag + class of tag  
    33  
    34  * 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. 
    35    * message-id 
    36  * result: 
    37    * list of:tag-uri + tag + class of tag  
    38  
    39  * tag this e-mail using that tag: 
    40    * message-id 
    41    * tag-uri 
    42    * operation: add tag/remove tag 
    43  * result: 
    44    * ok/error 
    45  
    46  * tag this e-mail using that tag-name: 
    47    * message-id 
    48    * tag-name (the label) 
    49    * operation: add tag/remove tag 
    50  * result: 
    51    * has to create a NEW TAG if tag-name does not exists, creates a URI for the tag. 
    52    * return new tag-uri + ok/error 
    53  
    54  
    55 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. 
    56   
     20We have made a crappy servlet to access the API, but we recommend to use [GnowsisXmlRpcDeveloping] to access the api.