活动的 XML

  • 项目

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

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

在以下方案中，OSC 动态同步人员窗格中所选人员的活动，并获取有关该人员的详细信息：

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

  2. OSC 提供程序实现 ISocialProvider：：GetCapabilities 和 ISocialSession2：：GetActivitiesEx 方法。

  3. OSC 调用 ISocialProvider：：GetCapabilities 来检查 getActivities 和 dynamicActivitiesLookupEx 的值，以验证 OSC 提供程序是否支持活动的按需同步。 OSC 还记录了 OSC 提供程序支持的 hashFunction 元素的值。

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

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

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

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

可以在本部分的以下主题中找到有关为活动指定 XML 的详细信息：

另请参阅