Procedimiento para mostrar campos personalizados en un elemento web de consulta de contenido
Última modificación: lunes, 19 de abril de 2010
Hace referencia a: SharePoint Server 2010
Un elemento web de consulta de contenido muestra una vista dinámica del contenido en una página del sitio de Microsoft SharePoint Server 2010. El elemento web ejecuta una consulta que puede abarcar listas y sitios de la colección de sitios y, a continuación, presenta los resultados de dicha consulta en la página. Por ejemplo, puede usar este elemento web para mostrar los cinco artículos publicados más recientemente en el sitio web, independientemente de dónde estén almacenados.
El elemento web tiene dos aspectos importantes: la consulta y la presentación. La consulta determina qué contenido desea mostrar y la presentación determina cómo desea presentar el contenido y su estilo. También puede adjuntar reglas para que se muestren en el elemento web solo los elementos de un tipo determinado que se ajusten a un conjunto determinado de reglas.
En el panel de herramientas, puede hacer lo siguiente:
Seleccione el ámbito de la consulta. Puede configurar el elemento web para consultar elementos en toda la colección de sitios, desde un sitio específico en la colección de sitios o desde una lista determinada.
Seleccione el tipo de lista desde la que se consultan los elementos.
Especifique el tipo de contenido que debe mostrar el elemento web.
Seleccione filtros adicionales para controlar qué contenido muestra el elemento web. Por ejemplo, un filtro puede usarse para mostrar únicamente páginas de artículo creadas por un usuario concreto.
Seleccione las opciones de ordenación y agrupación para determinar el orden en el que aparecen los elementos.
Seleccione las opciones de estilo para controlar cómo el elemento web presenta los elementos y los encabezados de grupo.
De forma predeterminada, la hoja de estilos XSL que controla la presentación del elemento web de consulta de contenido representa las columnas Título, Descripción, ImageUrl y LinkUrl (si está presente) de los elementos que devuelve la consulta. El elemento web representa las columnas ImageUrl y LinkUrl como una imagen y como un hipervínculo, respectivamente. El elemento web de consulta de contenido usa hojas de estilos XSL para representar estas columnas de forma predeterminada.
Si desea consultar tipos de contenido personalizados y representar columnas específicas de dichos tipos de contenido en el elemento web, debe realizar alguna personalización secundaria en el archivo .webpart.
En este tema se explica cómo incluir columnas adicionales en la consulta del elemento web y cómo indicar mediante programación el elemento web para cambiar el nombre de las columnas a nombres que espera la transformación XSL predeterminada y, a continuación, representar las columnas mediante los estilos de la transformación XSL predeterminada.
Para comprender los pasos implicados en esta personalización, imagine un escenario en el que dispone de un tipo de contenido Knowledge Base Articles con las columnas siguientes:
Título KB (texto)
Producto (texto)
Versión (texto)
Estado (opción)
Asocie una biblioteca de documentos titulada Artículos de Knowledge Base con el tipo de contenido que contiene artículos de Knowledge Base. Para mostrar el contenido de los artículos de Knowledge Base en un elemento web de consulta de contenido en la página principal, mostrar la columna Título como el campo Title y mostrar la columna Producto como el campo Description en el elemento web, siga los siguientes pasos.
Para mostrar los campos personalizados en un elemento web de consulta de contenido
Agregue un elemento web de consulta de contenido a una página:
En la sección Consulta, establezca el Origen para que muestre los elementos de la biblioteca de documentos (lista) de artículos de Knowledge Base. Establezca el tipo de lista y el tipo de contenido según corresponda.
En la sección Presentación, establezca el Estilo del elemento: en Título y descripción.
Edite las propiedades en el archivo de elementos web para mostrar los campos personalizados. Para tener acceso al archivo .webpart del elemento web, en el menú Editar del elemento web, haga clic en Exportar.
SharePoint Server 2010 genera un archivo .webpart con el conjunto completo de las propiedades que están disponibles para dicho elemento web. El archivo .webpart es un archivo XML que se puede editar mediante un editor de texto.
En el archivo .webpart, busque la propiedad CommonViewFields. Use esta propiedad para especificar los campos adicionales que desee mostrar en el elemento web. Agregue los nombres internos de las columnas y el tipo.
<property name="CommonViewFields" type="string">KB_x0020_Title,Text;Product,Text;</property>Nota
No se pueden usar los nombres para mostrar de las columnas en esta propiedad. Puede encontrar los nombres de columna internos mediante la comprobación de las propiedades de la columna en la lista o biblioteca de documentos. Haga clic con el botón secundario en la columna y, a continuación, haga clic en Propiedades. El nombre interno de una columna aparece en la propiedad Address (URL) después de 'Field='. En el escenario de los artículos de Knowledge Base, las columnas son Artículo de Knowledge Base y Producto y sus nombres internos son KB_x0020_Title y Product, respectivamente.
Asigne estos nombres internos de columna al Title y Description de las columnas de las transformaciones XSL. Para ello, edite la propiedad DataColumnRenames.
<property name="DataColumnRenames" type="string">KB_x0020_Title,Title;Product,Description</property>Nota
Las transformaciones XSL predeterminadas pueden representar los cuatro campos siguientes: Title, Description, LinkUrl y ImageUrl. En la propiedad DataColumnRenames, compruebe que los nombres que se especifican coinciden con los nombres de las transformaciones XSL; es decir, Title, Description, LinkUrl y ImageUrl.
Guarde el archivo .webpart localmente.
En la página web, elimine el elemento web de consulta de contenido agregado en el paso 1.
Importe el archivo .webpart y agregue el elemento web a la página. Para importar el archivo .webpart, haga clic en Página, haga clic en Agregar elementos Web y, a continuación, haga clic en Importar. Vaya al archivo .webpart y a continuación, haga clic en Cargar.
Arrastre el elemento web a la zona apropiada de la página. El elemento web debe mostrar el Título de Knowledge Base y el nombre del producto.
Si desea que aparezca la columna Estado o la columna Versión además del título de KB título y del producto, modifique la transformación XSLT y agregue la representación de las columnas adicionales.
Nota
El ejemplo anterior muestra cómo editar un elemento web individual en una página para incluir campos personalizados en el resultado representado. Sin embargo, puede también realizar cambios a elementos web con un editor, como Microsoft SharePoint Designer 2010. SharePoint Designer 2010 es una buena herramienta si desea personalizar un elemento web que se usa en un diseño de página e incluir automáticamente ese elemento web personalizado en las páginas que se crean mediante ese diseño. También puede agregar elementos web personalizados a la galería de elementos web, que hace que estén disponibles para arrastrarlos y colocarlos en las zonas de elementos web de las páginas nuevas.
Vea también
Tareas
Procedimiento para personalizar XSL para el elemento web de consulta por contenido
Procedimiento para personalizar RSS para el elemento web de consulta de contenido
Conceptos
Tareas de personalización de control de campo y elemento web común