活动的 XML

本主题包含一个示例方案,其中显示了 OSC 提供程序为获取活动信息而Outlook Social Connector (OSC) 提供程序扩展性 API 调用。 信息以符合 OSC 提供程序 XML 架构的 XML 字符串表示。

OSC 提供程序 XML 架构允许 OSC 提供程序定义活动。 活动信息可能包括源自活动源项目的社交网络、每个活动源项目的详细信息 (如活动) 的所有者、类型和发布日期,以及用于显示活动的模板。 为了支持在人员窗格或联系人卡片上显示活动,社交网络的 OSC 提供程序必须实现并返回正确的活动 XML。 有关活动源 XML 的示例,请参阅 活动源 XML 示例。 有关同步好友活动详细信息,请参阅 同步好友和活动。 有关 OSC 提供程序 XML 架构的完整定义,包括哪些元素是必需的或可选的,请参阅Outlook连接器提供程序 XML 架构

在下列方案中,OSC 动态同步在人员窗格中选择的人的活动,并获取此人的详细信息:

  1. 支持按需同步活动的 OSC 提供程序使用 getActivitiesdynamicActivitiesLookupEx 元素将指示到 OSC。 OSC 提供程序还会设置 hashFunction 元素。 这三个元素都是功能的 子元素

  2. OSC 提供程序实现 ISocialProvider::GetCapabilitiesISocialSession2::GetActivitiesEx 方法。

  3. OSC 调用 ISocialProvider::GetCapabilities 以检查 getActivitiesdynamicActivitiesLookupEx 的值,以验证 OSC 提供程序是否支持按需同步活动。 OSC 还记下 OSC 提供程序支持的 hashFunction 元素的值。

  4. OSC 刷新人员窗格或联系人卡片,让用户看到所选人员的最新活动。 OSC 使用 hashFunction 元素中指定的哈希函数对个人的 SMTP 地址进行加密,形成一个符合 hashedAddresses 元素的 XML 架构定义的 XML 字符串。

  5. OSC 调用 ISocialSession2::GetActivitiesEx,以将哈希地址的此 XML 字符串作为 hashedAddresses 参数提供,以在 activities 参数中获取此人的当前活动集合。 activities 参数字符串符合 activityFeed 元素的 XML 架构定义。

  6. 基于 activityFeed 的 XML 架构定义,OSC 进一步分析活动字符串,以查找有关每个活动的类型、发布日期和其他信息,以及如何显示活动。

  7. 为了获取选定人员的详细信息,OSC 调用 ISocialSession2::GetPeopleDetails,提供与 personAddresses 参数参数相同的哈希地址 XML 字符串。 有关人员的详细信息在 personCollection 参数 中返回。 这些详细信息可能包括 firstNamelastNameemailAddresspersonCollection 参数符合 person 元素的 XML 架构定义。

有关为活动指定 XML 的信息,请参阅本节的以下主题:

另请参阅