Элементы XML возможностей
Таблицы в этом разделе описывают дочерние элементы XML-кода возможностей и группируются по областям, которые они поддерживают. Значение по умолчанию для каждого элемента capabilities равно false. Если элемент не указан в XML-коде возможностей , возвращаемом методом ISocialProvider::GetCapabilities , значение элемента равно false.
Общие сведения о XML-коде возможностей см. в разделе XML для возможностей. Пример XML возможностей см. в разделе Xml-пример возможностей. Полное определение XML-схемы поставщика microsoft Outlook Social Connector (OSC), включая обязательные или необязательные элементы, см. в статье Схема XML поставщика соединителя социальных сетей Outlook.
Возможности поддержки друзей
В следующей таблице показаны элементы, которые применяются к любой форме синхронизации друзей или не друзей.
| Элемент | Описание |
|---|---|
|
doNotFollowPerson |
Указывает, поддерживает ли поставщик вызов метода ISocialSession::UnFollowPerson . followPerson и doNotFollowPerson являются независимыми функциями поставщика OSC. Поставщик OSC может указать возможность добавления пользователя в качестве друга (для параметра followPerson значение true) или удаления пользователя в качестве друга в учетной записи социальной сети (для параметра doNotFollowPerson значение true). Как правило, возможность следовать не означает возможность прекратить отслеживание. followPerson — это возможность, и она не должна быть ошибочно интерпретирована как действие, чтобы следовать за конкретным человеком или каждым пользователем в учетной записи социальной сети. значение followPerson имеет значение true , не означает, что doNotFollowPerson имеет значение false. |
|
followPerson |
Указывает, поддерживает ли поставщик вызов метода ISocialSession::FollowPerson . OSC проверяет значение followPerson , если cacheFriends имеет значение true (кэшированная синхронизация друзей), dynamicContactsLookup — true (синхронизация друзей и не друзей по запросу) или как cacheFriends , так и dynamicContactsLookup — true (гибридная синхронизация друзей и не друзей). Если поставщик задает параметр followPerson как true, OSC отображает значок сети в области Люди для пользователей, на которые подписан пользователь, и включает команду on <NetworkName> в меню Добавить (+) в области Люди. Если поставщик задает значение followPerson как false, значок сети не отображается, а команда on <NetworkName> скрыта. |
|
getFriends |
Указывает, поддерживает ли поставщик вызов метода ISocialPerson::GetFriendsAndColleagues или ISocialSession2::GetPeopleDetails . Если поставщик задает getFriends как true, OSC использует значение cacheFriends или dynamicContactsLookup , чтобы определить, разрешено ли в социальной сети хранить друзей как контактные элементы Outlook или в памяти. Если поставщик устанавливает getFriends как false, социальная сеть не поддерживает методы друзья и методы ISocialPerson::GetFriendsAndColleagues и ISocialSession2::GetPeopleDetails , а OSC игнорирует значения cacheFriends и dynamicContactsLookup. |
Следующие элементы применяются только к кэшированной синхронизации друзей или гибридной синхронизации друзей и не друзей. Дополнительные сведения о синхронизации друзей см. в разделе Синхронизация друзей и действий.
| Элемент | Описание |
|---|---|
|
cacheFriends |
Указывает, разрешает ли поставщик OSC хранить друзей в качестве элементов контакта Outlook. OSC проверяет cacheFriends только в том случае, если параметр getFriends имеет значение true. Если поставщик задает значение cacheFriends как true, OSC синхронизирует друзей путем кэширования и создает сетевую папку контактов в хранилище по умолчанию пользователя для контактов друзей. Имя папки контактов для конкретной сети — это значение свойства ISocialProvider::SocialNetworkName . Если поставщик устанавливает cacheFriends как false, OSC не создает сетевую папку контактов для контактов друзей для хранения друзей. |
|
contactSyncRestartInterval |
Определяет интервал повтора (в минутах) между попытками синхронизации сведений друзей из социальной сети, если возникает ошибка синхронизации. OSC использует этот элемент только в том случае, если поставщик OSC поддерживает кэшированную синхронизацию или гибридную синхронизацию друзей с папкой контактов для социальной сети (cacheFriends имеет значение true). Интервал повтора по умолчанию составляет 30 минут, если значение по умолчанию не переопределено ключом ContactSyncRestartInterval в разделе HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\SocialConnector. Если поставщик задает contactSyncRestartInterval, значение поставщика переопределит интервал повторных попыток по умолчанию, равный 30 минутам, или значение раздела реестра. Дополнительные сведения о синхронизации сведений о друзьях и других пользователях по запросу см. в разделе Синхронизация друзей и действий. |
Следующие элементы применяются только к синхронизации по запросу или гибридной синхронизации друзей и не друзей.
| Элемент | Описание |
|---|---|
|
dynamicContactsLookup |
Указывает, поддерживает ли поставщик OSC вызов ISocialSession2::GetPeopleDetails для синхронизации друзей по запросу. OSC проверяет dynamicContactsLookup , только если параметр getFriends имеет значение true. Параметр по умолчанию для dynamicContactsLookup — false. Если поставщик OSC указывает dynamicContactsLookup как true, а getFriends — true, OSC вызывает ISocialSession2::GetPeopleDetails при каждом обновлении области Люди. Область Люди обновляется, когда пользователь выбирает другого пользователя в области Люди или другой элемент в окне обозревателя Outlook или открывает окно инспектора Outlook. Динамический поиск контактов гарантирует, что пользователь всегда будет видеть последние изображения пользователей и сведения профиля в области Люди, но увеличивает количество звонков от поставщика в социальную сеть. Если поставщик задает значение dynamicContactsLookup как false, OSC не вызывает ISocialSession2::GetPeopleDetails для обновления области Люди. |
|
showOnDemandContactsWhenMinimized |
Указывает, должна ли OSC выполнять синхронизацию по запросу для друзей и не друзей при сворачивании области Люди. |
Возможности поддержки действий
Следующий элемент применяется к любой форме синхронизации действий, поддерживаемой поставщиком OSC.
| Элемент | Описание |
|---|---|
|
Getactivities |
Указывает, поддерживает ли поставщик вызовы методов ISocialSession2::GetActivitiesEx или ISocialPerson::GetActivities . Если поставщик задает getActivities как true, OSC использует значение cacheActivities или dynamicActivitiesLookupEx , чтобы определить, разрешено ли на сайте социальной сети хранить действия в виде элементов OUTLOOK RSS или действий в памяти. Если поставщик устанавливает getActivities как false, социальная сеть не поддерживает действия и методы ISocialSession2::GetActivitiesEx и ISocialPerson::GetActivities , а OSC игнорирует значения cacheActivities и dynamicActivitiesLookupEx. |
Следующий элемент применяется только к кэшированной синхронизации или гибридной синхронизации действий.
| Элемент | Описание |
|---|---|
|
cacheActivities |
Начиная с Outlook Social Connector 2013, OSC игнорирует этот элемент, так как поставщики больше не могут синхронизировать действия, кэшируя их в скрытой папке в хранилище пользователя. Если поставщик поддерживает действия, поставщик должен поддерживать синхронизацию действий по запросу. Поставщик задает значение cacheActivities как false , а dynamicActivitesLookupEx — значение true. OSC синхронизирует действия по запросу и кэширует действия в памяти. Кэш памяти действий обновляется с интервалом в 30 минут. |
Следующие элементы применяются только к синхронизации по запросу или гибридной синхронизации действий.
| Элемент | Описание |
|---|---|
|
dynamicActivitiesLookup |
Не рекомендуется использовать в OSC 1.1. Начиная с ВЕРСИИ OSC 1.1, OSC больше не вызывает ISocialSession::GetActivities и игнорирует значение dynamicActivitiesLookup. Для поддержки подстановки действий по запросу задайте для cacheActivitiesзначение false , а getActivities и dynamicActivitiesLookupEx — значение true, а OSC вызовет ISocialSession2::GetActivitiesEx. |
|
dynamicActivitiesLookupEx |
Указывает, поддерживает ли поставщик OSC вызов ISocialSession2::GetActivitiesEx для синхронизации действий по запросу. Если поставщик OSC поддерживает синхронизацию действий по запросу, он устанавливает значение getActivities и dynamicActivitiesLookupEx как true, а cacheActivities — значение false. OSC вызывает ISocialSession2::GetActivitiesEx при каждом обновлении области Люди. Область Люди обновляется, когда пользователь изменяет выбранный элемент в окне обозревателя Outlook или открывает окно инспектора Outlook. Динамический поиск действий гарантирует, что пользователь всегда будет видеть последние действия в области Люди, но увеличит количество звонков от поставщика в социальную сеть. Если поставщик задает параметр dynamicActivitiesLookupEx как false, OSC не вызывает ISocialSession2::GetActivitiesEx для людей, отображаемых в области Люди. |
|
showOnDemandActivitiesWhenMinimized |
Указывает, должна ли OSC выполнять синхронизацию по запросу для действий при сворачивании области Люди. |
Общие возможности для поддержки по запросу или гибридной синхронизации друзей, не друзей и действий
| Элемент | Описание |
|---|---|
|
hashFunction |
Указывает хэш-функцию, которую поддерживает поставщик OSC. Чтобы защитить личную информацию пользователей, которые не находятся в социальной сети или бизнес-приложении поставщика, OSC передает хэшированные адреса электронной почты в ISocialSession2::GetPeopleDetails и ISocialSession2::GetActivitiesEx. Если параметр dynamicContactsLookup имеет значение true или dynamicActivitiesLookupEx имеет значение true, поставщик должен задать для hashFunction одно из допустимых значений: SHA1, MD5 или CRC32MD5. Если функция hashFunction отсутствует или указывает неверное значение, OSC возвращает ошибку.
SHA1 — это Internet Engineering Task Force (IETF) US Secure Hash Algorithm 1, определенный [RFC3174]. Например, хэш-код SHA1 адреса melissa@contoso.com электронной почты имеет значение bb81577b567262a21a4df5f6e335c1250acd7b50.
MD5 — это алгоритм MD5 Message-Digest, определенный [RFC1321]. Например, хэш-код MD5 адреса melissa@contoso.com электронной почты имеет значение c8c39e61ca1662477b39b83d7b0a0615.
CRC32MD5 представляет собой сочетание CRC32 и MD5 , определенных следующим образом:Нормализуйте адрес электронной почты, удалив начальные и конечные пробелы и преобразуя все символы в нижний регистр. Вычислить значение CRC32 для нормализованного адреса электронной почты и использовать десятичное целое представление этого значения. Если реализация возвращает целые числа со знаком, необходимо преобразовать целое число со знаком в целое число без знака. Вычислить значение MD5 для нормализованного адреса электронной почты и использовать шестнадцатеричное представление этого значения (в нижнем регистре для A–F). Объедините эти два значения с символом подчеркивания. Например, CRC32MD5 хэш-значение адреса melissa@contoso.com электронной почты — 2149665315_c8c39e61ca1662477b39b83d7b0a0615. |
Возможности для поддержки проверки подлинности и настройки учетной записи
| Элемент | Описание |
|---|---|
|
allowChangesToAutoConfigure |
Указывает, разрешает ли социальная сеть пользователю изменять параметры автоматической настройки, например предоставлять другой URL-адрес для входа. |
|
createAccountUrl |
Если поставщик задает параметр hideHyperlinks как false, когда пользователь нажимает кнопку Щелкните здесь, чтобы создать учетную запись в диалоговом окне Конфигурация учетной записи , в браузере по умолчанию откроется URL-адрес, указанный в файле createAccountUrl . |
|
displayUrl |
Указывает, должна ли OSC отображать текстовое поле URL-адрес для социальной сети в диалоговом окне конфигурации учетной записи. |
|
forgotPasswordUrl |
Если поставщик устанавливает параметр hideHyperlinks как false, когда пользователь нажимает кнопку Забыли пароль? в диалоговом окне Конфигурация учетной записи , в браузере по умолчанию откроется URL-адрес, указанный параметром forgotPasswordUrl . |
|
hideHyperlinks |
Указывает, должна ли OSC скрывать гиперссылки Щелкните здесь, чтобы создать учетную запись , и Забыли пароль? в диалоговом окне конфигурация учетной записи. OSC 1.0 игнорирует этот параметр, а гиперссылки всегда скрыты. OSC 1.1 отслеживает значение этого параметра. |
|
hideRememberMyPassword |
Указывает, должна ли OSC скрывать поле Запомнить пароль проверка в диалоговом окне Конфигурация учетной записи. Если поставщик задает параметр hideRememberMyPassword как true, OSC будет действовать так, как если бы флажок Запомнить пароль снят и не сохранит пароль. Если поставщик задает параметр hideRememberMyPassword как false, osC отобразит поле Запомнить пароль проверка в диалоговом окне конфигурация учетной записи. |
|
supportsAutoConfigure |
Указывает, должна ли OSC вызывать функцию GetAutoConfiguredSession в интерфейсе ISocialProvider для попытки автоматической настройки и входа пользователя в социальную сеть. |
|
useLogonCached |
Указывает, поддерживает ли поставщик OSC вызов ISocialSession2::LogonCached для входа с кэшируемыми учетными данными. Если поставщик задает параметр useLogonCached как true, OSC игнорирует параметр для useLogonWebAuth , а OSC вызывает ISocialSession2::LogonCached для проверки подлинности. Если поставщик задает параметр dynamicActivitiesLookupEx как false, OSC не вызывает ISocialSession2::LogonCached для проверки подлинности. |
|
useLogonWebAuth |
Указывает, должна ли OSC использовать проверку подлинности на основе форм и метод ISocialSession::LogonWeb . Если поставщик задает значение useLogonWebAuth как false, OSC использует обычную проверку подлинности и вызывает метод ISocialSession::Logon . Если поставщик задает значение useLogonWebAuth как true, OSC использует проверку подлинности на основе форм и вызывает ISocialSession::LogonWeb. |
В зависимости от возможностей XML,возвращаемых поставщиком в методе ISocialProvider::GetCapabilities , диалоговое окно конфигурации учетной записи изменяется. Например, на рисунке 1 показано диалоговое окно конфигурации учетной записи для примера TestProvider.
Рис. 1. Пример TestProvider в диалоговом окне конфигурации учетной записи
