Introduction to activity feeds
Applies To: CRM 2015 on-prem, CRM Online
As a developer implementing collaboration scenarios with activity feeds, you should become familiar with the activity feeds terminology, definitions and entity model.
Activity feeds concepts
The following table contains activity feeds definitions.
A place in Microsoft Dynamics CRM where activity feeds are displayed as short updates.
A place in Microsoft Dynamics CRM where activity feeds for a record, such as an account or lead, are displayed. In the Microsoft Dynamics CRM web application, the record wall is shown as What’s New for the record. The record wall contains posts that are regarding the record or that mention the record. If a record is the system user (user), the wall also contains the posts that are created by the user.
A wall that is personal to a user. In the Microsoft Dynamics CRM web application, it is user’s What’s New wall. This wall contains the posts about the records that the user is following, posts that are regarding the user or that mention the user.
A post generated by Microsoft Dynamics CRM by applying an auto post rule in case of an event, such as creation of an account or closure of a won opportunity. An auto post can be shown on a record wall or personal wall. The auto post text is localized.
Manual Post (User Post)
A post created by a Microsoft Dynamics CRM user. A manual post can be shown on a record wall or personal wall.
Auto Post Rule
A rule that is used by Microsoft Dynamics CRM to generate an auto post when an event occurs. For example, a rule may specify to generate an auto post when a new opportunity is created for an account.
A part of a post that refers to a Microsoft Dynamics CRM record. One post can have multiple mentions.
A remark that is added on a post. A comment is related to a parent post. It cannot exist without a parent post. If a parent post is deleted, the post’s comments are deleted also.
An action taken by a user on a Microsoft Dynamics CRM record that enables that user to see the posts about the record on their personal wall.
An action taken by a user on a Microsoft Dynamics CRM record that stops posts about that record from being displayed on the user's personal wall.
An action taken by a user on a post that expresses that the user liked the post.
An action taken by a user to remove the Like from the post.
Thread or Conversation
A collection of posts and all related comments.
A view of entity records based on a query.
|Manual and auto posts that are created programmatically can have up to 2000 characters. Posts created in the Microsoft Dynamics CRM web application can have up to 1000 characters. Comments that are created programmatically can have up to 1000 characters, but comments created in the web application are limited to 500 characters.|
Activity feeds entities
The following table contains information about the activity feeds entities.
Represents an auto post or a manual (user) post.
Represents a comment on an activity feed post.
Represents a post follow that indicates that a user follows a record. Deleting the PostFollow record is an action of “unfollow”.
Represents that the user liked the post.
Deleting the PostLike record is an action of “unlike”.
Contains activity feed configuration for an entity and is used to enable or disable an entity for activity feeds.
Contains activity feed rule configuration for an entity and is used to enable or disable an auto post rule for an entity.
Contains user profile images that are stored as attachments and displayed in posts.
With Like/Unlike, you can express an immediate opinion about a post. This makes your communication more personable and interactive. Use Like/Unlike to exchange kudos with your co-workers, praise the work of your subordinates and measure the popularity of the posts. An action taken by the Microsoft Dynamics CRM users showing that they like a particular post is called Like. An action taken by a Microsoft Dynamics CRM user to undo the “Like” on a post is called the Unlike. You can add one “Like” to the post; however, a post maybe “liked” by multiple users. To add a “Like” to a post, create the PostLike record and associate it with the parent Post record. To remove the “Like” from the post, delete the PostLike record.
During discussions within a group, you often need to reference a specific person (a Microsoft Dynamics CRM user), or a record, such as an account, and share this information with others. In Microsoft Dynamics CRM Activity Feeds, this action is called a “mention.” The posts that mention a user can be displayed on the user’s record wall and user’s personal wall (“What’s New” in Microsoft Dynamics CRM). The posts that mention a record are displayed on the record’s wall.
To add a mention to a post, use an expression in the following format in the Post.Text attribute:
|There are no spaces following commas in this expression.|
The following table describes the parameters in the expression:
An entity logical name or an entity type code for the record that is mentioned in the post.
The ID of the record that is mentioned in the post.
The text that you want to be displayed in the mention, such as a record’s name.
The entity type codes for all default (non-custom) entities are predefined. For more information, see IOrganizationService entities. To view the entity metadata for your organization, install the Metadata Browser solution described in Browse the metadata for your organization. You can also view the metadata for an uncustomized organization in the Excel file called EntityMetadata.xlsx included in the top-level folder of the SDK download.
You can specify multiple mentions in this attribute. To retrieve data contained in the mention, parse the string in the Text attribute to search for the “@[“ characters that separate mentions from other mentions or text.
For additional information about post mentions, see Blog Post: How to do Mentions with Activity Feeds.
Displaying data on the record wall or personal wall
To retrieve posts for displaying on a record wall or a personal wall, you can use the RetrieveRequest message or RetrieveMultipleRequest message. However, to retrieve pages of posts with associated comments and likes in one single call, you can use special activity feeds messages.
To retrieve pages of posts with associated comments and likes for a record wall, use the RetrieveRecordWallRequest message. To retrieve pages of posts with associated comments and likes for a personal wall, use the RetrievePersonalWallRequest message.
The following posts with comments are displayed on the Record Wall:
Posts that are regarding a record. The record ID is specified in the Post.RegardingObjectId attribute.
Posts that mention a record. The record ID is specified within the Post.Text attribute.
For a system user (user) record, the wall also includes the posts that the user created. The Post.RegardingObjectId attribute contains the current user ID.
The following posts with comments are displayed on the Your (User) Personal Wall (What’s New in Microsoft Dynamics CRM):
Posts that are regarding you. The Post.RegardingObjectId attribute contains your user ID.
Posts that mention you. Your user ID is specified within the Post.Text attribute.
Posts that are regarding a record or that mention a record that you follow.
|You can only follow the records on which you have read privileges and access rights. If you lose read permissions, a follow is automatically removed. All Microsoft Dynamics CRM users automatically follow themselves. You can only see the posts that are regarding the records or mention the records on which you have read privileges and access rights.|
If you create the PostFollow record for the account A and set the OwnerId on the PostFollow to the user B, then the user B follows the account A.
For more information about the role-based and record-based security, see, The security model of Microsoft Dynamics CRM.
ConceptsConfigure activity feeds
Connect to Yammer
Other ResourcesActivity feeds entities
Sample: Collaborate with activity feeds
Blog Post: Working with Activity Feed using Microsoft CRM SDK
Blog Post: How to do Mentions with Activity Feeds
Blog Post: Displaying a Contact’s Facebook Picture in Microsoft Dynamics CRM 2011
Blog Post: Data management for Activity Feeds entities
Blog Post: How to Add a Record Wall to a Form
Blog Post: Activity Feeds Solution & Development Environment
Microsoft Dynamics CRM 2015 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.