Compartir a través de

Procedimiento para personalizar RSS para el elemento web de consulta de contenido

  • Artículo

Última modificación: lunes, 19 de abril de 2010

Hace referencia a: SharePoint Server 2010

Una vez que personalice el elemento web de consulta de contenido para mostrar los campos y el contenido que desee, puede configurar el elemento web para emitir una fuente Really Simple Syndication (RSS) de ese contenido.

En este tema se explica cómo agregar y personalizar fuentes RSS que emiten contenido de elemento web de consulta de contenido:

  • Procedimiento para habilitar una fuente RSS para un elemento web de consulta de contenido

  • Funcionamiento de una dirección URL de fuente RSS

  • Procedimiento para usar un archivo .xsl personalizado para fuentes RSS de elemento web de consulta de contenido

  • Procedimiento para resolver problemas de almacenamiento en memoria caché con una fuente RSS de elemento web de consulta de contenido

Activación de una fuente RSS para el contenido del elemento web de consulta de contenido

Para habilitar una fuente RSS que emite contenido de elemento web de consulta de contenido, edite el elemento web y active la casilla Habilitar fuente. Después de habilitar la fuente, haga clic en el icono de fuente RSS para obtener una vista previa del contenido de la fuente en el explorador.

Descripción del funcionamiento de una dirección URL de fuente RSS

Un aspecto clave para saber cómo personalizar RSS para el elemento web de consulta de contenido consiste en comprender las partes de una dirección URL de fuente RSS y cómo interactúan entre ellas. A continuación se muestra el formato de una dirección URL de fuente RSS: **http://nombreDeServidor/_layouts/feed.aspx?xsl=archivosxsl registrados en el archivo Web.config&web=direcciónWeb&page=guid&wp=**guid.

La dirección URL de la fuente incluye una ruta de acceso al archivo Feed.aspx, que se genera a partir del archivo Feed.xsl en la carpeta _layouts del servidor que ejecuta Microsoft SharePoint Server 2010. El archivo Feed.aspx busca el elemento web de consulta de contenido que emite la fuente RSS, determina qué consulta ejecuta el elemento web y usa el archivo Feed.xsl de la carpeta _layouts para generar XML de fuente RSS.

Los valores especificados para cada parámetro proporcionan información que SharePoint Server 2010 necesita para emitir una fuente RSS.

Parámetro

Descripción

Valores válidos

xsl

Puntero a la clave usada para identificar el archivo Rss.xsl que el elemento web usa para producir la fuente RSS.

Archivos .xls que se registran en el archivo web.config

Web

Sitio web que contiene el elemento web de consulta de contenido que emite la fuente RSS.

Dirección URL relativa del servidor

Page

Página que contiene el elemento web de consulta de contenido que emite la fuente RSS.

GUID

Wp

Identificador del elemento web de consulta de contenido.

GUID

Información de parámetros XLS adicional

El diseño del elemento web de contenido de consulta facilita la administración de fuentes RSS; SharePoint Server 2010 registra cada archivo .xsl en el archivo web.config file. El parámetro xsl de la dirección URL de fuente RSS representa el archivo .xsl registrado en el archivo web.config que se encuentra en la ruta de acceso \Inetpub\wwwroot\wss\VirtualDirectories\portnumber\wpresources. El registro de un archivo .xsl en la sección <appsettings> del archivo web.config permite al archivo Feed.aspx usar ese archivo .xsl.

<appsettings>
   <add key="FeedXsl1" value="/Style Library/Xsl Style Sheets/Rss.xsl">
</appsettings>

El valor key de FeedXsl1 se asigna al valor del parámetro xsl de 1 en la dirección URL de fuente RSS.

El valor value de la ruta de acceso /Style Library/Xsl Style Sheets/Rss.xsl apunta al archivo Rss.xsl de la Biblioteca de estilos, que SharePoint Server 2010 incluye de forma predeterminada.

Para habilitar una fuente RSS para un elemento web de consulta de contenido

  1. Edite el elemento web de contenido de consulta.

  2. Expanda la sección Presentación y, a continuación, active la casilla Habilitar suministro .

  3. Haga clic en la fuente RSS para ver una vista previa en Internet Explorer y comprobar que está funcionando como se esperaba.

Uso de un archivo XSL personalizado para fuentes RSS de elemento web de contenido de consulta

