Compartir a través de


Referencia de parámetros de acceso URL

Puede utilizar los parámetros siguientes como parte de una dirección URL para configurar la apariencia de los informes. Los parámetros más comunes se muestran en esta sección. Los parámetros distinguen entre mayúsculas y minúsculas y comienzan con el prefijo de parámetro rs: si se dirige al servidor de informes y rc: si se dirige a un Visor HTML. También puede especificar parámetros que son específicos de dispositivos o extensiones de representación. Para obtener más información acerca de los parámetros específicos del dispositivo, vea Especificar la configuración de la información del dispositivo en una dirección URL.

Nota importanteImportante

Es importante que la dirección URL incluya la sintaxis de proxy de _vti_bin para enrutar la solicitud a través de SharePoint y el proxy HTTP de Reporting Services. El proxy agrega algún contexto a la solicitud HTTP, contexto que es necesario para garantizar la correcta ejecución del informe para los servidores de informes de modo de SharePoint. Para obtener ejemplos, vea Acceder a elementos del servidor de informes mediante el acceso URL.

Para obtener información sobre cómo incluir parámetros de informe en una dirección URL y algunos ejemplos, vea Pasar un parámetro de informe en una dirección URL.

Comandos del Visor HTML (rc:)

En la tabla siguiente se describen los parámetros de acceso URL que tienen como prefijo rc: y se usan con el Visor HTML como destino.

Parámetro

Acción

Toolbar

Muestra u oculta la barra de herramientas. Si el valor de este parámetro es false, se omiten todas las opciones restantes. Si omite este parámetro, la barra de herramientas se muestra automáticamente para los formatos de representación que lo admiten. El valor predeterminado de este parámetro es true.

Nota importanteImportante

rc:Toolbar=false no funciona para las cadenas de acceso URL que utilizan una dirección IP, en lugar de un nombre de dominio, cuyo destino es un informe hospedado en un sitio de SharePoint.

Parameters

Muestra u oculta el área de parámetros de la barra de herramientas. Si establece este parámetro en el valor true, se muestra el área de parámetros de la barra de herramientas. Si establece este parámetro en false, el área de parámetros no se muestra y no puede ser mostrada por el usuario. Si establece este parámetro en un valor de Collapsed, no se mostrará el área de parámetros, pero el usuario final puede alternarla. El valor predeterminado de este parámetro es true.

Por ejemplo, en modo Native.

http://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

Por ejemplo, en modo SharePoint.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Parameters=Collapsed

Zoom

Establece el valor de ampliación del informe como porcentaje entero o una constante de cadena. Los valores de cadena estándar incluyen Page Width y Whole Page. Las versiones de Internet Explorer anteriores a Internet Explorer 5.0 y todos los exploradores que no son de Microsoft omiten este parámetro. El valor predeterminado de este parámetro es 100.

Por ejemplo, en modo Native.

http://myrshost/reportserver?/Sales&rc:Zoom=Page Width

Por ejemplo, en modo SharePoint.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Zoom=Page Width

Section

Establece la página del informe que se mostrará. Cualquier valor que sea mayor que el número de páginas en el informe muestra la última página. Cualquier valor que sea menor que 0 muestra la página 1 del informe. El valor predeterminado de este parámetro es 1.

Por ejemplo en modo Native, para mostrar la página 2 del informe.

http://myrshost/reportserver?/Sales&rc:Section=2

Por ejemplo en modo SharePoint, para mostrar la página 2 del informe.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Section=2

FindString

Busca en un informe un conjunto específico de texto.

Por ejemplo, en modo Native.

http://myrshost/reportserver?/Sales&rc:FindString=Mountain-400

Por ejemplo, en modo SharePoint.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:FindString=Mountain-400

StartFind

Especifica la última sección en que se buscará. El valor predeterminado de este parámetro es la última página del informe.

Por ejemplo en modo Native que busca la primera aparición del texto "Mountain-400" en el informe de ejemplo Product Catalog desde la página uno hasta la página cinco.

https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400

EndFind

Establece el número de la última página que se utilizará en la búsqueda. Por ejemplo, un valor de 5 indica que la última página que se va a buscar es la página 5 del informe. El valor predeterminado es el número de la página actual. Utilice este parámetro junto con el parámetro StartFind. Vea el ejemplo anterior.

FallbackPage

Establece el número de la página que se mostrará si se produce un error en una búsqueda o en una selección de mapa del documento. El valor predeterminado es el número de la página actual.

GetImage

Obtiene un icono determinado para la interfaz de usuario del Visor HTML.

Icon

Obtiene el icono de una extensión de representación determinada.

Stylesheet

Especifica una hoja de estilos que se va a aplicar al Visor HTML.

Configuración de la información del dispositivo

