ActivityStories In-Process API Service

Ben Tiedt — Tue, 19 Nov 2019 20:05:44 GMT

Current Revision posted to API Documentation by Ben Tiedt on 11/19/2019 20:05:44

This service is available via Telligent.Evolution.Extensibility.Apis.Get<Telligent.Evolution.Extensibility.Api.Version1.IActivityStories>() and is defined in Telligent.Evolution.Platform.dll

Events

Events.AfterCreate

Handler

void ActivityStoryAfterCreateEventHandler([[ActivityStoryAfterCreateEventArgs In-Process API Event Argument|ActivityStoryAfterCreateEventArgs]] e);

Events.AfterDelete

Handler

void ActivityStoryAfterDeleteEventHandler([[ActivityStoryAfterDeleteEventArgs In-Process API Event Argument|ActivityStoryAfterDeleteEventArgs]] e);

Events.AfterUpdate

Handler

void ActivityStoryAfterUpdateEventHandler([[ActivityStoryAfterUpdateEventArgs In-Process API Event Argument|ActivityStoryAfterUpdateEventArgs]] e);

Events.BeforeCreate

Handler

void ActivityStoryBeforeCreateEventHandler([[ActivityStoryBeforeCreateEventArgs In-Process API Event Argument|ActivityStoryBeforeCreateEventArgs]] e);

Events.BeforeDelete

Handler

void ActivityStoryBeforeDeleteEventHandler([[ActivityStoryBeforeDeleteEventArgs In-Process API Event Argument|ActivityStoryBeforeDeleteEventArgs]] e);

Events.BeforeUpdate

Handler

void ActivityStoryBeforeUpdateEventHandler([[ActivityStoryBeforeUpdateEventArgs In-Process API Event Argument|ActivityStoryBeforeUpdateEventArgs]] e);

Events.Render

Handler

void ActivityStoryRenderEventHandler([[ActivityStoryRenderEventArgs In-Process API Event Argument|ActivityStoryRenderEventArgs]] e);

Properties

Name	Type	Description	Default	Options
DataTypeId	`Guid`	Activity Stories data type identifier
ServiceId	`Guid`	Activity Stories service identifier

Methods

bool CanDelete(Guid storyId);

Returns whether the accessing user can delete a story

Parameters

Name	Type	Description	Required	Default	Options
storyId	`Guid`	Story Id	Required

Return Type

bool

AdditionalInfo Delete(Guid storyId);

Deletes an activity story

Parameters

Name	Type	Description	Required	Default	Options
storyId	`Guid`	Story Id	Required

Return Type

[[AdditionalInfo In-Process API Supplementary Type|AdditionalInfo]]

ActivityStory Get(Guid storyId);

Gets an activity story

Parameters

Name	Type	Description	Required	Default	Options
storyId	`Guid`	Story Id	Required

Return Type

[[ActivityStory In-Process API Supplementary Type|ActivityStory]]

ActivityStoryTypeInfo GetActivityStoryType(Guid activityStoryTypeId);

Gets an activity story type by Id

Parameters

Name	Type	Description	Required	Default	Options
activityStoryTypeId	`Guid`	Activity story type Id	Required

Return Type

[[ActivityStoryTypeInfo In-Process API Supplementary Type|ActivityStoryTypeInfo]]

ActivityStorySitePreference GetDefaultPreference(Guid storyTypeId);

Gets a default preference

Parameters

Name	Type	Description	Required	Default	Options
storyTypeId	`Guid`	Activity story type Id	Required

Return Type

[[ActivityStorySitePreference In-Process API Supplementary Type|ActivityStorySitePreference]]

ApiList<ActivityStorySitePreference> GetDefaultPreferences(ActivityStorySitePreferenceListOptions options = null);

Gets a default preferences

Parameters

Name	Type	Description	Required	Default	Options
options	`[[ActivityStorySitePreferenceListOptions In-Process API Supplementary Type\|ActivityStorySitePreferenceListOptions]]`	Options include: Preferences	Optional

Return Type

[[ApiList(T) In-Process API Supplementary Type|ApiList]]<[[ActivityStorySitePreference In-Process API Supplementary Type|ActivityStorySitePreference]]>

ActivityStoryUserPreference GetUserPreference(Guid storyTypeId);

Gets a user preference

Parameters

Name	Type	Description	Required	Default	Options
storyTypeId	`Guid`	Activity story type Id	Required

Return Type

[[ActivityStoryUserPreference In-Process API Supplementary Type|ActivityStoryUserPreference]]

ApiList<ActivityStoryUserPreference> GetUserPreferences();

Gets user preferences

Return Type

[[ApiList(T) In-Process API Supplementary Type|ApiList]]<[[ActivityStoryUserPreference In-Process API Supplementary Type|ActivityStoryUserPreference]]>

PagedList<ActivityStory> List(ActivityStoryListOptions options = null);

Lists activity stories. Additional story filters can be passed in the format _Filter_STORYID = 'INCLUDEDUSERS' where INCLUDEDUSERS is a comma-separated list of the options 'all', 'following', and 'user' and 'user' refers to the user specifid by UserId. Due to performance improvements in the Activity Stream feature, List() may not always return PAGESIZE results, but it is guaranteed to return at least 1 story when using the default StartDate. By default, the method will first query for the last 48 hours, then for the last 96 hours, and then for all site activity, returning when it finds at least 1 story that matches the other given criteria. It also will not return the TOTALITEMS value.

Parameters

Name	Type	Description	Required	Default	Options
options	`[[ActivityStoryListOptions In-Process API Supplementary Type\|ActivityStoryListOptions]]`	Options include: ContentId, ContentTypeId, TypeId, ContentUrl, ContainerIds, ApplicationId, StoryIds, UserId, StartDate, EndDate, CreatedStartDate, CreatedEndDate, SortBy, SortOrder, PageSize, PageIndex, IsIndexed, Filters, IncludeUserEffectiveMemberGroups, IncludeAllJoinlessGroups	Optional

Return Type

[[PagedList(T) In-Process API Supplementary Type|PagedList]]<[[ActivityStory In-Process API Supplementary Type|ActivityStory]]>

ApiList<ActivityStoryTypeInfo> ListActivityStoryTypes();

Lists of activity story types

Return Type

[[ApiList(T) In-Process API Supplementary Type|ApiList]]<[[ActivityStoryTypeInfo In-Process API Supplementary Type|ActivityStoryTypeInfo]]>

AdditionalInfo SetDefaultPreference(Guid storyTypeId, string preference);

Sets default preference

Parameters

Name	Type	Description	Required	Default	Options
storyTypeId	`Guid`	Activity story type Id	Required
preference	`string`	Preference	Required

Return Type

[[AdditionalInfo In-Process API Supplementary Type|AdditionalInfo]]

AdditionalInfo SetUserPreference(Guid storyTypeId, bool isLoggingEnabled);

Sets user preference

Parameters

Name	Type	Description	Required	Default	Options
storyTypeId	`Guid`	Activity story type Id	Required
isLoggingEnabled	`bool`	Is logging enabled	Required

Return Type

[[AdditionalInfo In-Process API Supplementary Type|AdditionalInfo]]