活动源简介

 

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

作为使用活动源实施协作方案的开发人员，您应熟悉活动源术语、定义和实体模型。

本主题内容

活动源概念

活动源实体

有关记录

在记录墙或个人墙上显示数据

活动源概念

下表包含了活动源定义。

术语	说明
留言板	Microsoft Dynamics 365 中将活动源显示为简短更新的位置。
记录墙	Microsoft Dynamics 365 中显示记录（如客户或潜在顾客）的活动源的位置。 在 Microsoft Dynamics 365 Web 应用程序中，记录墙显示为记录的“新增功能”。 记录墙包含有关记录或提及该记录的公告。 如果记录为系统用户（用户），则留言板还包含该用户创建的公告。
个人留言板	属于用户个人的留言板。 在 Microsoft Dynamics 365 Web 应用程序中，它是用户的“新增功能”墙。 该留言板包含有关用户追随的记录的公告，以及与用户有关或提及用户的公告。
自动公告	Microsoft Dynamics 365 在出现事件的情况下（如创建客户或结束赢单）通过应用自动公告规则生成的公告。 自动公告可在记录墙或个人留言板中显示。 已对自动公告文本进行本地化。 备注 当创建新商机时，如果指定了下列特性之一，则会生成自动公告：CustomerId、ParentAccountId 或 ParentContactId。
手动公告（用户公告）	Microsoft Dynamics 365 用户创建的公告。 手动公告可在记录墙或个人留言板中显示。
自动公告规则	Microsoft Dynamics 365 用于在发生事件时生成自动公告的规则。 例如，规则可以指定在为客户创建新商机时生成自动公告。
有关记录	公告中引用 Microsoft Dynamics 365 记录的部分。 一个公告可以有多个有关记录。
注释	在公告中添加的注解。 注释与父公告相关。 它无法独立于父公告而存在。 如果删除父公告，会同时删除该公告的注释。
追随	用户对 Microsoft Dynamics 365 记录采取的操作，此操作使用户可以在其个人留言板中查看有关该记录的公告。 备注 对于 Dynamics 365（本地），允许关注的记录数最大值为 5000。 用户可以关注的记录数默认值为 1000。 默认值可配置，可以由管理员或有权修改部署设置的用户更改。
取消追随	用户对 Microsoft Dynamics 365 记录采取的操作，此操作禁止在用户的个人留言板中显示有关记录的公告。
喜欢	用户对公告采取的操作，该操作表示用户喜欢此公告。 备注
取消喜欢	用户采取的操作，该操作可从公告中移除“喜欢”。 备注
线索或对话	公告以及所有相关注释的集合。
视图	基于查询的实体记录的视图。

备注

手动公告和以编程方式生成的自动公告最多可以有 2000 个字符。Microsoft Dynamics 365 Web 应用程序中创建的公告最多可以有 1000 个字符。 以编程方式创建的注释最多可以有 1000 个字符，但是 Web 应用程序中创建的注释限制为 500 个字符。

活动源实体

下表包含有关活动源实体的信息。

实体	说明
Post	表示自动公告或手动（用户）公告。
PostComment	表示对活动源公告的注释。
PostFollow	表示公告追随，指示用户追随某一记录。 删除 PostFollow 记录相当于“取消追随”操作。
PostLike	表示用户喜欢该公告。 删除 PostLike 记录相当于“取消喜欢”操作。
msdyn_PostConfig	包含实体的活动源配置，并且可用于启用或禁用活动源的实体。
msdyn_PostRuleConfig	包含实体的活动源规则配置，并且可用于启用或禁用实体的自动公告规则。
msdyn_PostAlbum	包含用户配置文件图像，这些图像以附件的形式存储并在公告中显示。

喜欢/取消喜欢

使用喜欢/取消喜欢，您可以表达有关公告的立即观点。 这将使您的通信更具个性化和可交互性特征。 使用“喜欢/取消喜欢”可与您的同事相互称赞，表扬您的下属所做的工作以及评定公告的受欢迎度。Microsoft Dynamics 365 用户采取的一项操作，表示他们喜欢某个特定公告，该操作称为“喜欢”。Microsoft Dynamics 365 用户采取的一项操作，用于取消“喜欢”某个公告，该操作称为“取消喜欢”。 您可以向公告添加一个“喜欢”；但是，多个用户可能同时“喜欢”一个公告。 若要向公告添加“喜欢”，请创建 PostLike 记录并将其与父 Post 记录关联。 若要从该公告中删除“喜欢”，请删除 PostLike 记录。

