Referencia de parámetros de acceso URL
Puede usar parámetros como parte de una dirección URL para configurar la apariencia de los informes de SQL Server 2016 (13.x) Reporting Services (SSRS) o versiones posteriores. En este artículo se describen los parámetros más usados.
Los parámetros no distinguen mayúsculas de minúsculas. Requieren un prefijo:
rs:: tiene como destino el servidor de informes.rc:: tiene como destino un visor de HTML.rv:: tiene como destino el elemento web del Visor de informes.
También puede especificar parámetros que son específicos de dispositivos o extensiones de representación. Para más información sobre parámetros específicos del dispositivo, vea Especificación de la configuración de la información del dispositivo en una dirección URL.
Importante
En un servidor de informes en modo SharePoint, 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 aporta el contexto que la solicitud HTTP necesita para garantizar la ejecución correcta del informe de los servidores de informes en modo SharePoint. Para obtener ejemplos, vea Acceso a elementos del servidor de informes mediante el acceso URL.
La integración de Reporting Services con SharePoint ya no está disponible a partir de SQL Server 2016.
Comandos del Visor de HTML (rc:)
Diríjase al Visor de HTML mediante el prefijo rc:.
| Get-Help | Parámetro | Descripción |
|---|---|---|
Toolbar |
True |
Muestra la barra de herramientas. El valor predeterminado es true. Nota: Si omite este parámetro, la barra de herramientas se muestra automáticamente para los formatos de representación que lo admiten. |
Toolbar |
False |
Oculta la barra de herramientas. Si este parámetro es false, se omiten todas las opciones restantes. |
Toolbar |
Navigation |
solo muestra la paginación en la barra de herramientas. |
Parameters |
True |
Muestra el área de parámetros de la barra de herramientas. El valor predeterminado es true. Ejemplos: Modo nativo: https://myrshost/reportserver?/Sales&rc:Parameters=CollapsedModo SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed |
Parameters |
False |
Oculta el área de parámetros y el usuario no puede mostrarla. |
Parameters |
Collapsed |
Oculta el área de parámetros, pero el usuario puede mostrarla u ocultarla a su discreción. Ejemplos: Modo nativo: https://myrshost/reportserver?/Sales&rc:Parameters=CollapsedModo SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed |
Zoom |
Page Width |
Establezca el zoom del informe para que se ajuste al ancho de página. Ejemplos: Modo nativo: https://myrshost/reportserver?/Sales&rc:Zoom=Page%20WidthModo SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page%20Width |
Zoom |
Whole Page |
Establezca el zoom del informe para que se ajuste a toda la página. |
Zoom |
<integer percentage> |
Establezca el zoom del informe en un porcentaje específico. El valor predeterminado es 100. |
Section |
<page number> |
Establezca la página del informe que se mostrará. Cualquier valor que sea mayor que el número de páginas del informe muestra la última página. Cualquier valor que sea menor que 0 muestra la página 1 del informe. El valor predeterminado es 1. Ejemplos: Modo nativo: https://myrshost/reportserver?/Sales&rc:Section=2Modo SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2 |
FindString |
<text> |
Busque un conjunto de texto específico en un informe y resalte el texto. Nota: rc:FindString no funciona a menos que incluya rc:Toolbar=false en la cadena de acceso de la dirección URL.Ejemplos: Modo nativo: https://myrshost/reportserver?/Sales&rc:Toolbar=false&rc:FindString=Mountain-400Modo SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Toolbar=false&rc:FindString=Mountain-400 |
StartFind |
<start page> |
Especifique la primera sección que se va a buscar. El valor predeterminado es la primera página del informe. Ejemplo: Modo nativo: https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400 |
EndFind |
<end page> |
Establezca el número de la última página que desea utilizar en la búsqueda. El valor predeterminado es el número de la página actual. Use este parámetro con el parámetro StartFind.Ejemplo: vea el ejemplo StartFind. |
FallbackPage |
<page number> |
Establezca 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 |
<icon name> |
Obtenga una imagen determinada para la interfaz de usuario del Visor de HTML. |
Icon |
<icon name> |
Obtenga el icono de una extensión de representación determinada. |
Stylesheet |
<stylesheet file name> |
Especifique una hoja de estilo que desee aplicar al Visor de HTML. |
| Configuración de la información del dispositivo | Especifique 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. Para obtener más información, consulte la descripción del comando Format.Puede usar la configuración de información del dispositivo OutputFormat para que la extensión de representación IMAGE represente el informe en una imagen JPEG con los siguientes parámetros en la cadena de acceso URL: ...&rs:Format=IMAGE&rc:OutputFormat=JPEG. Para más información sobre toda la configuración de información del dispositivo específica de la extensión, consulte Configuración de información del dispositivo para las extensiones de representación (Reporting Services). |
Comandos del servidor de informes (rs:)
Establezca como destino el servidor de informes mediante el prefijo rs:.
| Get-Help | Parámetro | Descripción |
|---|---|---|
Command |
ListChildren y GetChildren |
Muestra el contenido de una carpeta. Los elementos de carpeta se muestran dentro de una página genérica de navegación por elementos. Ejemplos: Modo nativo: https://myrshost/reportserver?/Sales&rs:Command=GetChildrenUna instancia con nombre en modo nativo: https://myssrshost/Reportserver_THESQLINSTANCE?/reportfolder&rs:Command=listChildrenModo SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren |
Command |
Render |
El informe se representa en el navegador para que pueda verlo. Ejemplos: Modo nativo: https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=RenderModo SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render |
Command |
GetSharedDatasetDefinition |
Muestra la definición XML asociada a un conjunto de datos compartido. Las propiedades del conjunto de datos compartido se guardan en la definición. Estas propiedades incluyen 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. Para usar este valor, debe tener el permiso para leer definición de informe en un conjunto de datos compartido. Ejemplo: Modo nativo: https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition |
Command |
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 Leer contenido en el origen de datos, muestra la definición del origen de datos. Ejemplos: Modo nativo: https://myrshost/reportserver?/Sales/AdventureWorks2022&rs:Command=GetDataSourceContentsModo SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents |
Command |
GetResourceContents |
Representa un recurso y lo muestra en una página HTML si el recurso es compatible con el navegador. De lo contrario, puede elegir abrir o guardar el archivo o recurso en el disco. Ejemplos: Modo nativo: https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContentsModo SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents |
Command |
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 |
HTML5PPTXATOMHTML4.0MHTMLIMAGEEXCEL (para .xls)EXCELOPENXML (para .xlsx)WORD (para .doc)WORDOPENXML (para .docx)CSVPDFXML |
Especifique el formato en el que se representará y verá un informe. El valor predeterminado es HTML5. Para obtener más información, vea Exportación de un informe con el acceso URL. Para una lista completa, consulte la sección de la extensión \<Render> del archivo rsreportserver.config del servidor de informes. Para más información, consulta El archivo de configuración RSReportServer.config. Ejemplos: Modo nativo: https://myrshost/ReportServer?/myreport&rs:Format=PDF Modo SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF |
ParameterLanguage |
en-us, de-DE, etc. |
Proporcione un idioma para los parámetros pasados en una dirección URL que es independiente del idioma del navegador. El valor predeterminado es el idioma del explorador. Ejemplo: Modo nativo: https://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 Representación de instantáneas del historial de informes mediante acceso URL. Ejemplo: Modo nativo: https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02 |
|
PersistStreams |
truefalse |
Representa un informe en un flujo almacenado único. El procesador de la 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 devuelve en última instancia un flujo de cero bytes para indicar el fin del flujo almacenado. El valor predeterminado es false. |
GetNextStream |
truefalse |
Obtiene el siguiente fragmento de datos en un flujo almacenado al que se accede con el parámetro PersistStreams. Para obtener más información, consulte la descripción del comando 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 configura el servidor de informes 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 |
truefalse |
Elimine todas las instancias del informe asociadas a un usuario autenticado 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. Los valores válidos son true y false. |
ResetSession |
truefalse |
Restablezca la sesión del informe eliminando la asociación de la sesión del informe con todas las instantáneas de informe. El valor predeterminado es false. Los valores válidos son true y false. |
ShowHideToggle |
<positive integer> |
Alterne el estado de mostrar u ocultar 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:)
Dirija el elemento web del Visor de informes que se integra con SharePoint mediante el prefijo rv:. El elemento web del Visor de informes también acepta el parámetro rs:ParameterLanguage.
| Get-Help | Parámetro | Descripción |
|---|---|---|
Toolbar |
Full |
muestra la barra de herramientas completa. El valor predeterminado es Full. |
Toolbar |
Navigation |
solo muestra la paginación en la barra de herramientas. Ejemplo: Modo SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation |
Toolbar |
None |
no muestra la barra de herramientas. |
HeaderArea |
Full |
muestra el encabezado completo. El valor predeterminado es Full. |
HeaderArea |
BreadCrumbsOnly |
muestra solo la navegación detallada en el encabezado para informar al usuario de dónde se encuentra en la aplicación. Ejemplo: Modo SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly |
HeaderArea |
None |
Oculta el encabezado. |
DocMapAreaWidth |
Controla el ancho de la presentación, en píxeles, del área de parámetros 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 |
truefalse |
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 |
Full |
muestra el área de mensajes de parámetros. El valor predeterminado es Full. |
Collapsed |
contrae el área de mensajes de parámetros. Ejemplo: Modo SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed |
|
ParamMode |
Hidden |
oculta el área de mensajes de parámetros. |
DocMapMode |
Full |
muestra el área de mapa del documento. El valor predeterminado es Full. |
DocMapMode |
Collapsed |
contrae el área de mapa del documento. |
DocMapMode |
Hidden |
oculta el área de mapa del documento. |
DockToolBar |
Top |
Acopla la barra de herramientas en la parte superior. El valor predeterminado es Top. |
DockToolBar |
Bottom |
Acopla la barra de herramientas en la parte inferior. Ejemplo: Modo SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom |
ToolBarItemsDisplayMode |
1 (0x1) |
Botón Atrás |
ToolBarItemsDisplayMode |
2 (0x2) |
Controles de búsqueda de texto |
ToolBarItemsDisplayMode |
4 (0x4) |
Controles de navegación en páginas |
ToolBarItemsDisplayMode |
8 (0x8) |
Botón Actualizar |
ToolBarItemsDisplayMode |
16 (0 x 10) |
Control de Zoom |
ToolBarItemsDisplayMode |
32 (0x20) |
Botón de fuente Atom |
ToolBarItemsDisplayMode |
64 (0x40) |
Opción de menú Imprimir en Acciones |
ToolBarItemsDisplayMode |
128 (0x80) |
Submenú Exportar en Acciones |
ToolBarItemsDisplayMode |
256 (0x100) |
Opción de menú Abrir con el Generador de informes en Acciones |
ToolBarItemsDisplayMode |
512 (0x200) |
Opción de menú Suscribirse en Acciones |
ToolBarItemsDisplayMode |
1024 (0 x 400) |
Opción de menú Nueva alerta de datos en Acciones |
ToolBarItemsDisplayMode |
Varios valores | Controla qué elementos de la barra de herramientas se muestran. Este valor 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 que no se muestre el menú Acciones, use rv:ToolBarItemsDisplayMode=63 (o 0x3F), que es 1+2+4+8+16+32. Solo para elementos de menú de Acciones , use rv:ToolBarItemsDisplayMode=960 (o 0x3C0). El valor predeterminado es -1, que incluye todos los elementos de la barra de herramientas. Los valores válidos son:Ejemplo: Modo SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15 |