Especifica una configuración de información del dispositivo en forma de rc:tag=value, donde tag es el nombre de la configuración de información de un dispositivo concreto para la extensión de representación que se usa actualmente (vea la descripción del parámetro Format). Por ejemplo, puede usar la configuración de información del dispositivo OutputFormat para que la extensión de representación IMAGE represente el informe en imágenes JPEG con los siguientes parámetros en la cadena de acceso URL: …&rs:Format=IMAGE&rc:OutputFormat=JPEG. Para obtener más información acerca de toda la configuración de información del dispositivo específica de la extensión, vea Configuración de información de dispositivos para las extensiones de representación (Reporting Services).

Comandos del servidor de informes (rs:)

En la tabla siguiente se describen los parámetros de acceso URL que tienen como prefijo rs: y se usan con el servidor de informes como destino.

Parámetro

Acción

Command

Realiza una acción en un elemento de catálogo, según el tipo de elemento. El valor predeterminado se determina mediante el tipo de elemento de catálogo al que se hace referencia en la cadena de acceso URL. Los valores válidos son:

  • ListChildren y GetChildren muestran el contenido de una carpeta. Los elementos de carpeta se muestran dentro de una página genérica de navegación por elementos.

    Por ejemplo, en modo Native.

    http://myrshost/reportserver?/Sales&rs:Command=GetChildren

    Por ejemplo, en modo SharePoint.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rs:Command=GetChildren
  • Render representa el informe especificado.

    Por ejemplo, en modo Native:

    http://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

    Por ejemplo, en modo SharePoint.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render
  • GetSharedDatasetDefinition muestra la definición XML asociada a un conjunto de datos compartido. Las propiedades del conjunto de datos compartido, incluidos la consulta, los parámetros del conjunto de datos, los valores predeterminados, los filtros del conjunto de datos y opciones de datos como la intercalación y la distinción entre mayúsculas y minúsculas, se guardan en la definición. Para usar este valor, debe tener el permiso leer definición de informe en un conjunto de datos compartido.

    Por ejemplo, en modo Native.

    https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition
  • GetDataSourceContents muestra las propiedades de un origen de datos compartido determinado como XML. Si el explorador admite código XML y es un usuario autenticado con el permiso Read Contents en el origen de datos, se muestra la definición del origen de datos.

    Por ejemplo, en modo Native.

    http://myrshost/reportserver?/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents

    Por ejemplo, en modo SharePoint.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents
  • GetResourceContents representa un recurso y lo muestra en una página HTML si el recurso es compatible con el explorador. De lo contrario, le preguntarán si desea abrir o guardar el archivo o recurso en el disco.

    Por ejemplo, en modo Native.

    http://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

    Por ejemplo, en modo SharePoint.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents
  • GetComponentDefinition muestra la definición XML asociada a un elemento de informe publicado. Para usar este valor, debe tener el permiso Leer contenido en un elemento de informe publicado.

Format

Especifica el formato en el que se representará un informe. Entre los valores habituales se incluyen ATOM, HTML4.0, MHTML, IMAGE, EXCEL, WORD, CSV, PDF, XML. El valor predeterminado es HTML4.0. Para obtener más información, vea Exportar un informe mediante el acceso URL.

Por ejemplo, para obtener una copia PDF de un informe directamente desde un servidor de informes en modo Native.

http://myrshost/ReportServer?/myreport&rs:Format=PDF

Por ejemplo, en modo SharePoint.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/myrereport.rdl&rs:Format=PDF

ParameterLanguage

Proporciona un idioma para los parámetros pasados en una dirección URL que es independiente del idioma del explorador. El valor predeterminado es el idioma del explorador. El valor puede ser un valor de referencia cultural, como en-us o de-de.

Por ejemplo en modo Native, para invalidar el idioma del explorador y especificar un valor de referencia cultural de-DE.

http://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE

Snapshot

Representa un informe basándose en una instantánea del historial de informes. Para obtener más información, vea Representar instantáneas del historial de informes mediante acceso URL.

Por ejemplo en modo Native, recupera una instantánea del historial de informes con fecha 2003-04-07 con una marca de tiempo de 13:40: 02.

http://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02

PersistStreams

Representa un informe en un flujo almacenado único. El procesador de imagen utiliza este parámetro para transmitir el informe representado fragmento por fragmento. Después de utilizar este parámetro en una cadena de acceso de dirección URL, utilice la misma cadena de acceso de dirección URL con el parámetro GetNextStream en lugar del parámetro PersistStreams para obtener el fragmento siguiente en el flujo almacenado. Este comando de dirección URL devolverá a la larga un flujo de cero bytes para indicar el fin del flujo almacenado. El valor predeterminado es false.

GetNextStream

Obtiene el fragmento de datos siguiente en un flujo almacenado al que se tiene acceso con el parámetro PersistStreams. Para obtener más información, vea la descripción de PersistStreams. El valor predeterminado es false.

SessionID

Especifica una sesión de informe activa establecida entre la aplicación cliente y el servidor de informes. El valor de este parámetro se establece en el identificador de la sesión.

Puede especificar el identificador de sesión como una cookie o como parte de la dirección URL. Cuando el servidor de informes se ha configurado para no usar las cookies de sesión, la primera solicitud sin un identificador de sesión especificado resulta en una redirección con un identificador de sesión. Para obtener más información sobre las sesiones del servidor de informes, vea Identificar el estado de ejecución.

