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.
.gif "Nota importante") Importante |
|---|
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.
|
||
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. Por ejemplo, en modo SharePoint. |
||
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. Por ejemplo, en modo SharePoint. |
||
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. Por ejemplo en modo SharePoint, para mostrar la página 2 del informe. |
||
FindString |
Busca en un informe un conjunto específico de texto. Por ejemplo, en modo Native. Por ejemplo, en modo SharePoint. |
||
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. |
||
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:
|
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. Por ejemplo, en modo SharePoint. |
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. |
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. |
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:
Por ejemplo, en modo de SharePoint, para mostrar solamente la paginación en la barra de herramientas. |
HeaderArea |
Controla la presentación del encabezado para el elemento web del visor de informes. El valor predeterminado es Full. Los valores pueden ser:
Por ejemplo, en modo de SharePoint, para mostrar solamente la navegación detallada en el encabezado. |
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:
El valor predeterminado es Full. Por ejemplo, en SharePoint, para ocultar el área de mensajes de parámetros. |
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:
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. |
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:
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. |