Package org.alfresco.service.cmr.activities

Interface ActivityService

All Superinterfaces:

ActivityPostService

All Known Implementing Classes:

ActivityServiceImpl

@AlfrescoPublicApi
public interface ActivityService
extends ActivityPostService

The activity service

Method Summary

Modifier and Type	Method	Description
boolean	existsFeedControl(FeedControl feedControl)	For current user, does the feed control exist ?
java.util.List<FeedControl>	getFeedControls()	For current user, get feed controls
java.util.List<FeedControl>	getFeedControls(java.lang.String userId)	For given user, get feed controls
int	getMaxFeedItems()	Return maximum configured item entries (per feed)
org.alfresco.query.PagingResults<ActivityFeedEntity>	getPagedUserFeedEntries(java.lang.String feedUserId, java.lang.String siteId, boolean excludeThisUser, boolean excludeOtherUsers, long minFeedId, org.alfresco.query.PagingRequest pagingRequest)
java.util.List<java.lang.String>	getSiteFeedEntries(java.lang.String siteId)	Retrieve site feed
java.util.List<java.lang.String>	getUserFeedEntries(java.lang.String userId, java.lang.String siteId)	Retrieve user feed with optional site filter Will return activities for all users across all sites, or optionally for all users for specified site.
java.util.List<java.lang.String>	getUserFeedEntries(java.lang.String userId, java.lang.String siteId, boolean excludeThisUser, boolean excludeOtherUsers)	Retrieve user feed with optional site filter and optional user filters Will return activities for users across all sites, or optionally for users for specified site.
java.util.List<ActivityFeedEntity>	getUserFeedEntries(java.lang.String feedUserId, java.lang.String siteId, boolean excludeThisUser, boolean excludeOtherUsers, long minFeedId)	Retrieve user feed with optional site filter and optional user filters and optional min feed DB id Will return activities for users across all sites, or optionally for users for specified site.
java.util.List<java.lang.String>	getUserFeedEntries(java.lang.String userId, java.lang.String siteId, boolean excludeThisUser, boolean excludeOtherUsers, java.util.Set<java.lang.String> userFilter, java.util.Set<java.lang.String> actvityFilter)	Retrieve user feed with optional site filter and optional user filters Will return activities for users across all sites, or optionally for users for specified site.
java.util.List<ActivityFeedEntity>	getUserFeedEntries(java.lang.String feedUserId, java.lang.String siteId, boolean excludeThisUser, boolean excludeOtherUsers, java.util.Set<java.lang.String> userFilter, java.util.Set<java.lang.String> actvityFilter, long minFeedId)	Retrieve user feed with optional site filter and optional user filters and optional min feed DB id Will return activities for users across all sites, or optionally for users for specified site.
void	setFeedControl(FeedControl feedControl)	For current user, set feed control (opt-out) for a site or an appTool or a site/appTool combination
void	unsetFeedControl(FeedControl feedControl)	For current user, unset feed control

Methods inherited from interface org.alfresco.service.cmr.activities.ActivityPostService

postActivity, postActivity, postActivity, postActivity, postActivity, postActivity, postActivity

Method Detail

getUserFeedEntries

@NotAuditable
java.util.List<java.lang.String> getUserFeedEntries(java.lang.String userId,
                                                    java.lang.String siteId)

Retrieve user feed with optional site filter Will return activities for all users across all sites, or optionally for all users for specified site.

Parameters:

userId - - required

siteId - - optional, if set then will filter by given siteId else return all sites

Returns:

list of JSON feed entries

getUserFeedEntries

@NotAuditable
java.util.List<java.lang.String> getUserFeedEntries(java.lang.String userId,
                                                    java.lang.String siteId,
                                                    boolean excludeThisUser,
                                                    boolean excludeOtherUsers)

Retrieve user feed with optional site filter and optional user filters Will return activities for users across all sites, or optionally for users for specified site. User filters are: - all user activities (excludeThisUser = false, excludeOtherUsers = false) - other user activities (excludeThisUser = true, excludeOtherUsers = false) - my user activities (excludeThisUser = false, excludeOtherUsers = true) note: if both excludes are true then no activities will be returned.

Parameters:

userId - - required

siteId - - optional, if set then will filter by given siteId else return all sites

excludeThisUser - - if TRUE then will exclude activities for this user (hence returning other users only)

excludeOtherUsers - - if TRUE then will exclude activities for other users (hence returning this user only)

Returns:

list of JSON feed entries

getUserFeedEntries

@NotAuditable
java.util.List<java.lang.String> getUserFeedEntries(java.lang.String userId,
                                                    java.lang.String siteId,
                                                    boolean excludeThisUser,
                                                    boolean excludeOtherUsers,
                                                    java.util.Set<java.lang.String> userFilter,
                                                    java.util.Set<java.lang.String> actvityFilter)

