Elementos de XML de recursos

As tabelas neste tópico descrevem elementos filho do XML de recursos e estão agrupadas pelas áreas às quais oferecem suporte. O valor padrão de cada elemento capabilities é false. Se o elemento não for especificado no XML de recursos retornados pelo método ISocialProvider::GetCapabilities, o valor do elemento será igual a false.

Para obter uma descrição geral do XML de recursos, consulte XML para recursos. Para obter um exemplo do XML de recursos, consulte Exemplo do XML de recursos. Para obter uma definição completa do esquema XML do provedor Microsoft OSC (Outlook Social Connector), incluindo quais elementos são obrigatórios ou opcionais, consulte Esquema XML do provedor Outlook Social Connector.

Recursos para suporte a amigos

A tabela a seguir mostra elementos que se aplicam a qualquer forma de sincronização de amigos ou não amigos.

Elemento	Descrição
doNotFollowPerson	Indica se o provedor oferece suporte para a chamada do método ISocialSession::UnFollowPerson. followPerson e doNotFollowPerson são recursos independentes de um provedor OSC. Um provedor OSC pode indicar a capacidade de adicionar uma pessoa como amigo (definindo followPerson como true) ou de remover uma pessoa como amigo em uma conta de rede social (definindo doNotFollowPerson como true). Em geral, ser capaz de seguir não significa ser capaz de parar de seguir. followPerson é um recurso e não deve ser mal interpretado como uma ação para seguir uma pessoa específica ou todas as pessoas na conta de rede social. A definição de followPerson como true não implica que doNotFollowPerson seja false.
followPerson	Indica se o provedor oferece suporte para a chamada do método ISocialSession::FollowPerson. O OSC verifica em followPerson se cacheFriends é true (sincronização de amigos em cache), se dynamicContactsLookup é true (sincronização de amigos e não amigos sob demanda) ou se ambos cacheFriends e dynamicContactsLookup são true (sincronização híbrida de amigos e não amigos). Se o provedor definir followPerson como true, o OSC exibirá um selo de rede no Painel de Pessoas para as pessoas que o usuário está seguindo e ativará o comando on <NetworkName> no menu Adicionar (+) do Painel de Pessoas. Se o provedor definir followPerson como false, o selo de rede não será exibido, e o comando on <NetworkName> será oculto.
getFriends	Indica se o provedor oferece suporte para a chamada do método ISocialPerson::GetFriendsAndColleagues ou ISocialSession2::GetPeopleDetails. Se o provedor definir getFriends como true, o OSC usará o valor de cacheFriends ou dynamicContactsLookup para determinar se a rede social permite o armazenamento de amigos como itens de contato do Outlook ou na memória. Se o provedor definir getFriends como false, a rede social não oferecerá suporte a amigos e aos métodos ISocialPerson::GetFriendsAndColleagues e ISocialSession2::GetPeopleDetails, e o OSC ignorará os valores de cacheFriends e dynamicContactsLookup.

Os elementos a seguir aplicam-se apenas à sincronização em cache de amigos ou à sincronização híbrida de amigos e não amigos. Para obter mais informações sobre como sincronizar amigos, consulte Sincronização de amigos e atividades.

Elemento	Descrição
cacheFriends	Indica se o provedor OSC permite armazenar amigos como itens de contato do Outlook. O OSC verifica cacheFriends somente quando getFriends é true. Se o provedor definir cacheFriends como true, o OSC sincronizará amigos via armazenamento em cache e criará uma pasta de contatos específicos da rede no repositório padrão do usuário para contatos de amigos. O nome da pasta de contatos específica da rede é o valor da propriedade ISocialProvider::SocialNetworkName. Se o provedor definir cacheFriends como false, o OSC não criará uma pasta de contatos específica da rede para contatos de amigos para armazenar amigos.
contactSyncRestartInterval	Determina o intervalo de repetição, em minutos, entre tentativas de sincronizar as informações de amigos da rede social se um erro de sincronização ocorrer. O OSC usará esse elemento somente se o provedor OSC oferecer suporte à sincronização em cache ou à sincronização híbrida de amigos com uma pasta de contatos específica da rede social (cacheFriends é true). O intervalo de repetição padrão é de 30 minutos, a menos que o padrão seja substituído pela ContactSyncRestartInterval chave em HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\SocialConnector. Se o provedor definir contactSyncRestartInterval, o valor do provedor substituirá o intervalo de repetição padrão de 30 minutos ou o valor da chave do Registro. Para obter mais informações sobre como sincronizar informações de amigos e não amigos sob demanda, consulte Sincronização de amigos e atividades.

Os elementos a seguir aplicam-se apenas à sincronização sob demanda ou à sincronização híbrida de amigos e não amigos.

