Definir mapeamento de declarações personalizadas para integração baseada em servidor com o SharePoint
Publicado: novembro de 2016
Aplicável a: Dynamics CRM 2015
Para a integração baseada em servidor com o SharePoint, o Microsoft Dynamics CRM Online usa declarações para autenticar e autorizar usuários do Dynamics 365 a acessarem os documentos armazenados no SharePoint. Para obter mais informações sobre a autenticação baseada em declarações, consulte Identidade baseada em declarações no SharePoint 2013.
Por padrão, o CRM Online usa os seguintes mapeamentos de declaração para integração com o SharePoint:
SharePoint Online: NameId (PUID)
SharePoint no local: SMTP (email)
Você pode usar a entidade UserMapping para especificar mapeamentos de declaração personalizados no Dynamics 365 para usar um valor que não seja o valor padrão usado pelo CRM Online para autenticar e autorizar usuários de Dynamics 365 no SharePoint. Por exemplo, você pode optar por usar o “sobrenome” e “nome” do usuário em vez de ”email” para autenticar usuários do Dynamics 365 no SharePoint. Os mapeamentos de declaração personalizados são normalmente usados para integração com o SharePoint no local. Os mapeamentos de declaração personalizados substituem os mapeamentos de declaração padrão usados pelo Dynamics 365. Você pode definir vários mapeamentos de declaração personalizados no Dynamics 365. Por padrão, somente os usuários com a função Administrador do Sistema têm acesso à entidade UserMapping.
Observação
Para organizações que utilizam o Microsoft Dynamics CRM Online, esse recurso só estará disponível se a sua organização tiver atualizado para a Atualização 1 do Dynamics CRM Online 2015. Este recurso não está disponível para o Dynamics CRM (local).
Para definir um mapeamento de declaração personalizado no Dynamics 365, crie um registro de entidade UserMapping e especifique os valores de atributos listados na tabela a seguir.
Atributo |
Valor |
Descrição |
|---|---|---|
UserMapping.PartnerApplicationType |
|
O tipo de aplicação de parceiro para a qual esse mapeamento de declaração deve ser usado. Na versão atual, somente 0 (SharePoint) tem suporte. |
UserMapping.SystemUserAttributeName |
Valor da cadeia de caracteres |
O nome lógico do atributo na entidade (usuário) SystemUser do qual o valor será usado para as declarações. Observação Se o atributo usado no mapeamento personalizado de declarações não contém um valor, o mapeamento de declarações padrão é usado pelo Dynamics 365. Por exemplo, se você optar por usar o nome do usuário como o atributo para o mapeamento personalizado de declarações, e o nome de um usuário estiver ausente, o Dynamics 365 usará o mapeamento de declarações padrão (PUID ou email). |
UserMapping.ClaimType |
Valor da cadeia de caracteres |
Especifique o tipo de declaração a ser enviada ao SharePoint. Para obter uma lista de tipos de declarações, consulte Membros de ClaimTypes. Observação A lista de tipos de declarações referenciadas é apenas para referência. Todos os tipos de declaração listados podem não ter suporte do SharePoint, ou podem não conter todos os tipos de declaração com suporte do SharePoint. |
O código de exemplo a seguir mostra como definir um mapeamento de declarações personalizado usando a entidade UserMapping.
UserMapping customMapping = new UserMapping
{
PartnerApplicationType = new OptionSetValue(0),
SystemUserAttributeName = "personalemailaddress",
ClaimType = "smtp"
};
_serviceProxy.Create(customMapping);
Observação
Qualquer instância da entidade UserMapping com valores válidos substituirá os mapeamentos de declaração padrão usados pelo CRM Online.
Por padrão, o SharePoint dá suporte aos seguintes tipos de declaração: NameId (PUID), SMTP (email) e UPN (nome principal do usuário). Se você está passando a declaração de qualquer outro tipo que não seja aqueles com suporte por padrão do SharePoint, crie também mapeamentos do tipo de declaração correspondente no SharePoint.Para obter mais informações:New-SPClaimTypeMapping
Confira Também
Mensagens e métodos da entidade UserMapping
Integrar o Microsoft Dynamics CRM 2015 com o SharePoint
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais