Поделиться через

XML для действий

  • Статья

В этом разделе содержится пример сценария, в котором показано, что API расширения поставщика Outlook Social Connector (OSC) вызывает вызовы API расширения, которые реализует поставщик OSC, а OSC создает для получения сведений о действиях. Информация выражается в XML-строках, соответствующих XML-схеме поставщика OSC.

XML-схема поставщика OSC позволяет поставщику OSC определять действия. Сведения о действиях могут включать в себя социальную сеть, в которой были созданы элементы веб-канала действий, сведения о каждом элементе веб-канала действий (например, владелец, тип и дата публикации действия), а также шаблон для отображения действия. Для поддержки отображения действий в области Люди или карточке контакта поставщик OSC социальной сети должен реализовать и вернуть правильный XML-код действий. Пример XML веб-канала действий см. в разделе Пример XML веб-канала действий. Дополнительные сведения о синхронизации действий друзей см. в разделе Синхронизация друзей и действий. Полное определение XML-схемы поставщика OSC, включая обязательные или необязательные элементы, см. в разделе Схема XML поставщика соединителя социальных сетей Outlook.

В следующем сценарии OSC динамически синхронизирует действия пользователя, выбранного в области Люди, и получает сведения об этом человеке:

  1. Поставщик OSC, поддерживающий синхронизацию действий по запросу, указывает, что в OSC с помощью элементов getActivities и dynamicActivitiesLookupEx . Поставщик OSC также задает элемент hashFunction . Все три элемента являются дочерними элементами возможностей.

  2. Поставщик OSC реализует методы ISocialProvider::GetCapabilities и ISocialSession2::GetActivitiesEx .

  3. OSC вызывает ISocialProvider::GetCapabilities для проверка значения getActivities и dynamicActivitiesLookupEx, чтобы убедиться, что поставщик OSC поддерживает синхронизацию действий по запросу. OSC также отмечает значение элемента hashFunction , поддерживаемого поставщиком OSC.

  4. OSC обновляет область Люди или карточку контакта, чтобы пользователь видел последние действия выбранного пользователя. OSC шифрует SMTP-адрес пользователя с помощью хэш-функции, указанной в элементе hashFunction , формируя XML-строку, соответствующую определению схемы XML для элемента hashedAddresses .

  5. OSC вызывает ISocialSession2::GetActivitiesEx, предоставляя эту XML-строку хэшированного адреса в качестве параметра hashedAddresses , чтобы получить текущую коллекцию действий для этого пользователя в параметре activities . Строка параметра activity соответствует определению XML-схемы элемента activityFeed .

  6. На основе определения СХЕМЫ XML для activityFeed OSC дополнительно анализирует строку действий , чтобы узнать тип, дату публикации и другие сведения о каждом действии, а также способ отображения действия.

  7. Чтобы получить сведения о выбранном пользователе, OSC вызывает ISocialSession2::GetPeopleDetails, предоставляя ту же xml-строку хэшированных адресов, что и аргумент для параметра personsAddresses . Сведения о пользователе возвращаются в параметре personsCollection . Эти сведения могут включать firstName, lastName и emailAddress. Параметр personsCollection соответствует определению схемы XML для элемента person .

Дополнительные сведения об указании XML для действий см. в следующих разделах этого раздела:

См. также