Elementos XML de capacidades
En las tablas de este tema se describen los elementos secundarios de las funcionalidades XML y se agrupan por las áreas que admiten. El valor predeterminado de cada elemento capabilities es false. Si el elemento no se especifica en el XML de capacidades devuelto por el método ISocialProvider::GetCapabilities , el valor del elemento es igual a false.
Para obtener una descripción general de las funcionalidades XML, consulte XML for Capabilities. Para obtener un ejemplo de XML de funcionalidades , vea Ejemplo XML de funcionalidades. Para obtener una definición completa del esquema XML del proveedor de Microsoft Outlook Social Connector (OSC), incluidos los elementos necesarios u opcionales, consulte Esquema XML del proveedor de Outlook Social Connector.
Capacidades para admitir amigos
En la tabla siguiente se muestran los elementos que se aplican a cualquier forma de sincronización de amigos o no amigos.
| Elemento | Descripción |
|---|---|
|
doNotFollowPerson |
Indica si el proveedor admite la llamada al método ISocialSession::UnFollowPerson . followPerson y doNotFollowPerson son características independientes de un proveedor de OSC. Un proveedor de OSC puede indicar la capacidad de poder agregar una persona como amigo (estableciendo followPerson en true) o poder quitar una persona como amigo en una cuenta de red social (estableciendo doNotFollowPerson en true). En general, ser capaz de seguir no implica ser capaz de dejar de seguir. followPerson es una funcionalidad y no debe interpretarse erróneamente como una acción para seguir a una persona específica o a todas las personas de la cuenta de red social. el hecho de que followPerson sea true no implica que doNotFollowPerson sea false. |
|
followPerson |
Indica si el proveedor admite la llamada al método ISocialSession::FollowPerson . El OSC comprueba followPerson si cacheFriends es true (sincronización en caché de amigos), dynamicContactsLookup es true (sincronización a petición de amigos y no amigos) o cacheFriends y dynamicContactsLookup son true (sincronización híbrida de amigos y no amigos). Si el proveedor establece followPerson como true, el OSC muestra un distintivo de red en el panel de Personas para las personas que el usuario está siguiendo y habilita el comando on <NetworkName> en el menú Agregar (+) del panel de Personas. Si el proveedor establece followPerson como false, no se muestra el distintivo de red y el comando on <NetworkName> está oculto. |
|
getFriends |
Indica si el proveedor admite la llamada al método ISocialPerson::GetFriendsAndColleagues o ISocialSession2::GetPeopleDetails . Si el proveedor establece getFriends como true, el OSC usa el valor de cacheFriends o dynamicContactsLookup para determinar si la red social permite almacenar amigos como elementos de contacto de Outlook o en la memoria. Si el proveedor establece getFriends como false, la red social no admite amigos y los métodos ISocialPerson::GetFriendsAndColleagues e ISocialSession2::GetPeopleDetails , y el OSC omite los valores de cacheFriends y dynamicContactsLookup. |
Los siguientes elementos solo se aplican a la sincronización almacenada en caché de amigos o a la sincronización híbrida de amigos y no amigos. Para obtener más información sobre la sincronización de amigos, consulte Sincronización de amigos y actividades.
| Elemento | Descripción |
|---|---|
|
cacheFriends |
Indica si el proveedor de OSC permite almacenar amigos como elementos de contacto de Outlook. El OSC comprueba cacheFriends solo si getFriends es true. Si el proveedor establece cacheFriends como true, el OSC sincroniza a los amigos mediante el almacenamiento en caché y crea una carpeta de contactos específica de la red en el almacén predeterminado del usuario para los contactos de confianza. El nombre de la carpeta de contactos específicos de la red es el valor de la propiedad ISocialProvider::SocialNetworkName . Si el proveedor establece cacheFriends como false, el OSC no crea una carpeta de contactos específica de la red para que los contactos de confianza almacenen amigos. |
|
contactSyncRestartInterval |
Determina el intervalo de reintentos, en minutos, entre los intentos de sincronizar la información de los amigos desde la red social, si se produce un error de sincronización. El OSC usa este elemento solo si el proveedor de OSC admite la sincronización almacenada en caché o la sincronización híbrida de amigos en una carpeta de contactos específica de la red social (cacheFriends es true). El intervalo de reintento predeterminado es de 30 minutos, a menos que la ContactSyncRestartInterval clave HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\SocialConnectoren . Si el proveedor establece contactSyncRestartInterval, el valor del proveedor invalidará el intervalo de reintento predeterminado de 30 minutos o el valor de clave del Registro. Para obtener más información sobre la sincronización de amigos y no amigos a petición, consulta Sincronizar amigos y actividades. |
Los siguientes elementos se aplican solo a la sincronización a petición o la sincronización híbrida de amigos y no amigos.
| Elemento | Descripción |
|---|---|
|
dynamicContactsLookup |
Indica si el proveedor de OSC admite la llamada ISocialSession2::GetPeopleDetails para la sincronización a petición de amigos y no amigos. El OSC comprueba dynamicContactsLookup solo si getFriends es true. La configuración predeterminada para dynamicContactsLookup es false. Si el proveedor de OSC especifica dynamicContactsLookup como true y getFriends como true, el OSC llama a ISocialSession2::GetPeopleDetails cada vez que se actualiza el panel de Personas. El panel de Personas se actualiza cuando el usuario selecciona otro usuario en el panel de Personas u otro elemento de la ventana del Explorador de Outlook, o abre una ventana del inspector de Outlook. La búsqueda dinámica de contactos garantiza que el usuario siempre ve las imágenes de usuario y la información de perfil más recientes en el panel de Personas, pero aumenta el número de llamadas del proveedor a la red social. Si el proveedor establece dynamicContactsLookup como false, el OSC no llama a ISocialSession2::GetPeopleDetails para actualizar el panel de Personas. |
|
showOnDemandContactsWhenMinimized |
Indica si el OSC debe llevar a cabo la sincronización a petición para amigos y no amigos cuando se minimiza el panel de Personas. |
Funcionalidades para actividades de soporte técnico
El siguiente elemento se aplica a cualquier forma de sincronización de actividades admitidas por el proveedor de OSC.
| Elemento | Descripción |
|---|---|
|
getActivities |
Indica si el proveedor admite las llamadas al método ISocialSession2::GetActivitiesEx o ISocialPerson::GetActivities . Si el proveedor establece getActivities como true, el OSC usa el valor de cacheActivities o dynamicActivitiesLookupEx para determinar si el sitio de red social permite almacenar actividades como elementos RSS de Outlook o como actividades en memoria. Si el proveedor establece getActivities como false, la red social no admite actividades y los métodos ISocialSession2::GetActivitiesEx e ISocialPerson::GetActivities , y el OSC omite los valores de cacheActivities y dynamicActivitiesLookupEx. |
El siguiente elemento solo se aplica a la sincronización almacenada en caché o a la sincronización híbrida de actividades.
| Elemento | Descripción |
|---|---|
|
cacheActivities |
A partir de Outlook Social Connector 2013, el OSC omite este elemento, ya que los proveedores ya no pueden sincronizar las actividades almacenandolas en caché en una carpeta oculta en el almacén del usuario. Si el proveedor admite actividades, el proveedor debe admitir actividades de sincronización a petición. El proveedor establece cacheActivities como false y establece dynamicActivitesLookupEx como true. El OSC sincroniza las actividades a petición y almacena en caché las actividades en la memoria. La memoria caché de actividades se actualiza en un intervalo de 30 minutos. |
Los siguientes elementos se aplican solo a la sincronización a petición o a la sincronización híbrida de actividades.
| Elemento | Descripción |
|---|---|
|
dynamicActivitiesLookup |
En desuso en OSC 1.1. A partir de OSC 1.1, el OSC ya no llama a ISocialSession::GetActivities y omite el valor de dynamicActivitiesLookup. Para admitir la búsqueda de actividades a petición, establezca cacheActivities como false y getActivities y dynamicActivitiesLookupEx como true, y el OSC llamará a ISocialSession2::GetActivitiesEx. |
|
dynamicActivitiesLookupEx |
Indica si el proveedor de OSC admite la llamada ISocialSession2::GetActivitiesEx para la sincronización a petición de actividades. Si el proveedor de OSC admite la sincronización de actividades a petición, establece getActivities y dynamicActivitiesLookupEx como true y cacheActivities como false. El OSC llama a ISocialSession2::GetActivitiesEx cada vez que se actualiza el panel de Personas. El panel de Personas se actualiza cuando el usuario cambia el elemento seleccionado en la ventana del Explorador de Outlook o abre una ventana del inspector de Outlook. La búsqueda de actividades dinámicas garantiza que el usuario siempre verá las actividades más recientes en el panel de Personas, pero aumentará el número de llamadas del proveedor a la red social. Si el proveedor establece dynamicActivitiesLookupEx como false, el OSC no llama a ISocialSession2::GetActivitiesEx para las personas que se muestran en el panel de Personas. |
|
showOnDemandActivitiesWhenMinimized |
Indica si el OSC debe llevar a cabo la sincronización a petición para las actividades cuando se minimiza el panel de Personas. |
Funcionalidades comunes para admitir la sincronización a petición o híbrida de amigos, no amigos y actividades
| Elemento | Descripción |
|---|---|
|
hashFunction |
Especifica la función hash que admite el proveedor de OSC. Para proteger la información de identificación personal de los usuarios que no están en la red social del proveedor o en la aplicación de línea de negocio, el OSC pasa las direcciones de correo electrónico hash a ISocialSession2::GetPeopleDetails e ISocialSession2::GetActivitiesEx. Si dynamicContactsLookup se establece en true o dynamicActivitiesLookupEx se establece en true, el proveedor debe establecer hashFunction en uno de los valores permitidos: SHA1, MD5 o CRC32MD5. Si falta hashFunction o especifica un valor incorrecto, el OSC devuelve un error.
SHA1 es el algoritmo hash seguro de EE. UU. 1 del Grupo de tareas de ingeniería de Internet (IETF) definido por [RFC3174]. Por ejemplo, el valor hash SHA1 de la dirección melissa@contoso.com de correo electrónico es bb81577b567262a21a4df5f6e335c1250acd7b50.
MD5 es el algoritmo de Message-Digest MD5 del Grupo de tareas de ingeniería de Internet (IETF) definido por [RFC1321]. Por ejemplo, el valor hash MD5 de la dirección melissa@contoso.com de correo electrónico es c8c39e61ca1662477b39b83d7b0a0615.
CRC32MD5 es una combinación de CRC32 y MD5 definida de la siguiente manera:Normalice la dirección de correo electrónico quitando el espacio en blanco inicial y final y convirtiendo todos los caracteres en minúsculas. Calcule el valor de CRC32 para la dirección de correo electrónico normalizada y use la representación de entero decimal de este valor. Si la implementación devuelve enteros con signo, debe convertir el entero con signo en un entero sin signo. Calcule el valor md5 de la dirección de correo electrónico normalizada y use la representación hexadecimal de este valor (con minúsculas para A a F). Combine estos dos valores con un carácter de subrayado. Por ejemplo, el valor hash CRC32MD5 de la dirección melissa@contoso.com de correo electrónico es 2149665315_c8c39e61ca1662477b39b83d7b0a0615. |
Funcionalidades para admitir la autenticación y la configuración de la cuenta
| Elemento | Descripción |
|---|---|
|
allowChangesToAutoConfigure |
Indica si la red social permite al usuario cambiar la configuración automática, como proporcionar una dirección URL diferente para iniciar sesión. |
|
createAccountUrl |
Si el proveedor establece hideHyperlinks como false, cuando el usuario hace clic en Haga clic aquí para crear una cuenta en el cuadro de diálogo Configuración de la cuenta , la dirección URL especificada por createAccountUrl se abre en el explorador predeterminado. |
|
displayUrl |
Indica si el OSC debe mostrar el cuadro de texto Dirección URL de la red social en el cuadro de diálogo de configuración de la cuenta. |
|
forgotPasswordUrl |
Si el proveedor establece hideHyperlinks como false, cuando el usuario hace clic en ¿Olvidó la contraseña? en el cuadro de diálogo Configuración de la cuenta , la dirección URL especificada por forgotPasswordUrl se abre en el explorador predeterminado. |
|
hideHyperlinks |
Indica si el OSC debe ocultar los hipervínculos Haga clic aquí para crear una cuenta y ¿Olvidó la contraseña? en el cuadro de diálogo de configuración de la cuenta. OSC 1.0 omite esta configuración y los hipervínculos siempre están ocultos. OSC 1.1 observa el valor de esta configuración. |
|
hideRememberMyPassword |
Indica si el OSC debe ocultar la casilla Recordar mi contraseña en el cuadro de diálogo de configuración de la cuenta. Si el proveedor establece hideRememberMyPassword como true, el OSC actuará como si la casilla Recordar mi contraseña estuviera desactivada y no guardara la contraseña. Si el proveedor establece hideRememberMyPassword como false, el OSC mostrará la casilla Recordar mi contraseña en el cuadro de diálogo de configuración de la cuenta. |
|
supportsAutoConfigure |
Indica si el OSC debe llamar a la función GetAutoConfiguredSession en la interfaz ISocialProvider para intentar la configuración automática e iniciar sesión en la red social del usuario. |
|
useLogonCached |
Indica si el proveedor de OSC admite la llamada ISocialSession2::LogonCached para iniciar sesión con credenciales almacenadas en caché. Si el proveedor establece useLogonCached como true, el OSC omite la configuración de useLogonWebAuth y el OSC llama a ISocialSession2::LogonCached para la autenticación. Si el proveedor establece dynamicActivitiesLookupEx como false, el OSC no llama a ISocialSession2::LogonCached para la autenticación. |
|
useLogonWebAuth |
Indica si el OSC debe usar la autenticación basada en formularios y el método ISocialSession::LogonWeb . Si el proveedor establece useLogonWebAuth como false, el OSC usa la autenticación básica y llama al método ISocialSession::Logon . Si el proveedor establece useLogonWebAuth como true, el OSC usa la autenticación basada en formularios y llama a ISocialSession::LogonWeb. |
En función de las funcionalidades XML devueltas por el proveedor en el método ISocialProvider::GetCapabilities , el cuadro de diálogo de configuración de la cuenta cambia. Por ejemplo, en la figura 1 se muestra el cuadro de diálogo de configuración de la cuenta para un ejemplo de TestProvider.
Figura 1. Ejemplo de TestProvider en el cuadro de diálogo de configuración de la cuenta
