Crear un proveedor de notificaciones en SharePoint
Aprenda a crear e implementar un proveedor de notificaciones de SharePoint que cumpla con los requisitos para el aumento de notificaciones y la selección de notificaciones.
Un proveedor de notificaciones emite notificaciones y las empaqueta en tokens de seguridad. Un proveedor de notificaciones tiene dos roles: aumento y selección.
El aumento de notificaciones permite a una aplicación agregar aplicaciones adicionales al token del usuario. Por ejemplo, con inicio de sesión basado en Windows, el servicio de directorios de Active Directory puede aumentar todos los grupos de seguridad de un usuario en el token Windows del usuario. Con inicio de sesión basado en notificaciones, una aplicación de administración de las relaciones con el cliente (CRM) puede aumentar los roles desde una base de datos de CRM. Al tener estas notificaciones en el token del usuario, se pueden autorizar recursos frente a estas notificaciones. Es decir, estas notificaciones se usan para determinar si un usuario concreto tiene acceso a recursos específicos. Las notificaciones pueden mostrarse en el control de selector de personas a través de la selección de notificaciones. La selección de notificaciones permite a una aplicación exponer notificaciones en el selector de personas, por ejemplo, al configurar la seguridad de un sitio o servicio de SharePoint. Esta característica le permite proporcionar la búsqueda, la resolución y la visualización descriptiva de notificaciones.
Nota:
[!NOTA] A veces, al selector de personas con funciones de selección de notificaciones se le denomina selector de notificaciones. Para obtener más información, consulte Personas selector y planificación del proveedor de notificaciones.
Para escribir un proveedor de notificaciones, el primer paso es crear una clase que se derive de la clase SPClaimProvider.
Propina: Para obtener un ejemplo de código y más información sobre la clase SPClaimProvider y sus miembros, vea SPClaimProvider . Para tutoriales, sugerencias y ejemplos de código, consulte Notificaciones y seguridad: artículos técnicos y ejemplos de código en MSDN.
Implementaciones obligatorias
Los siguientes métodos y propiedades son obligatorios al escribir un proveedor de notificaciones.
Obligatorio
La siguiente propiedad Name es una propiedad obligatoria. El nombre debe ser único en toda la granja de servidores.
public abstract String Name
Obligatorio para el selector de notificaciones
Las notificaciones pueden mostrarse en el control de selector de personas a través de la selección de notificaciones. Los métodos siguientes de la clase SPClaimProvider son métodos necesarios si desea implementar la selección de notificaciones en el control selector de personas.
protected abstract void FillSchema(SPProviderSchema schema);
protected abstract void FillClaimTypes(List<String> claimTypes);
protected abstract void FillClaimValueTypes(List<String> claimValueTypes);
protected abstract void FillEntityTypes(List<String> entityTypes);
Obligatorio para el aumento de notificaciones
Cuando incluye notificaciones adicionales en el token de seguridad de un usuario, está aumentando las notificaciones. Si desea aumentar las notificaciones, debe implementar los métodos siguientes en la clase SPClaimProvider .
public abstract bool SupportsEntityInformation
protected abstract void FillClaimsForEntity(Uri context, SPClaim entity, List<SPClaim> claims);
Obligatorio para mostrar la jerarquía en el panel izquierdo del selector de notificaciones
Si desea mostrar la jerarquía en el panel izquierdo del selector de notificaciones, debe implementar los métodos siguientes en la clase SPClaimProvider .
public abstract bool SupportsHierarchy
protected abstract void FillHierarchy(Uri context, String[] entityTypes, String hierarchyNodeID, int numberOfLevels, bool includeEntityData, SPProviderHierarchyTree hierarchy);
Obligatorio para resolver notificaciones en el control de escritura del selector de notificaciones
Si desea poder resolver notificaciones mediante el control de tipo in del selector de notificaciones, debe implementar los métodos siguientes en la clase SPClaimProvider .
public abstract bool SupportsResolve
protected abstract void FillResolve(Uri context, String[] entityTypes, String resolveInput, List<PickerEntity> resolved);
protected abstract void FillResolve(Uri context, String[] entityTypes, SPClaim resolveInput, List<PickerEntity> resolved);
Obligatorio para buscar notificaciones en el selector de notificaciones
Si desea poder buscar notificaciones en el selector de notificaciones, debe implementar la siguiente propiedad y método en la clase SPClaimProvider .
public abstract bool SupportsSearch
protected abstract void FillSearch(Uri context, String[] entityTypes, String searchPattern, String hierarchyNodeID, int maxCount, SPProviderHierarchyTree searchTree);
Método auxiliar práctico
También puede implementar un método auxiliar para ayudarle a crear objetos SPClaim .
Método auxiliar práctico para la creación de objetos SPClaim
A continuación se muestra un método auxiliar que puede implementar para ayudarle a crear objetos SPClaim .
protected SPClaim CreateClaim(String claimType, String value, String valueType)