有关记录

在组内讨论期间，您通常需要引用特定人员（Microsoft Dynamics 365 用户）或记录（如帐户）并将此类信息与其他人共享。 在 Microsoft Dynamics 365 活动源中，此操作称为“有关记录”。 介绍用户的文章可以在用户的记录墙和用户的个人留言板中显示（Microsoft Dynamics 365 中的“新增功能”）。 提及某个记录的公告将在记录墙上显示。

若要向公告添加有关记录，请在 Post.Text 属性中使用以下格式的表达式：

@[Entity,ID,"Display String"]。

备注

在此表达式中的逗号后面没有空格。

下表介绍了表达式中的参数：

参数	说明
Entity	一个针对公告中提及的记录的实体逻辑名称或实体类型代码。
ID	公告中提及的记录的 ID。
Display String	您希望在有关记录中显示的文本，如记录的名称。

所有默认（非自定义）实体的实体类型代码都是预定义的。 有关详细信息，请参阅组织服务实体。若要查看您的组织的实体元数据，请安装浏览组织的元数据中描述的元数据浏览器解决方案。 您还可以在一个名为 EntityMetadata.xlsx 的 Excel 文件中查看非自定义组织的元数据，该文件包含在 SDK 下载的顶级文件夹中。

可在此属性中指定多个有关记录。 若要检索有关记录中包含的数据，请解析 Text 属性中的字符串以搜索“@[”字符，该字符可将有关记录与其他有关记录或文本隔离开来。

有关公告有关记录的其他信息，请参阅博客文章：如何使用活动源进行有关记录。

在记录墙或个人墙上显示数据

若要检索要在记录墙或个人留言板中显示的公告，可使用 RetrieveRequest 消息或 RetrieveMultipleRequest 消息。 但是，若要在单次调用中检索具有相关注释和喜欢的公告页，则可使用特定的活动源消息。

若要检索记录墙中具有相关注释和喜欢的公告页，请使用 RetrieveRecordWallRequest 消息。 若要检索个人留言板中具有相关注释和喜欢的公告页，请使用 RetrievePersonalWallRequest 消息。

以下包含注释的公告将显示在“记录墙”上：

• 与记录相关的公告。 记录 ID 是在 Post.RegardingObjectId 属性中指定的。

• 提及某个记录的公告。 记录 ID 是在 Post.Text 属性中指定的。

• 对于系统用户（用户）记录，留言板还包含该用户创建的公告。Post.RegardingObjectId 属性包含当前用户 ID。

以下包含注释的公告将显示在“您的(用户)个人留言板”（Microsoft Dynamics 365 中的新增功能）中：

• 与您相关的公告。Post.RegardingObjectId 属性包含您的用户 ID。

• 提及您的公告。 您的用户 ID 是在 Post.Text 属性中指定的。

• 与某个记录相关或提及您追随的记录的公告。

备注

您只能追随您对其具有读取权和访问权的记录。 如果您丢失读取权限，则将自动删除追随。 所有 Microsoft Dynamics 365 用户将自动追随他们自身。 您只能查看与记录有关的公告或提及您对其具有读取权和访问权的记录。

如果为客户 A 创建 PostFollow 记录并将 PostFollow 上的 OwnerId 设为用户 B，则用户 B 将追随客户 A。

有关基于角色和基于记录的安全性的详细信息，请参阅 Microsoft Dynamics 365 的安全模型。

另请参阅

RetrieveRecordWallRequest
RetrievePersonalWallRequest
活动源实体
配置活动源
连接到 Yammer
示例：通过活动源进行协作
博客文章：使用 Microsoft CRM SDK 处理活动源
博客文章：如何使用活动源执行有关记录
博客文章：在 Microsoft Dynamics CRM 2011 中显示联系人的 Facebook 图片
博客文章：活动源实体的数据管理
博客文章：如何将记录墙添加到窗体
博客文章：活动源解决方案和开发环境

Microsoft Dynamics 365

© 2017 Microsoft。 保留所有权利。 版权