Procedimiento para implementar un proveedor de notificaciones
Última modificación: miércoles, 23 de marzo de 2011
Hace referencia a: SharePoint Foundation 2010
Un proveedor de notificaciones emite notificaciones y las empaqueta en tokens de seguridad. Este tiene dos roles: aumento y selección.
El aumento de notificaciones permite que una aplicación aumente las notificaciones adicionales en el token del usuario. Por ejemplo, con un inicio de sesión basado en Windows, el servicio de directorio de Active Directory puede aumentar todos los grupos de seguridad del usuario en el token de Windows del usuario. Con un inicio de sesión basado en notificaciones, una aplicación de administración de las relaciones con el cliente (CRM) puede aumentar los roles de una base de datos de CRM. Si tiene estas notificaciones en el token del usuario, se pueden autorizar los recursos en ellas. Es decir, estas notificaciones se usan para determinar si un usuario en particular tiene acceso a recursos específicos.
Las notificaciones se pueden mostrar en el control de selector de personas a través de la selección de notificaciones. La selección de notificaciones permite que una aplicación exponga notificaciones en el selector de personas, por ejemplo, al configurar la seguridad de un sitio de SharePoint o el servicio de SharePoint. Esta funcionalidad permite ofrecer búsquedas, resolución y una fácil visualización de las notificaciones.
Nota
Un selector de personas con la funcionalidad de selección de notificaciones a veces se conoce como un selector de notificaciones.
Para escribir un proveedor de notificaciones, el primer paso es crear una clase que derive de la clase SPClaimProvider.
Sugerencia |
---|
Para obtener un ejemplo de código y más información acerca de la clase SPClaimProvider y sus miembros, vea SPClaimProvider. |
Implementaciones obligatorias
A continuación se enumeran los métodos y propiedades obligatorios al escribir un proveedor de notificaciones.
Obligatorio
La siguiente propiedad Name es obligatoria. El nombre debe ser único en todo el conjunto o granja de servidores.
public abstract String Name
Obligatorio para el selector de notificaciones
Las notificaciones se pueden mostrar 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 obligatorios para implementar la selección de notificaciones en el control de 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 se incluyen notificaciones adicionales en el token de seguridad del usuario, se aumentan las notificaciones. Si desea hacerlo, 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 recuadro izquierdo del selector de notificaciones
Si desea mostrar la jerarquía en el recuadro 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 la resolución de notificaciones en el control para introducir información del selector de notificaciones
Si desea poder resolver notificaciones mediante el control para introducir información 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 la búsqueda de notificaciones en el selector de notificaciones
Si desea realizar búsquedas de 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 útil
También puede implementar un método auxiliar para facilitar la creación de objetos SPClaim.
Método auxiliar útil para la creación de objetos SPClaim
El siguiente es un método auxiliar que se puede implementar para facilitar la creación de objetos SPClaim.
protected SPClaim CreateClaim(String claimType, String value, String valueType)