Puede usar un archivo .xsl personalizado para fuentes RSS de elemento web de consulta de contenido mediante una de las siguientes acciones:

  • Editar el archivo Rss.xsl predeterminado que se incluye con SharePoint Server 2010; esto garantiza que todos los elementos web de consulta de contenido usen el mismo archivo Rss.xsl actualizado para representar las fuentes. Por ejemplo, realice esta acción para usar un archivo Rss.xsl que use el esquema Atom en lugar del esquema RSS 2.0, así como para usar Atom para todos los elementos web de consulta de contenido de la colección de sitios. Recurra a este enfoque si es propietario de la colección de sitios, pero no del equipo servidor donde SharePoint Server 2010 está instalado.

  • Agregar un archivo Rss.xsl personalizado a la Biblioteca de estilos y registrarlo en el archivo web.config. Recurra a este enfoque para generar una fuente RSS personalizada que se aplique a un elemento web de consulta de contenido específico. Use esta opción si necesita derechos de administrador local en el servidor que ejecuta SharePoint Server 2010 para registrar el archivo .xsl, si necesita disponer de varias formas de editar el elemento web o si tiene que editar el archivo web.config.

Para editar el archivo RSS.xsl predeterminado

  1. Desplácese a la Biblioteca de estilos.

  2. Edite el archivo Rss.xsl para emitir los datos de la fuente RSS que desee.

  3. Guarde los cambios.

Para agregar un archivo .xls de RSS personalizado Biblioteca de estilos y modificar los archivos para su uso

  1. Desplácese a la Biblioteca de estilos.

  2. Haga clic en Cargar y, a continuación, cargue el archivo .xsl personalizado a la Biblioteca de estilos. Puede cargar el archivo en la misma carpeta que contiene el archivo Rss.xsl predeterminado.

    Nota

    Si no tiene acceso al archivo .xsl de la Biblioteca de estilos, puede personalizar el elemento web de consulta de contenido editando el archivo ItemXslLink.xsl asociado al archivo de definición de elemento web (.wpd).

  3. Edite el archivo web.config, agregue una nueva entrada <appSettings> para el archivo que ha agregado en el paso 2 y, a continuación, guarde los cambios.

    <appSettings>
...
   <add key="FeedXsl2" value="/Style Library/Xsl Style Sheets/Rss-custom.xsl" />
...
</appSettings>

  4. Modifique el archivo .xsl que emite la fuente RSS para el elemento web de consulta de contenido copiando el archivo ContentQueryMain.xsl y cargándolo en la Biblioteca de estilos.

  5. Edite la copia del archivo ContentQueryMain.xsl y cambie el código siguiente. Elimine este código:

    <xsl:variable name="FeedUrl1" select="concat($SiteUrl,$FeedPageUrl,'xsl=1&amp;web=',$WebUrl,'&amp;page=',$PageId,'&amp;wp=',$WebPartId)" />

    Y reemplácelo por este otro:

    <xsl:variable name="FeedUrl1" select="concat($SiteUrl,$FeedPageUrl,'xsl=2&amp;web=',$WebUrl,'&amp;page=',$PageId,'&amp;wp=',$WebPartId)" />

  6. Compruebe que el elemento web de consulta de contenido está usando la copia del archivo ContentQueryMain.xsl; para ello, modifique la propiedad del elemento web de consulta de contenido que determina qué archivo Main.xsl se usa:

    1. Busque el elemento web de consulta de contenido en una página y expórtelo.

    2. Edite la propiedad MainXslLink. Elimine este código:

      <property name="MainXslLink" type="string" />

      Y reemplácelo por este otro:

      <property name="MainXslLink" type="string">/Style Library/XSL Style Sheets/ContentQueryMain-custom.xsl</property>

    3. Guarde los cambios e importe el elemento web de consulta de contenido.

Solución de problemas de almacenamiento en memoria caché con fuentes RSS de elemento web de consulta de contenido

Cuando se usan fuentes RSS de elemento web de consulta de contenido, la fuente RSS del elemento web de consulta de contenido en la que hace clic en primer lugar podría mantenerse inesperadamente, lo que impediría suscribirse a otras fuentes y ver fuentes nuevas o actualizadas.

Esto sucede porque la memoria caché del elemento web del formulario de datos, que el elemento web de consulta de contenido hereda, genera la misma clave de memoria caché que se genera para un elemento web creado dinámicamente, aunque la propiedad xsl sea diferente. Como resultado, el elemento web de consulta de contenido vuelve a usar los datos de la fuente almacenados en memoria caché de la carga de la primera página.

Para resolver problemas de almacenamiento en memoria caché con la fuente RSS de elemento web de consulta de contenido

  1. Cree copias de los archivos Feed.aspx en la ruta de acceso Program Files\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS y, a continuación, cámbieles el nombre a Feed1.aspx, Feed2.aspx y, así, sucesivamente.

  2. Edite el archivo Rss.xsl y, a continuación, cambie el parámetro xsl para que apunte el número de fuente correspondiente. Por ejemplo, establezca xsl=1 para Feed1.aspx y xsl=2 para Feed2.aspx.

Vea también

Tareas

Procedimiento para personalizar el elemento web de consulta de contenido mediante propiedades personalizadas

Procedimiento para mostrar campos personalizados en un elemento web de consulta de contenido

Procedimiento para personalizar RSS para el elemento web de consulta de contenido