Definir asignación de notificaciones personalizada para integración basada en SharePoint

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Para integración basada en servidor con SharePoint, Microsoft Dynamics 365 usa notificaciones para autenticar y autorizar a los usuarios de Dynamics 365 a tener acceso a los documentos almacenados en SharePoint. Para obtener más información sobre la autenticación basada en notificaciones, vea Identidad basada en notificaciones en SharePoint 2013.

De forma predeterminada, Dynamics 365 usa las siguientes notificaciones para integrarse con SharePoint:

Escenario	Reclamaciones
Dynamics 365 (online) y SharePoint Online	NameId (PUID) Dynamics 365 y SharePoint comparten Microsoft Azure Active Directory para identidad de usuarios.
Dynamics 365 (online) y SharePoint local	SMTP (email) No hay infraestructura de Active Directory compartida para identidad de usuarios; notificaciones enviadas como dirección SMTP. Las notificaciones se recogen del campo WindowsLiveID en Dynamics 365 y se asignan a la dirección de correo electrónico de trabajo desde SharePoint.
Dynamics 365 local y SharePoint Online	SMTP (email) No hay infraestructura de Active Directory compartida para identidad de usuarios; notificaciones enviadas como dirección SMTP. Las notificaciones se recogen del campo PrimaryEmailAddess en Dynamics 365 y se asignan a la dirección de correo electrónico de trabajo desde SharePoint.
Dynamics 365 local y SharePoint local	Security Identifier (SID) Dynamics 365 y SharePoint comparten Microsoft Windows Server Active Directory para la identidad de usuarios.

Puede usar la entidad UserMapping para especificar asignaciones de notificaciones personalizadas en Dynamics 365 para usar un valor distinto del valor predeterminado usado por Dynamics 365 para autenticar y autorizar usuarios de Dynamics 365 en SharePoint. Por ejemplo, puede usar el "apellido" y "nombre de pila" del usuario en lugar de "correo electrónico" para autenticar a los usuarios de Dynamics 365 en SharePoint. Las asignaciones personalizadas de notificaciones reemplazan las asignaciones predeterminadas de notificación usadas por Dynamics 365. Puede definir varias asignaciones personalizadas de notificaciones en Dynamics 365. De forma predeterminada, solo los usuarios que tengan el rol de Administrador del sistema tienen acceso a la entidad UserMapping.

Para definir una asignación personalizada de notificaciones en Dynamics 365, cree un registro de entidad UserMapping , y especifique los valores de atributo que se muestran en la tabla siguiente.

Atributo	Valor	Descripción
UserMapping.PartnerApplicationType	0: SharePoint 1: Sólo para uso interno.	El tipo de aplicación de socio para el que se debe usar esta asignación de notificaciones. En la versión actual, solo se admite 0 (SharePoint).
UserMapping.SystemUserAttributeName	Valor de cadena	El nombre lógico del atributo de la entidad SystemUser (usuario) de donde se utilizará el valor de las notificaciones. Nota Si el atributo usado para la asignación personalizada de notificaciones no contiene un valor, Dynamics 365 utiliza la asignación predeterminada de notificaciones. Por ejemplo, si desea usar el nombre de pila del usuario como atributo para la asignación personalizada de notificaciones y falta el nombre de pila de un usuario, Dynamics 365 usará la asignación predeterminada de notificaciones (PUID o correo electrónico).
UserMapping.ClaimType	Valor de cadena	Especifique tipo de notificación para enviar a SharePoint. Para obtener una lista de tipos de notificación, vea Miembros de ClaimTypes. Nota La lista de tipos de notificaciones consultada es solo para referencia. Todos los tipos de notificaciones mostrados ahí podrían no ser compatibles con SharePoint o no contener todos los tipos de notificaciones admitidos por SharePoint.

El código de ejemplo siguiente muestra cómo definir una asignación personalizada de notificaciones utilizando la entidad UserMapping.

UserMapping customMapping = new UserMapping
{
   PartnerApplicationType = new OptionSetValue(0),
   SystemUserAttributeName = "personalemailaddress",
   ClaimType = "smtp"
};
_serviceProxy.Create(customMapping);

Nota

Cada instancia de la entidad UserMapping con valores válidos reemplazará las asignaciones predeterminadas de notificaciones usadas por Dynamics 365.

De forma predeterminada, SharePoint admite los siguientes tipos de notificaciones: NameId (PUID), SMTP (correo electrónico) y UPN (nombre principal de usuario). Si pasa una notificación de otro tipo, también debe crear asignaciones de tipos de notificaciones correspondientes en SharePoint.Más información:New-SPClaimTypeMapping

Ver también

Mensajes y métodos de la entidad UserMapping
Integrar Microsoft Dynamics 365 con SharePoint

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright