Obsolete Pages{{Obsolete}}
The official documentation is at: http://docs.alfresco.com
Activities Service3.0
DRAFT/WIP
Alfresco Activities is part of Alfresco's open source social computing platform. Alfresco v3.0 provides support for a news/activity feed in the context of an enterprise generating and acting upon content within a site. The activities will be raised (i.e. posted) by certain components within the context of a site. The activity service will then generate corresponding activity feeds for each member of that site. This document outlines the steps for a component developer to post a new activity type.
As a developer, you can post an activity (which in turn will generate a corresponding activity feed) by simply following three basic steps.
Typically, you will post (via JavaScript or Java) an instance of an activity type, with some activity data, as well as the site context and the app/tool/component type id.
For example, using JavaScript call:
activities.postActivity('org.alfresco.calendar.event-created', 'mysite1', 'calendarComponent', '{ 'item1' : 123 }');
See also:
In some cases, you can post an activity with a nodeRef to allow the activity service to lookup some generic data for the node. For details, refer to:
You should create corresponding activity templates (using FreeMarker format) for your new activity type, and drop them into the activity template store. The templates could be running out-of-process (eg. if the activity service has been distributed to a grid) so you can only access activity data that is either supplied during the post (or looked-up based on supplied nodeRef). The templates can access the activity data, since the activity service will auto-convert the JSON activity data to a FreeMarker data model. A JSON object will be converted to a FreeMarker 'hash' (map) and a JSON array will be converted to a FreeMarker 'sequence' (list). Also, date strings in the format ISO8601 format (YYYY-MM-DDThh:mm:ss.sssTZD) will be accessible as dates. Additional data accessible to the template, includes:
See also: [3.0_Activities_Design#Activity_Type_Templates Activity Type Templates]
The activity template store is configured to read from the classpath and/or repository, as per web-scripts-application-context.xml. The search path order is:
alfresco/extension/templates/activities
alfresco/templates/activities
For example, if your new activity type is 'org.mycompany.mycomponent.event-created' then you might create two templates for ATOM entry and RSS:
.../org/mycompany/mycomponent/event-created.atomentry.fl
.../org/mycompany/mycomponent/event-created.rss.fl
and put them on the classpath under:
alfresco/templates/activities/...
In general, each activity type will have one or more activity type templates corresponding to each supported format. However, if an activity type template is missing then the activity service will attempt to fall-back to a ... TODO
Alfresco pre-built activity type templates can also acts as samples. These will be included on the classpath under:
alfresco/templates/activities/org/alfresco/...
Alfresco currently also includes pre-built generic templates under:
.../org/alfresco/generic.atomentry.fl
.../org/alfresco/generic.json.ftl
The JSON template can be used to pass through activity data straight back to an activity JSON feed.
The ATOM Entry template can be used for initial dev testing, but should be overridden.
Examples of current (work-in-progress) tool/component ids are:
The Repository Site Service currently posts activities when users join a site, leave a site or have their role changed by an admin. The current activity types are:
These activities are posted by the Java-based service:
repository/source/java/org/alfresco/repo/site/SiteServiceImpl.java
The basic templates for the three activity types are under:
(in SVN) /projects/remote-api/config/alfresco/templates/activities
(on server) alfresco/WEB-INF/classes/alfresco/templates/activities
/org/alfresco/site/user-joined.atomentry.ftl
/org/alfresco/site/user-left.atomentry.ftl
/org/alfresco/site/user-role-changed.atomentry.ftl
The Share Calendar Component currently posts activities when calendar events are created. The current activity types are:
which are posted by the Calendar Component:
remote-api/config/alfresco/templates/webscripts/org/alfresco/slingshot/calendar/event.post.js
remote-api/config/alfresco/templates/webscripts/org/alfresco/slingshot/calendar/event.delete.js
The basic templates for these activity type are:
remote-api/config/alfresco/templates/activities/org/alfresco/calendar/event-created.atomentry.ftl
remote-api/config/alfresco/templates/activities/org/alfresco/calendar/event-deleted.atomentry.ftl
The Share Wiki Component currently posts activities when wiki pages are created and edited. The current activity types are:
which are posted by the Wiki Component:
remote-api/config/alfresco/templates/webscripts/org/alfresco/slingshot/wiki/page.get.js
remote-api/config/alfresco/templates/webscripts/org/alfresco/slingshot/wiki/page.put.js
The basic templates for these activity type are:
remote-api/config/alfresco/templates/activities/org/alfresco/wiki/page-created.atomentry.ftl
remote-api/config/alfresco/templates/activities/org/alfresco/wiki/page-edited.atomentry.ftl
In order to test your activity, you can retrieve the activity feed using your favourite app that has in-built support for reading ATOM/RSS feeds. In future versions of the 3.0 slingshot app, you will also be able to use the in-built activities dashlet (TBC).
Note: the activity service is asynchronous, hence it may take a few minutes for the posted activity to appear in the activity feed.
To see the activity feed for site 'mysite1', you can access:
http://localhost:8080/alfresco/service/api/activities/feed/site/mysite1
You should login as 'admin' when prompted to authenticate.
Alternatively, you can display site activities that have generated entries of a given type by explicitly specifying the format, eg:
You can also refer to the webscript description and/or 3.0 REST API
To see the activity feed for user 'user1' as admin, you can access:
http://localhost:8080/alfresco/service/api/activities/feed/user/user1
You should login as 'admin' when prompted to authenticate.
To see the activity feed for the logged-in user, you can access:
http://localhost:8080/alfresco/service/api/activities/feed/user
Note: at time of writing, is not yet possible to see user activity feeds (outside of a system test) since it relies on the ability to setup site members.
Ask for and offer help to other Alfresco Content Services Users and members of the Alfresco team.
Related links:
By using this site, you are agreeing to allow us to collect and use cookies as outlined in Alfresco’s Cookie Statement and Terms of Use (and you have a legitimate interest in Alfresco and our products, authorizing us to contact you in such methods). If you are not ok with these terms, please do not use this website.