XML para amigos

El elemento friends del esquema XML del proveedor de Microsoft Outlook Social Connector (OSC) permite a un proveedor de OSC especificar información para una lista de personas asociadas a un usuario de Outlook en la red social. Si el proveedor de OSC admite la sincronización almacenada en caché, esta lista de personas solo contendrá amigos del usuario de Outlook en la red social. Si el OSC admite la sincronización a petición o híbrida, esta lista puede contener amigos y no amigos del usuario de Outlook.

Cada persona de la lista se representa como un elemento person en el esquema XML, que admite detalles como el nombre, el apellido y las direcciones de correo electrónico. Los proveedores de OSC usan los elementos friends y person , independientemente de cómo quieran que el OSC sincronice la información de amigos de la red social. Tenga en cuenta que los elementos secundarios de la persona son similares a algunas de las propiedades de un contacto de Outlook, lo que facilita el almacenamiento de amigos en una carpeta de contactos de Outlook específica de la red social, si la red social admite la sincronización híbrida o caché de amigos en una carpeta de contactos de Outlook.

Escenarios de ejemplo

En los escenarios de ejemplo siguientes se muestran las llamadas API de extensibilidad del proveedor de OSC que implementa un proveedor de OSC y que realiza el OSC para obtener información de confianza. La información se expresa en cadenas XML que se ajustan al esquema XML del proveedor de OSC.

Para ver un ejemplo de XML de amigos, vea Ejemplo XML de amigos. Para obtener más información sobre cómo sincronizar la información de los amigos, vea Sincronizar amigos y actividades.

Escenario 1: obtener una lista de amigos

Escenario 1: OSC obtiene una lista de amigos, un objeto ISocialPerson y una imagen para cada amigo:

1. Un proveedor de OSC que admite mostrar amigos desde el sitio de red social y permitir que el OSC almacene en caché la información de confianza indica que en el OSC mediante los elementos getFriends y cacheFriends , que son elementos secundarios del elemento capabilities .

2. El proveedor de OSC también implementa los métodos ISocialProvider::GetCapabilities, ISocialSession::GetPerson, ISocialPerson::GetFriendsAndColleagues y ISocialPerson::GetPicture .

3. El OSC llama a ISocialProvider::GetCapabilities para comprobar el valor de los siguientes elementos: getFriends para comprobar que el proveedor de OSC admite la presentación de amigos de la red social y cacheFriends para comprobar que el proveedor admite el almacenamiento en caché de amigos.

4. El OSC llama a ISocialSession::GetPerson para obtener un objeto ISocialPerson para el usuario de Outlook.

5. El OSC llama a ISocialPerson::GetFriendsAndColleagues para obtener la lista de amigos del usuario de Outlook devuelta en la cadena del parámetro personCollection . La cadena personCollection cumple con la definición de esquema XML para el elemento friends en el esquema XML.

6. Para cada amigo de la cadena XML personCollection , el OSC obtiene el valor del elemento userID para llamar a ISocialSession::GetPerson para obtener un objeto ISocialPerson para ese amigo.

7. Para cada amigo de la cadena XML personCollection , el OSC llama a ISocialPerson::GetPicture para obtener un recurso de imagen para ese amigo.

   El OSC puede realizar más llamadas en el objeto ISocialPerson para obtener actividades y detalles (por ejemplo, direcciones de correo electrónico) de ese amigo.

Escenario 2: sincronizar amigos

Escenario 2: OSC sincroniza los amigos dinámicamente:

1. Un proveedor de OSC que admite la sincronización a petición de amigos y no amigos indica que al OSC mediante los elementos getFriends y dynamicContactsLookup . El proveedor de OSC también establece el elemento hashFunction . Los tres elementos son elementos secundarios de las funcionalidades.

2. El proveedor de OSC también implementa el método ISocialSession2::GetPeopleDetails .

3. El OSC llama a ISocialProvider::GetCapabilities para comprobar los valores de getFriends y dynamicContactsLookup para comprobar que el proveedor de OSC admite amigos y sincronización a petición de amigos y no amigos. El OSC también toma nota del valor de hashFunction compatible con el proveedor de OSC.

4. Para cada usuario que se muestra en el panel de Personas, el OSC recopila la dirección de correo electrónico del usuario y la cifra mediante la función hash especificada en hashFunction. Esto forma una cadena XML que se ajusta a la definición de esquema XML para el elemento hashedAddresses .

