Calais installation for Alfresco integration

[deenaossama]

I have downloaded the .amp file of OpenCalais, from where can I start to learn how to actually install it and use it with alfresco??? I can not find any more details.
Thank you
Deena

[stevereiner]

To install the amp see the readme.txt available in the file download list on http://forge.alfresco.com/projects/calais/ .   One note if you have alfresco 3.4, apply_amps.bat  and apply_amps.sh have been moved to the bin dir of your alfresco install dir. The readme.txt also mentions you need to get a free calais api key from http://opencalais.com/user/register

To Use from Alfresco Web Client (Explorer)
1. From Run Action choose "Auto-tag with Calais" action (this action can also be setup on a content rule to auto tag content in given folder area automatically)
2. click "Set Valuse and Add"
3.  enter your calais key
4.  check "Auto Tag" and click ok
(Can also check if optionally want to attach full calais results as json and/or rdf metadata but only if you need this for some sort of custom development needs)
5. Auto-tagging is not done with the regular alfresco tag category or regular alfresco categories, won't show up in categories ui (different root category type used).
6. Auto tagging will show up in details page listed on the "Semantic Tags" item

From FlexSpaces:
http://forge.alfresco.com/projects/flexspaces/
See flexspaces readme.txt for how to setup the calais key (and google maps key) from in the FlexSpacesConfig.xml
FlexSpaces has much more UI available for auto-tagging, suggesting tags, editing tags on a doc, navigation for semantic tags to docs (tag clouds /  geo-tagged map)
See this screencam http://integratedsemantics.org/__oneclick_uploads/2008/12/geotag2.swf  for how to use the calais UI features

From Alfresco Share:
I am currently working on having non flex UI in Share to duplicate the calais UI features of FlexSpaces. So far have dashlets for semantic tag clouds and semantic geo-tagged maps:
http://yfrog.com/gzcprp

Links
main calais integration forum topic for announcements/status: http://forums.alfresco.com/en/viewtopic.php?f=32&t=15766
calais integration alfresco forge forum for detailed help:  http://forge.alfresco.com/forum/?group_id=172
blog http://integratedsemantics.org/
http://www.integratedsemantics.com/

[deenaossama]

I have followed every step, with a valid API key, but I get an error when trying to finish the action :
"Failed to run Actions due to error: null"

How to finish running this action?

And when is the RDF generated and where do they get stored?

Thank you so much.

[stevereiner]

action error
Can get an error if using mismatched version (would have an exception in log files about AbstractWebScript base class not found.)
Use calais integration 1.2  with alfresco 3.3 / 3.4
Use calais integration 1.1 with alfresco 3.2 and previous versions

Check alfresco log files for more detailed error / exception

Other things could be:
1. alfresco can't convert the file to get text to send to the calais service (test with a txt file instead)
2. file in a language not supported yet by the calais service
3. some sort of firewall issue where you can't call out to the url of the calais web service from your server

You usually won't need to store all the rdf and/or json returned by calais (just check the auto-tagging checkbox)
If you do check the "save rdf" checkbox, all of the rdf data returned by the calais service will be stored in a
CalaisRDFContent property on the document node. (If you check "save json", all the json data (much simpler than the rdf data) returned by the calais service will be stored in a CalaisJSONContent  property)