Elemento	Descrição
dynamicContactsLookup	Indica se o provedor OSC oferece suporte à chamada ISocialSession2::GetPeopleDetails para sincronização sob demanda de amigos e não amigos. O OSC verificará dynamicContactsLookup apenas se getFriends for true. A configuração padrão para dynamicContactsLookup é false. Se o provedor OSC especificar dynamicContactsLookup como true e getFriends como true, o OSC chamará ISocialSession2::GetPeopleDetails sempre que o Painel de Pessoas for atualizado. O Painel de Pessoas é atualizado quando o usuário seleciona outro usuário nele ou outro item na janela do explorador do Outlook ou quando abre uma janela do inspetor do Outlook. A pesquisa de contatos dinâmicos garante que o usuário sempre veja as fotos do usuário e suas informações de perfil mais recentes no Painel de Pessoas, mas aumenta o número de chamadas do provedor para a rede social. Se o provedor definir dynamicContactsLookup como false, o OSC não chamará ISocialSession2::GetPeopleDetails para atualizar o Painel de Pessoas.
showOnDemandContactsWhenMinimized	Indica se o OSC deve realizar a sincronização sob demanda para amigos e não amigos quando o Painel de Pessoas é minimizado.

Recursos para suporte a atividades

O elemento a seguir aplica-se a qualquer forma de sincronização de atividades com suporte pelo provedor OSC.

Elemento

Descrição

getActivities

Indica se o provedor oferece suporte para as chamadas do método ISocialSession2::GetActivitiesEx ou ISocialPerson::GetActivities. Se o provedor definir getActivities como true, o OSC usará o valor de cacheActivities ou dynamicActivitiesLookupEx para determinar se o site da rede social permite o armazenamento de atividades como itens RSS do Outlook ou como atividades na memória. Se o provedor definir getActivities como false, a rede social não oferecerá suporte a atividades e aos métodos ISocialSession2::GetActivitiesEx e ISocialPerson::GetActivities, e o OSC ignorará os valores de cacheActivities e dynamicActivitiesLookupEx.

O elemento a seguir aplica-se apenas à sincronização em cache ou à sincronização híbrida de atividades.

Elemento

Descrição

cacheActivities

Começando com o Outlook Social Connector 2013, o OSC ignora esse elemento, pois os provedores não podem mais sincronizar atividades armazenando-as em cache em uma pasta oculta no repositório do usuário. Se o provedor oferecer suporte para atividades, ele deverá oferecer suporte à sincronização de atividades sob demanda. O provedor define cacheActivities como false e dynamicActivitesLookupEx como true. O OSC sincroniza atividades sob demanda e as armazena em cache na memória. O cache de memória de atividades é atualizado em um intervalo de 30 minutos.

Os elementos a seguir aplicam-se apenas à sincronização sob demanda ou à sincronização híbrida de atividades.

Elemento	Descrição
dynamicActivitiesLookup	Preterido no OSC 1.1. Começando no OSC 1.1, o OSC não chama mais ISocialSession::GetActivities e ignora o valor de dynamicActivitiesLookup. Para suportar a pesquisa de atividades sob demanda, defina cacheActivities como false e getActivities e dynamicActivitiesLookupEx como true, e o OSC chamará ISocialSession2::GetActivitiesEx.
dynamicActivitiesLookupEx	Indica se o provedor OSC oferece suporte para a chamada ISocialSession2::GetActivitiesEx para sincronização de atividades sob demanda. Se o provedor OSC oferecer suporte à sincronização de atividades sob demanda, ele definirá getActivities e dynamicActivitiesLookupEx como true e cacheActivities como false. O OSC chama ISocialSession2::GetActivitiesEx sempre que o Painel de Pessoas é atualizado. O Painel de Pessoas é atualizado quando o usuário altera o item selecionado na janela do explorador do Outlook ou abre uma janela do inspetor do Outlook. A pesquisa de atividades dinâmicas garante que o usuário sempre verá as atividades mais recentes no Painel de Pessoas, mas aumentará o número de chamadas do provedor para a rede social. Se o provedor definir dynamicActivitiesLookupEx como false, o OSC não chamará ISocialSession2::GetActivitiesEx para pessoas exibidas no Painel de Pessoas.
showOnDemandActivitiesWhenMinimized	Indica se o OSC deve executar a sincronização sob demanda para atividades quando o Painel de Pessoas é minimizado.

Recursos comuns para oferecer suporte à sincronização sob demanda ou híbrida de amigos, não amigos e atividades

Elemento

Descrição

hashFunction

