Compartilhar via

XML para atividades

  • Artigo

Este tópico contém um cenário de exemplo que mostra que a API de extensibilidade do provedor do Outlook Social Connector (OSC) chama que um provedor OSC implementa e o OSC faz para obter informações sobre as atividades. As informações são expressas em cadeias de caracteres XML que estão em conformidade com o esquema XML do provedor OSC.

O esquema XML do provedor OSC permite que um provedor osC defina atividades. As informações de atividade podem incluir a rede social em que os itens do feed de atividades se originaram, detalhes de cada item do feed de atividades (como proprietário, tipo e data de publicação da atividade) e o modelo para exibir a atividade. Para dar suporte à exibição de atividades no Painel de Pessoas ou Cartão de Contato, o provedor OSC de uma rede social deve implementar e retornar as atividades corretas XML. Para obter um exemplo de XML do feed de atividades, consulte Exemplo XML do Feed de Atividades. Para obter mais informações sobre como sincronizar as atividades dos amigos, confira Sincronizando amigos e atividades. Para obter uma definição completa do esquema XML do provedor OSC, inclusive de quais elementos são obrigatórios ou opcionais, confira o Esquema XML do Provedor do Outlook Social Connector.

No cenário a seguir, o OSC sincroniza dinamicamente as atividades de uma pessoa selecionada no painel Pessoas e obtém detalhes sobre essa pessoa:

  1. Um provedor OSC que dá suporte à sincronização sob demanda de atividades indica isso para o OSC usando os elementos getActivities e dynamicActivitiesLookupEx . O provedor OSC também define o elemento hashFunction. Todos os três elementos são elementos filhos de capabilities.

  2. O provedor OSC implementa os métodos ISocialProvider::GetCapabilities e ISocialSession2::GetActivitiesEx .

  3. O OSC chama ISocialProvider::GetCapabilities para marcar o valor de getActivities e dynamicActivitiesLookupEx para verificar se o provedor OSC dá suporte à sincronização sob demanda das atividades. O OSC também observa o valor do elemento hashFunction com suporte do provedor OSC.

  4. O OSC atualiza o painel Pessoas ou Cartão de Contato para permitir que o usuário veja as atividades mais recentes da pessoa selecionada. O OSC criptografa o endereço SMTP da pessoa usando a função de hash especificada no elemento hashFunction , formando uma cadeia de caracteres XML que está em conformidade com a definição de esquema XML para o elemento hashedAddresses .

  5. O OSC chama ISocialSession2::GetActivitiesEx, fornecendo essa cadeia de caracteres XML do endereço hash como o parâmetro hashedAddresses , para obter uma coleção atual de atividades para essa pessoa no parâmetro de atividades . A cadeia de caracteres do parâmetro de atividades está em conformidade com a definição de esquema XML do elemento activityFeed .

  6. Com base na definição de esquema XML para activityFeed, o OSC analisa ainda mais a cadeia de atividades para descobrir o tipo, a data de publicação e outras informações sobre cada atividade e como exibir a atividade.

  7. Para obter detalhes sobre a pessoa selecionada, o OSC chama ISocialSession2::GetPeopleDetails, fornecendo a mesma cadeia de caracteres XML de endereços hashed que o argumento para o parâmetro personsAddresses . Os detalhes sobre a pessoa são retornados no parâmetro personsCollection . Esses detalhes podem incluir firstName, lastName e emailAddress. O parâmetro personsCollection está em conformidade com a definição de esquema XML para o elemento pessoa .

Você pode encontrar mais informações sobre como especificar XML para atividades nos seguintes tópicos desta seção:

Confira também