Promoción y disminución de nivel de propiedades de documento
Última modificación: lunes, 01 de noviembre de 2010
Hace referencia a: SharePoint Foundation 2010
La promoción de propiedades se refiere al proceso de extracción de valores de las propiedades de un documento y la escritura de dichos valores en las columnas correspondientes de la lista o biblioteca de documentos en la que se almacena el documento. La disminución de nivel de las propiedades es el mismo proceso a la inversa. Los valores se leen de columnas de lista y se escriben en las propiedades del documento.
Microsoft SharePoint Foundation puede trabajar junto con un analizador de documentos para automatizar el proceso de promoción y disminución de nivel de propiedades. Cuando cambian los valores de las propiedades del documento, los cambios se pueden volver a escribir automáticamente en la lista. Cuando cambian los valores de las columnas o campos en un elemento de lista, los cambios se pueden volver a escribir automáticamente en el documento asociado con el elemento de lista. Por lo tanto, el documento y su elemento de lista asociado permanecen sincronizados.
SharePoint Foundation inicia la promoción o disminución de nivel de propiedades cuando se producen los siguientes eventos:
Se carga un archivo a una biblioteca de documentos.
Se modifican los campos de un elemento de lista asociado a un archivo.
La propiedad Properties de un objeto SPFile se actualiza mediante programación.
Un archivo se descarga por primera vez después de modificarse el esquema de lista.
En cada caso, SharePoint Foundation determina si se asocia un analizador con el tipo de archivo. Si es así, SharePoint Foundation invoca el analizador y le pasa el documento y un objeto de contenedor de propiedades. A continuación, el analizador rellena el contenedor de propiedades con valores que deben promoverse a la lista o extrae del contenedor de propiedades los valores que deben disminuir de nivel en el documento.
SharePoint Foundation sólo promueve o disminuye el nivel de las propiedades de documento que coinciden con las columnas de lista que son aplicables al documento. Las columnas que son aplicables a un documento se especifican mediante:
El tipo de contenido del documento, si se asigna uno.
Las columnas en la biblioteca de documentos, si el documento no tiene un tipo de contenido.
Para obtener más información sobre los tipos de contenido, consulte Tipos de contenido.
SharePoint Foundation también almacena toda la colección de propiedades del documento en una tabla hash, a la que se puede obtener acceso mediante programación a través de la propiedad Properties de un objeto SPFile. No se puede obtener acceso a la tabla hash de propiedades del documento a través de una interfaz de usuario.
Para obtener información acerca de cómo el analizador XML integrado promueve y disminuye el nivel de las propiedades de documento para los archivos XML, vea Aumento y disminución de nivel de propiedades de documento XML.
Promoción
SharePoint Foundation crea una instancia de Interfaz IParserPropertyBag y rellena el objeto con las propiedades del documento especificadas en la lista. A continuación, invoca el analizador de documentos para el tipo de archivo y llama al método Parse del analizador, pasando el documento y el contenedor de propiedades como argumentos. Después de que el método realiza la devolución, SharePoint Foundation tiene acceso al contenedor de propiedades, determina qué propiedades del documento coinciden con qué columnas de lista y escribe dichos valores en la lista.
La siguiente figura ilustra el proceso de promoción de documento. En este proceso, el analizador extrae las propiedades del documento y las escribe en el contenedor de propiedades. De las cuatro propiedades del documento, tres están incluidas en el tipo de contenido del documento. SharePoint Foundation, a su vez, hace coincidir propiedades en el contenedor de propiedades con columnas (campos) de la biblioteca de documentos y, a continuación, promueve estas propiedades a la biblioteca de documentos; es decir, escribe los valores de propiedad en las columnas correspondientes. Como el tipo de contenido del documento no incluye la columna Status, SharePoint Foundation no promueve la cuarta propiedad del documento, Status, aunque la biblioteca de documentos incluya una columna coincidente. SharePoint Foundation también escribe las cuatro propiedades del documento en la propiedad Properties del objeto SPFile que representa el documento en la biblioteca de documentos.
.gif "Promoción de propiedades mediante un analizador personalizado")
Disminución de nivel
SharePoint Foundation crea una instancia de Interfaz IParserPropertyBag y rellena el objeto con las propiedades del documento especificadas en la lista. A continuación, invoca el analizador de documentos para el tipo de archivo y llama al método Demote del analizador, pasando el documento y el contenedor de propiedades como argumentos. El método Demote obtiene acceso al contenedor de propiedades, hace coincidir columnas de lista con propiedades del documento y vuelve a escribir los valores correspondientes en el documento.
La siguiente figura muestra el proceso de disminución de nivel de las propiedades del documento. Para actualizar dos propiedades del documento, SharePoint Foundation invoca el analizador, le pasa el documento que se va a actualizar y el contenedor de propiedades que contiene las dos propiedades del documento. El analizador lee los valores de propiedad del contenedor de propiedades y actualiza las propiedades en el documento. Cuando el analizador termina de actualizar el documento, establece una marca que se pasa en un parámetro de salida que indica que ha modificado el documento. A continuación, SharePoint Foundation guarda el documento actualizado en la biblioteca de documentos.
.gif "Degradación de propiedades mediante un analizador personalizado")