Especifica a função de hash com suporte pelo provedor OSC. Para proteger informações de identificação pessoal de usuários que não estão na rede social do provedor ou em aplicativos de linha de negócios, o OSC transmite endereços de email com hash para ISocialSession2::GetPeopleDetails e ISocialSession2::GetActivitiesEx. Se dynamicContactsLookup estiver configurado como true ou dynamicActivitiesLookupEx estiver configurado como true, o provedor deverá definir hashFunction como um dos valores permitidos: SHA1, MD5 ou CRC32MD5. Se hashFunction estiver ausente ou especificar um valor incorreto, o OSC retornará um erro. SHA1 é o US Secure Hash Algorithm 1 da Internet Engineering Task Force (IETF) definido por [RFC3174]. Por exemplo, o valor hash sha1 do endereço melissa@contoso.com de email é bb81577b567262a21a4df5f6e335c1250acd7b50. MD5 é o MD5 Message-Digest Algorithm da Internet Engineering Task Force (IETF) definido por [RFC1321]. Por exemplo, o valor de hash MD5 do endereço melissa@contoso.com de email é c8c39e61ca1662477b39b83d7b0a0615. CRC32MD5 é uma combinação de CRC32 e MD5, definida da seguinte forma: Normalize o endereço de email removendo espaços em branco iniciais e finais e convertendo todos os caracteres em minúsculas. Calcule o valor de CRC32 para o endereço de email normalizado e use a representação decimal inteira desse valor. Se a sua implementação retornar números inteiros assinados, você deverá converter o número inteiro assinado em um inteiro não assinado. Calcule o valor MD5 do endereço de email normalizado e use a representação hexadecimal desse valor (usando minúsculas de A até F). Combine esses dois valores com um sublinhado. Por exemplo, o CRC32MD5 valor hash do endereço melissa@contoso.com de email é 2149665315_c8c39e61ca1662477b39b83d7b0a0615.

Recursos para suporte à autenticação e à configuração de conta

Elemento	Descrição
allowChangesToAutoConfigure	Indica se a rede social permite que o usuário altere as definições de configuração automática, como fornecer uma URL diferente para fazer logon.
createAccountUrl	Se o provedor definir hideHyperlinks como false, quando o usuário clicar em Clique aqui para criar uma conta na caixa de diálogo Configuração da conta, a URL especificada por createAccountUrl será aberta no navegador padrão.
displayUrl	Indica se o OSC deve exibir a caixa de texto Endereço da URL para a rede social na caixa de diálogo de configuração da conta.
forgotPasswordUrl	Se o provedor definir hideHyperlinks como false, quando o usuário clicar em Esqueceu sua senha? na caixa de diálogo Configuração da conta, a URL especificada por forgotPasswordUrl será aberta no navegador padrão.
hideHyperlinks	Indica se o OSC deve ocultar os hiperlinks Clique aqui para criar uma conta e Esqueceu sua senha? na caixa de diálogo de configuração da conta. O OSC 1.0 ignora essa configuração, e os hiperlinks ficam sempre ocultos. O OSC 1.1 observa o valor dessa configuração.
hideRememberMyPassword	Indica se o OSC deve ocultar a caixa de seleção Lembrar minha senha na caixa de diálogo de configuração da conta. Se o provedor definir hideRememberMyPassword como true, o OSC agirá como se a caixa Lembrar minha senha estivesse desmarcada e não salvará a senha. Se o provedor definir hideRememberMyPassword como false, o OSC exibirá a caixa de seleção Lembrar minha senha na caixa de diálogo de configuração da conta.
supportsAutoConfigure	Indica se o OSC deve chamar a função GetAutoConfiguredSession na interface ISocialProvider para tentar a configuração automática e fazer logon na rede social para o usuário.
useLogonCached	Indica se o provedor OSC oferece suporte para a chamada ISocialSession2::LogonCachedpara fazer logon com credenciais armazenadas em cache. Se o provedor definir useLogonCached como true, o OSC ignorará a configuração para useLogonWebAuth, e o OSC chamará ISocialSession2::LogonCached para autenticação. Se o provedor definir dynamicActivitiesLookupEx como false, o OSC não chamará ISocialSession2::LogonCached para autenticação.
useLogonWebAuth	Indica se o OSC deve usar a autenticação baseada em formulários e o método ISocialSession::LogonWeb. Se o provedor definir useLogonWebAuth como false, o OSC usa autenticação básica e chama o método ISocialSession::Logon. Se o provedor definir useLogonWebAuth como true, o OSC usará a autenticação baseada em formulários e chamará ISocialSession::LogonWeb.

Dependendo do XML de recursos retornado pelo provedor no método ISocialProvider::GetCapabilities, a caixa de diálogo de configuração de conta é alterada. Por exemplo, a Figura 1 mostra a caixa de diálogo de configuração da conta para um exemplo de TestProvider.

Figura 1. Exemplo testProvider na caixa de diálogo configuração da conta

Confira também

• XML para recursos