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

Para integración basada en servidor con SharePoint, las aplicaciones Dynamics 365 Customer Engagement (on-premises) usan notificaciones para autenticar y autorizar a los usuarios de Customer Engagement 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, Customer Engagement usa las siguientes notificaciones para integrarse con SharePoint:

Escenario	Reclamaciones
Customer Engagement y SharePoint Online	NameId (PUID) Dynamics 365 Customer Engagement (on-premises) y SharePoint comparten Azure Active Directory para identidad de usuarios.
Customer Engagement 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 Customer Engagement (on-premises) y se asignan a la dirección de correo electrónico de trabajo desde SharePoint.
Dynamics 365 Customer Engagement (on-premises) 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 Customer Engagement (on-premises) y se asignan a la dirección de correo electrónico de trabajo desde SharePoint.
Dynamics 365 Customer Engagement (on-premises) y SharePoint local	SMTP (email) Dynamics 365 Customer Engagement (on-premises) 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 Customer Engagement para usar un valor distinto del valor predeterminado usado por Customer Engagement para autenticar y autorizar usuarios de Customer Engagement 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 Customer Engagement en SharePoint. Las asignaciones personalizadas de notificaciones reemplazan las asignaciones predeterminadas de notificación usadas por Customer Engagement. Puede definir varias asignaciones personalizadas de notificaciones en Customer Engagement. 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 Customer Engagement, cree un registro de entidad UserMapping, y especifique los valores de atributo que se muestran en la tabla siguiente.

Attribute	valor	Description
UserMapping.PartnerApplicationType	- 0: SharePoint - 1: Solo 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, Customer Engagement 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, Customer Engagement 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 Customer Engagement.

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

Consulte también

Entidad UserMapping
Integrar Microsoft Dynamics 365 Customer Engagement (on-premises) con SharePoint