Retrieve user feed with optional site filter and optional user filters Will return activities for users across all sites, or optionally for users for specified site. User filters are: - all user activities (excludeThisUser = false, excludeOtherUsers = false) - other user activities (excludeThisUser = true, excludeOtherUsers = false) - my user activities (excludeThisUser = false, excludeOtherUsers = true) note: if both excludes are true then no activities will be returned.

Parameters:

userId - - required

siteId - - optional, if set then will filter by given siteId else return all sites

excludeThisUser - - if TRUE then will exclude activities for this user (hence returning other users only)

excludeOtherUsers - - if TRUE then will exclude activities for other users (hence returning this user only)

userFilter - - if not NULL then will only return activities of users in this set

actvityFilter - - if not NULL then will only return activities that are in this set

Returns:

list of JSON feed entries

getUserFeedEntries

@NotAuditable
java.util.List<ActivityFeedEntity> getUserFeedEntries(java.lang.String feedUserId,
                                                      java.lang.String siteId,
                                                      boolean excludeThisUser,
                                                      boolean excludeOtherUsers,
                                                      long minFeedId)

Retrieve user feed with optional site filter and optional user filters and optional min feed DB id Will return activities for users across all sites, or optionally for users for specified site. User filters are: - all user activities (excludeThisUser = false, excludeOtherUsers = false) - other user activities (excludeThisUser = true, excludeOtherUsers = false) - my user activities (excludeThisUser = false, excludeOtherUsers = true) note: if both excludes are true then no activities will be returned.

Parameters:

feedUserId - - required

siteId - - optional, if set then will filter by given siteId else return all sites

excludeThisUser - - if TRUE then will exclude activities for this user (hence returning other users only)

excludeOtherUsers - - if TRUE then will exclude activities for other users (hence returning this user only)

minFeedId - - inclusive from min feed DB id, if -1 then return all available

Returns:

list of JSON feed entries

getUserFeedEntries

@NotAuditable
java.util.List<ActivityFeedEntity> getUserFeedEntries(java.lang.String feedUserId,
                                                      java.lang.String siteId,
                                                      boolean excludeThisUser,
                                                      boolean excludeOtherUsers,
                                                      java.util.Set<java.lang.String> userFilter,
                                                      java.util.Set<java.lang.String> actvityFilter,
                                                      long minFeedId)

Retrieve user feed with optional site filter and optional user filters and optional min feed DB id Will return activities for users across all sites, or optionally for users for specified site. User filters are: - all user activities (excludeThisUser = false, excludeOtherUsers = false) - other user activities (excludeThisUser = true, excludeOtherUsers = false) - my user activities (excludeThisUser = false, excludeOtherUsers = true) note: if both excludes are true then no activities will be returned.

Parameters:

feedUserId - - required

siteId - - optional, if set then will filter by given siteId else return all sites

excludeThisUser - - if TRUE then will exclude activities for this user (hence returning other users only)

excludeOtherUsers - - if TRUE then will exclude activities for other users (hence returning this user only)

userFilter - - if not NULL then will only return activities of users in this set

actvityFilter - - if not NULL then will only return activities that are in this set

minFeedId - - inclusive from min feed DB id, if -1 then return all available

Returns:

list of JSON feed entries

getPagedUserFeedEntries

@NotAuditable
org.alfresco.query.PagingResults<ActivityFeedEntity> getPagedUserFeedEntries(java.lang.String feedUserId,
                                                                             java.lang.String siteId,
                                                                             boolean excludeThisUser,
                                                                             boolean excludeOtherUsers,
                                                                             long minFeedId,
                                                                             org.alfresco.query.PagingRequest pagingRequest)

getSiteFeedEntries

@NotAuditable
java.util.List<java.lang.String> getSiteFeedEntries(java.lang.String siteId)

Retrieve site feed

Parameters:

siteId - - required

Returns:

list of JSON feed entries

getMaxFeedItems

@NotAuditable
int getMaxFeedItems()

Return maximum configured item entries (per feed)

Returns:

int

setFeedControl

@NotAuditable
void setFeedControl(FeedControl feedControl)

For current user, set feed control (opt-out) for a site or an appTool or a site/appTool combination

Parameters:

feedControl - - required

getFeedControls

@NotAuditable
java.util.List<FeedControl> getFeedControls(java.lang.String userId)

For given user, get feed controls

Parameters:

userId - - required (must match

Returns:

list of user feed controls

getFeedControls

@NotAuditable
java.util.List<FeedControl> getFeedControls()

For current user, get feed controls

Returns:

list of user feed controls

unsetFeedControl

@NotAuditable
void unsetFeedControl(FeedControl feedControl)

For current user, unset feed control

Parameters:

feedControl - - required

existsFeedControl

@NotAuditable
boolean existsFeedControl(FeedControl feedControl)

For current user, does the feed control exist ?

Parameters:

feedControl - - required

Returns:

true, if user feed control exists