Compartir a través de

XML de actividades

  • Artículo

Este tema contiene un escenario de ejemplo que muestra las llamadas API de extensibilidad del proveedor de Outlook Social Connector (OSC) que implementa un proveedor de OSC y que realiza el OSC para obtener información sobre las actividades. La información se expresa en cadenas XML que se ajustan al esquema XML del proveedor de OSC.

El esquema XML del proveedor de OSC permite a un proveedor de OSC definir actividades. La información de actividad puede incluir la red social donde se originaron los elementos de fuente de actividad, los detalles de cada elemento de fuente de actividad (como propietario, tipo y fecha de publicación de la actividad) y la plantilla para mostrar la actividad. Para admitir la presentación de actividades en el panel de Personas o la tarjeta de contacto, el proveedor de OSC de una red social debe implementar y devolver el XML de actividades correctas. Para obtener un ejemplo de XML de fuente de actividad, vea Ejemplo XML de fuente de actividad. Para obtener más información sobre cómo sincronizar las actividades de los amigos, consulta Sincronizar amigos y actividades. 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.

En el escenario siguiente, el OSC sincroniza dinámicamente las actividades de una persona seleccionada en el panel de Personas y obtiene detalles sobre esa persona:

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

  2. El proveedor de OSC implementa los métodos ISocialProvider::GetCapabilities e ISocialSession2::GetActivitiesEx .

  3. El OSC llama a ISocialProvider::GetCapabilities para comprobar el valor de getActivities y dynamicActivitiesLookupEx para comprobar que el proveedor de OSC admite la sincronización a petición de actividades. El OSC también anota el valor del elemento hashFunction compatible con el proveedor de OSC.

  4. El OSC actualiza el panel de Personas o la tarjeta de contacto para permitir que el usuario vea las actividades más recientes de la persona seleccionada. El OSC cifra la dirección SMTP de la persona mediante la función hash especificada en el elemento hashFunction , formando una cadena XML que se ajusta a la definición de esquema XML para el elemento hashedAddresses .

  5. El OSC llama a ISocialSession2::GetActivitiesEx, proporcionando esta cadena XML de la dirección hash como el parámetro hashedAddresses , para obtener una colección actual de actividades para esa persona en el parámetro activities . La cadena de parámetro activities cumple con la definición de esquema XML del elemento activityFeed .

  6. En función de la definición de esquema XML para activityFeed, el OSC analiza aún más la cadena de actividades para averiguar el tipo, la fecha de publicación y otra información sobre cada actividad y cómo mostrar la actividad.

  7. Para obtener detalles sobre la persona seleccionada, el OSC llama a ISocialSession2::GetPeopleDetails, proporcionando la misma cadena XML de direcciones hash que el argumento para el parámetro peopleAddresses . Los detalles sobre la persona se devuelven en el parámetro personsCollection . Estos detalles pueden incluir firstName, lastName y emailAddress. El parámetro personsCollection se ajusta a la definición de esquema XML para el elemento person .

Puede encontrar más información sobre cómo especificar XML para actividades en los temas siguientes de esta sección:

Vea también