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

XML для друзей

  • Статья

Элемент friends в XML-схеме поставщика Microsoft Outlook Social Connector (OSC) позволяет поставщику OSC указать сведения для списка лиц, связанных с пользователем Outlook в социальной сети. Если поставщик OSC поддерживает кэшированную синхронизацию, этот список пользователей будет содержать только друзей пользователя Outlook в социальной сети. Если OSC поддерживает синхронизацию по запросу или гибридную синхронизацию, в этом списке могут содержаться как друзья, так и другие пользователи Outlook.

Каждый пользователь в списке представлен как элемент person в схеме XML, который поддерживает такие сведения, как имя, фамилия и адреса электронной почты. Поставщики OSC используют элементы друзей и пользователей независимо от того, как они хотят, чтобы OSC синхронизировать сведения о друзьях из социальной сети. Обратите внимание, что дочерние элементы пользователя похожи на некоторые свойства контакта Outlook, что упрощает хранение друзей в папке контактов Outlook, относяскойся к социальной сети, если социальная сеть поддерживает кэшированную или гибридную синхронизацию друзей с папкой контактов Outlook.

Примеры сценариев

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

Пример XML-кода друзей см. в разделе Пример XML-кода друзей. Дополнительные сведения о синхронизации сведений о друзьях см. в разделе Синхронизация друзей и действий.

Сценарий 1. Получение списка друзей

Сценарий 1. OSC получает список друзей, объект ISocialPerson и фотографию для каждого друга:

  1. Поставщик OSC, который поддерживает отображение друзей с сайта социальной сети и позволяет OSC кэшировать сведения о друзьях, указывает, что в OSC используются элементы getFriends и cacheFriends , которые являются дочерними элементами элемента capabilities .

  2. Поставщик OSC также реализует методы ISocialProvider::GetCapabilities, ISocialSession::GetPerson, ISocialPerson::GetFriendsAndColleagues и ISocialPerson::GetPicture .

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

  4. OSC вызывает ISocialSession::GetPerson , чтобы получить объект ISocialPerson для пользователя Outlook.

  5. OSC вызывает ISocialPerson::GetFriendsAndColleagues , чтобы получить список друзей пользователя Outlook, возвращенный в строке параметра personCollection . Строка personCollection соответствует определению схемы XML для элемента friends в XML-схеме.

  6. Для каждого друга в xml-строке personCollection OSC получает значение элемента userID для вызова ISocialSession::GetPerson , чтобы получить объект ISocialPerson для этого друга.

  7. Для каждого друга в xml-строке personCollection OSC вызывает ISocialPerson::GetPicture , чтобы получить ресурс изображения для этого друга.

    OSC может выполнять дальнейшие вызовы объекта ISocialPerson для получения действий и сведений (например, адресов электронной почты) для этого друга.

Сценарий 2. Синхронизация друзей

Сценарий 2. OSC динамически синхронизирует друзей:

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

  2. Поставщик OSC также реализует метод ISocialSession2::GetPeopleDetails .

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

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

  5. OSC вызывает ISocialSession2::GetPeopleDetails, предоставляя эту XML-строку хэшированных адресов в качестве параметра personAddresses , чтобы динамически получать обновленные сведения о людях в параметре personCollection . Строка параметра personsCollection соответствует определению схемы XML для элемента friends в XML-схеме.

Родительские и дочерние элементы

Ниже приведены два элемента верхнего уровня в схеме friends .

Элемент Описание
Друзей
Представляет корневой элемент списка элементов person . ISocialPerson::GetFriendsAndColleagues, ISocialSession::FindPerson и ISocialSession2::GetPeopleDetails возвращают XML-строки, соответствующие определению схемы элемента friends.
person
Представляет одного человека в списке элементов person . Метод ISocialPerson::GetDetails возвращает СТРОКУ XML, соответствующую определению схемы элемента person .

В следующей таблице описан каждый дочерний элемент элемента person в XML-схеме поставщика OSC.

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

Элемент Описание
address
Физический адрес улицы человека.
Годовщину
Дата годовщины события для человека.
askmeabout
Темы, представляющие интерес или опыт пользователя.
День рождения
Дата рождения человека.
businessAddress
Физический адрес улицы рабочего места человека.
businessCity
Город для рабочего места человека.
businessCountryOrRegion
Страна или регион рабочего места пользователя.
businessState
Штат или провинция рабочего места пользователя.
businessZip
Почтовый индекс рабочего места пользователя.
Ячейки
Номер мобильного телефона для пользователя.
Города
Город физического адреса пользователя.
company
Название компании, связанной с пользователем.
countryOrRegion
Страна или регион физического адреса пользователя.
creationTime
Время создания профиля пользователя в социальной сети.
emailAddress
Основной адрес электронной почты пользователя.
emailAddress2
Дополнительный адрес электронной почты пользователя.
emailAddress3
Третичный адрес электронной почты пользователя.
expirationTime
Время истечения срока действия данных профиля пользователя в социальной сети.
fileAs
Строка, с помощью которой пользователь должен быть зарегистрирован в качестве контакта в файле контактов Outlook.
firstName
Имя или имя пользователя.
friendStatus
Состояние друга этого пользователя с вошедшего в систему пользователя в социальной сети. Должно быть одно из следующих значений: friend, nonfriend, pending, pendingin, pendingout.
Fullname
Полное имя пользователя.
Гендерного
Пол человека. Должно быть одно из следующих значений: мужской, женский, неопределенный.
homePhone
Домашний номер телефона для человека.
index
Расположение хэшированного адреса пользователя в строковом параметре personsAddresses , переданном вызову метода ISocialSession2::GetPeopleDetails . Он также указывает XML-код пользователя в строке personsCollection , возвращенной Командой GetPeopleDetails.
Отраслей
Отрасли, которыми занимается человек.
interests;
Интересы или хобби человека.
lastModificationTime
Время последнего изменения профиля пользователя в социальной сети.
lastName
Фамилия или фамилия человека.
location
Расположение пользователя.
Прозвище
Более короткое или придуманное имя человека.
OtherAddress
Альтернативный адрес улицы человека.
otherCity
Город альтернативного адреса человека.
otherCountryOrRegion
Страна или регион альтернативного адреса пользователя.
otherState
Штат или провинция альтернативного адреса лица.
otherZip
Почтовый индекс альтернативного адреса пользователя.
Телефон
Основной контактный номер телефона для человека.
pictureUrl
URL-адрес для изображения профиля пользователя.
Отношения
Связь этого пользователя с вошедшего в систему пользователя.
schools;
Школы, в которые человек ходит или пошел.
skills.
Личные навыки человека.
state
Штат или провинция физического адреса лица.
заголовок
Обозначение добавляется к имени человека.
Userid
Идентификатор для идентификации пользователя в социальной сети.
webProfilePage
Адрес веб-страницы, содержащий профиль пользователя.
Сайт
Веб-сайт пользователя.
workPhone
Рабочий номер телефона для пользователя.
Молния
Почтовый индекс или почтовый индекс физического адреса пользователя.

См. также