Definiciones de características de directiva
Última modificación: viernes, 02 de abril de 2010
Hace referencia a: SharePoint Server 2010
En este artículo
Especificación de controles de configuración personalizada globales
Especificación del control de configuración personalizada
Especificación de clase y ensamblado de características
Especificación de recursos de directiva
Adición de una definición de características de directiva a la lista de características de directiva
Una definición de características de directiva es una sección de un archivo XML que proporciona la información que Microsoft SharePoint Server 2010 necesita para realizar lo siguiente:
Incluir la creación y configuración del elemento de directiva en la interfaz de Administración central de SharePoint.
Llamar al código de característica de directiva para tareas tales como inicializar la característica de la directiva.
Para facilitar la creación y configuración del elemento de directiva, la definición de características de directiva puede incluir las direcciones URL de dos controles web: uno para la configuración de características de directiva en el nivel de conjunto o granja de servidores y otra para la configuración de las características de directiva en el nivel de instancia de directiva. Estos controles web se hospedan en SharePoint Server 2010 y permiten a los usuarios pertinentes establecer la configuración en los niveles correspondientes.
Especificación de controles de configuración personalizada globales
El control web en el nivel de granja de servidores se hospeda en la página de administración para esa característica de directiva, y permite a los administradores especificar la configuración de la característica de directiva para toda la granja de servidores. Los usuarios que no son administradores no pueden ver ni modificar esta configuración, denominada configuración global. La configuración global se guarda en la propia definición de características de directiva. Por ejemplo, la característica de directiva Código de barras contiene una configuración global que permite al administrador del servidor seleccionar el generador de códigos de barras que se usará con la característica de directiva.
El control web de la granja de servidores debe implementar la clase GlobalCustomSettingsControl.
Si no se especifica un control de configuración personalizada global, los administradores no pueden sobrescribir ni editar los datos globales predeterminados especificados para la característica de directiva y, por lo tanto, no pueden personalizar la característica en el nivel de administrador. Esto limita las opciones del administrador tanto para activar la característica de directiva como para no activarla.
Especificación del control de configuración personalizada
El control web en el nivel de instancia de directiva se hospeda en la página de personalización de elementos de directiva, ya que permite al usuario especificar la configuración personalizada que se aplica a la característica de directiva dentro de una directiva específica. Esta configuración personalizada se guarda dentro del elemento de directiva de la directiva específica para dicha característica de directiva. Por ejemplo, la característica de directiva Bar Code contiene la siguiente configuración que el usuario puede especificar para cada directiva en que aparece la característica de directiva:
Proporciona automáticamente los códigos de barras.
Indica al usuario que incluya códigos de barras en los documentos.
El control web en el nivel de instancia de directiva debe implementar la clase CustomSettingsControl.
Si no se especifica un control de configuración personalizada, los usuarios no pueden sobrescribir o editar los datos predeterminados especificados para la característica de directiva y, por lo tanto, no pueden personalizar la característica en el nivel de usuario final.
Especificación de clase y ensamblado de características
Para que SharePoint Server 2010 pueda llamar al código de la característica de directiva para realizar las tareas necesarias, como la inicialización, la definición de características de directiva debe contener dos punteros específicos: uno hacia la ubicación del ensamblado de características de directiva con nombre seguro en la memoria caché global de ensamblados y otro hacia la clase dentro de dicho ensamblado que implementa la interfaz IPolicyFeature.
Para obtener más información sobre la interfaz IPolicyFeature, consulte Introducción a la interfaz IPolicyFeature.
Especificación de recursos de directiva
Si una característica de directiva usa recursos de directiva, debe enumerar el tipo de recursos que usa en su definición de características de directiva. Por ejemplo, la característica de directiva Bar Code incluye en su definición de características de directiva un elemento que indica que usa recursos de directiva del tipo "Generador de códigos de barras". De este modo, la característica de directiva puede usar cualquier recurso que declare en su definición de recursos que sea del tipo "Generador de códigos de barras". El nombre del recurso de directiva debe ser completo y debe aparecer en la lista de definiciones de recursos de directiva de dicha característica de directiva.
Nota
Los recursos de directiva pueden especificarse como requeridos u opcionales dentro de la definición de características de directiva. Si instala una característica de directiva que requiere un recurso de directiva de un tipo específico y no hay recursos de directiva de ese tipo instalados en la granja de servidores, la característica de directiva no se podrá activar.
La figura 1 muestra la información contenida en la definición de características de directiva y los elementos a los que hace referencia la información.
Figura 1. Estructura conceptual de definiciones de características de directivas
.gif "Estructura conceptual de definiciones de características de directivas")
Adición de una definición de características de directiva a la lista de características de directiva
La lista de características de directiva incluye las definiciones de características de directiva para cada característica de directiva instalada en una determinada granja de servidores. Se puede agregar una directiva de sitio llamando al método Add de la clase PolicyFeatureCollection. Este método agrega el archivo XML pasado a la lista de características de directiva como una definición de características de directiva para la característica de directiva.
Esto se suele realizar como parte de la implementación de la característica de directiva como característica de SharePoint Foundation. Para obtener más información, vea Uso de características.
Después de agregar una definición de características de directiva a la lista de características de directivas, se puede trabajar con la característica de directiva mediante programación, como un objeto PolicyFeature en el modelo de objetos.
Vea también
Conceptos
Administración de la directiva de administración de la información
Introducción a las características de directiva
Introducción al esquema de definición de características de directiva