ClearSession

Un valor de true indica al servidor de informes que quite un informe de la sesión de informe. Todas las instancias del informe asociadas a un usuario autenticado se quitan de la sesión de informe. (Una instancia del informe se define como el mismo informe ejecutado varias veces con diferentes valores de parámetro de informe). El valor predeterminado es false.

ResetSession

Un valor de true indica al servidor de informes que restablezca la sesión del informe y que quite la asociación de la sesión del informe con todas las instantáneas de informe. El valor predeterminado es false.

ShowHideToggle

Alterna el estado de mostrar u ocultar de una sección del informe. Especifique un entero positivo para representar la sección que desea alternar.

Comandos de elemento web del visor de informes (rv:)

En la tabla siguiente se describen los nombres de parámetros de informes reservados de SQL Server que se usan para tener como destino el elemento web del visor de informes cuando se integra con SharePoint. Estos nombres de parámetro tienen como prefijo rv:. El elemento web del visor de informes también acepta el parámetro rs:ParameterLanguage.

Parámetro

Acción

Toolbar

Controla la presentación de la barra de herramientas para el elemento web del visor de informes. El valor predeterminado es Full. Los valores pueden ser:

  • Full: muestra la barra de herramientas completa.

  • Navigation: solamente muestra la paginación en la barra de herramientas.

  • None: no muestra la barra de herramientas.

Por ejemplo, en modo de SharePoint, para mostrar solamente la paginación en la barra de herramientas.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation

HeaderArea

Controla la presentación del encabezado para el elemento web del visor de informes. El valor predeterminado es Full. Los valores pueden ser:

  • Full: muestra el encabezado completo.

  • BreadCrumbsOnly: muestra solamente la navegación detallada en el encabezado para informar al usuario de dónde se encuentra en la aplicación.

  • None: no muestra el encabezado.

Por ejemplo, en modo de SharePoint, para mostrar solamente la navegación detallada en el encabezado.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly

DocMapAreaWidth

Controla el ancho de la presentación, en píxeles, del área de parámetro en el elemento web del visor de informes. El valor predeterminado es igual que el valor predeterminado del elemento web del visor de informes. Debe ser un número entero no negativo.

AsyncRender

Controla si se representa un informe de forma asincrónica. El valor predeterminado es true, que especifica que un informe se representa de forma asincrónica. El valor debe ser un valor booleano de true o false.

ParamMode

Controla cómo se muestra el área de mensajes de parámetros del elemento web del visor de informes en la vista de página completa. Los valores válidos son:

  • Full: muestra el área de mensajes de parámetros.

  • Collapsed: contrae el área de mensajes de parámetros.

  • Hidden: oculta el área de mensajes de parámetros.

El valor predeterminado es Full.

Por ejemplo, en SharePoint, para ocultar el área de mensajes de parámetros.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed

DocMapMode

Controla cómo se muestra el área de mapa de documento del elemento web del visor de informes en la vista de página completa. Los valores válidos son:

  • Full: muestra el área de mapa del documento.

  • Collapsed: contrae el área de mapa del documento.

  • Hidden: oculta el área de mapa del documento.

El valor predeterminado es Full.

DockToolBar

Controla si la barra de herramientas del elemento web del visor de informes está acoplada a la parte superior o inferior. Los valores válidos son Top y Bottom. El valor predeterminado es Top.

Por ejemplo, en modo de SharePoint, para acoplar la barra de herramientas a la parte inferior.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom

ToolBarItemsDisplayMode

Controla qué elementos de la barra de herramientas se muestran. Es un valor de enumeración bit a bit. Para incluir un elemento de la barra de herramientas, agregue el valor del elemento al valor total. Por ejemplo: para un menú Acciones, use rv:ToolBarItemsDisplayMode=63 (o 0x3F), que es 1+2+4+8+16+32; solo para los elementos del menú Acciones, use rv:ToolBarItemsDisplayMode=960 (o 0x3C0). Los valores válidos son:

  1. 1 (0x1): el botón Atrás

  2. 2 (0x2): los controles de búsqueda de texto

  3. 4 (0x4): los controles de navegación de páginas

  4. 8 (0x8): el botón Actualizar

  5. 16 (0x10): el cuadro de lista Zoom

  6. 32 (0x20): el botón Fuente Atom

  7. 64 (0x40): la opción de menú Imprimir del menú Acciones

  8. 128 (0x80): el submenú Exportar del menú Acciones

  9. 256 (0x100: la opción de menú Abrir con el Generador de informes del menú Acciones

  10. 512 (0x200: la opción de menú Suscribir del menú Acciones

  11. 1024 (0x400: la opción de menú Nueva alerta de datos de Acciones

El valor predeterminado es -1, que incluye todos los elementos de la barra de herramientas.

Por ejemplo, en modo de SharePoint, para mostrar solamente el botón Atrás, controles de búsqueda de texto, controles de navegación por la página y el botón Actualizar.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15

Vea también

Conceptos

Acceso URL (SSRS)