5. El OSC llama a ISocialSession2::GetPeopleDetails, proporcionando esta cadena XML de direcciones hash como el parámetro personAddresses , para obtener dinámicamente los detalles actualizados de las personas en el parámetro peopleCollection . La cadena de parámetro personsCollection cumple con la definición de esquema XML para el elemento friends en el esquema XML.

Elementos primarios y secundarios

A continuación se muestran los dos elementos de nivel superior del esquema de amigos .

Elemento	Descripción
Amigos	Representa el elemento raíz de una lista de elementos person . ISocialPerson::GetFriendsAndColleagues, ISocialSession::FindPerson y ISocialSession2::GetPeopleDetails devuelven cadenas XML que se ajustan a la definición de esquema del elemento friends.
person	Representa a una persona en una lista de elementos person . El método ISocialPerson::GetDetails devuelve una cadena XML que se ajusta a la definición de esquema del elemento person .

En la tabla siguiente se describe cada elemento secundario del elemento person en el esquema XML del proveedor de OSC.

Para obtener una definición completa del esquema XML del proveedor de OSC, incluidos los elementos necesarios u opcionales, vea Esquema XML del proveedor de Outlook Social Connector.

Elemento	Descripción
address	Dirección callejera física de la persona.
Aniversario	Fecha de aniversario de un evento para la persona.
askmeabout	Temas de interés o experiencia de la persona.
Cumpleaños	Fecha de nacimiento de la persona.
businessAddress	Dirección callejera física del lugar de trabajo de la persona.
businessCity	Ciudad para el lugar de trabajo de la persona.
businessCountryOrRegion	País o región del lugar de trabajo de la persona.
businessState	Estado o provincia del lugar de trabajo de la persona.
businessZip	Código postal o postal del lugar de trabajo de la persona.
celda	Número de teléfono móvil de la persona.
Ciudad	Ciudad de la dirección física de la persona.
company	Nombre de la empresa asociada a la persona.
countryOrRegion	País o región de la dirección física de la persona.
creationTime	Hora de creación del perfil de la persona en la red social.
emailAddress	Dirección de correo electrónico principal de la persona.
emailAddress2	Dirección de correo electrónico secundaria de la persona.
emailAddress3	Dirección de correo electrónico terciaria de la persona.
expirationTime	Hora en que expiran los datos de perfil de la persona en la red social.
fileAs	Cadena por la que se va a presentar a la persona como contacto en un archivo de contactos de Outlook.
firstName	Nombre o nombre dado de la persona.
friendStatus	Estado de amigo de esta persona con el usuario que ha iniciado sesión en la red social. Debe ser uno de los siguientes valores: friend, nonfriend, pending, pendingin, pendingout.
Fullname	Nombre completo de la persona.
Género	Sexo de la persona. Debe ser uno de los siguientes valores: hombre, mujer, sin especificar.
homePhone	Número de teléfono principal de la persona.
index	Ubicación de la dirección hash de la persona en el parámetro de cadena peopleAddresses pasado a una llamada al método ISocialSession2::GetPeopleDetails . También indica el XML de persona de la persona en la cadena peopleCollection devuelta por GetPeopleDetails.
Industrias	Industrias en las que está involucrada la persona.
interests	Intereses o aficiones de la persona.
lastModificationTime	Hora de la última modificación del perfil de la persona en la red social.
lastName	Apellido o apellido de la persona.
location	Ubicación de la persona.
Apodo	Nombre más corto o nombre inventado de la persona.
otherAddress	Dirección alternativa de la persona.
otherCity	Ciudad de la dirección alternativa de la persona.
otherCountryOrRegion	País o región de la dirección alternativa de la persona.
otherState	Estado o provincia de la dirección alternativa de la persona.
otherZip	Código postal o postal de la dirección alternativa de la persona.
Teléfono	Número de teléfono de contacto principal de la persona.
pictureUrl	Dirección URL de una imagen de perfil de la persona.
Relación	Relación de esta persona con el usuario que ha iniciado sesión.
schools	Las escuelas a las que va o va la persona.
skills	Habilidades personales de la persona.
state	Estado o provincia de la dirección física de la persona.
title	Designación agregada al nombre de la persona.
Userid	Id. para identificar a la persona en la red social.
webProfilePage	Dirección de página web que contiene un perfil de la persona.
Sitio web	Sitio web de la persona.
workPhone	Número de teléfono comercial de la persona.
Zip	Código postal o código postal de la dirección física de la persona.

Vea también

• Ejemplo XML de amigos
• Sincronización de amigos y actividades
• XML para funcionalidades
• XML para actividades
• Desarrollo de un proveedor con el esquema XML de OSC