Pasar un parámetro de informe en una dirección URL
Puede pasar parámetros de informe a un informe incluyéndolos en un informe URL. Estos parámetros de dirección URL no tienen prefijo porque se pasan directamente al motor de procesamiento de informes.
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.
Si no incluye la sintaxis de proxy, tendrá que agregar rp: como prefijo del parámetro.
Todos los parámetros de consulta pueden tener parámetros de informe correspondientes. Para pasar un parámetro de consulta a un informe, pase el parámetro de informe correspondiente. Para obtener más información, consulte Crear una consulta en el Diseñador de consultas relacionales (Generador de informes y SSRS).
Importante
Los parámetros de informe distinguen entre mayúsculas y minúsculas.
Nota:
Los parámetros de informe distinguen mayúsculas de minúsculas y usan los caracteres especiales siguientes:
- Cualquier carácter de espacio en blanco en la cadena de dirección URL se reemplaza con los caracteres "% 20", según los estándares de codificación de direcciones URL.
- Un carácter de espacio en la parte del parámetro de la dirección URL se reemplaza con un carácter más (+).
- Un punto y coma en cualquier parte de la cadena se reemplaza con los caracteres “%3A”.
- Los exploradores deberían realizar de forma automática la codificación de dirección URL apropiada. No tiene que codificar ninguno de los caracteres manualmente.
Para establecer un parámetro de informe dentro de una dirección URL, use la siguiente sintaxis:
parameter=value
Por ejemplo, para especificar dos parámetros, "ReportMonth" y "ReportYear", definidos en un informe, use las direcciones URL siguientes para un servidor de informes en modo nativo:
http://myrshost/ReportServer?/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2&ReportMonth=3&ReportYear=2008
Por ejemplo, para especificar los mismos parámetros definidos en un informe, use las direcciones URL siguientes para un servidor de informes en modo integrado de SharePoint: Anote /_vti_bin
:
http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.rdl&ReportMonth=3&ReportYear=2008
Para pasar un valor NULL para un parámetro, use la siguiente sintaxis:
parameter
:isnull=true
Por ejemplo,
SalesOrderNumber:isnull=true
Para pasar un valor Boolean
, use 0 para FALSE o 1 para TRUE. Para pasar un valor Float
, incluya el separador decimal correspondiente a la configuración regional del servidor.
Nota
Si un informe contiene un parámetro de informe con un valor predeterminado y el valor de la propiedad Prompt
es false
(es decir, la propiedad Preguntar al usuario no está seleccionada en el Administrador de informes), no puede pasar un valor dentro de una dirección URL para ese parámetro de informe. Esto proporciona a los administradores una opción para evitar que los usuarios finales agreguen o modifiquen los valores de ciertos parámetros de informe.
Otros ejemplos
En el ejemplo siguiente de dirección URL se incluyen espacios en blanco y varios parámetros
El nombre de carpeta de "Equipo de educación de usuarios de SQL Server" incluye espacios en blanco y, por tanto, el signo "+" reemplaza cada espacio.
El nombre de informe "informe de proyecto de equipo" incluye espacios en blanco y, por tanto, el signo "+" reemplaza cada espacio.
Pasa dos parámetros de "teamgrouping2" con un valor de "xgroup" y "teamgrouping1" con un valor de "ygroup".
https://myserver/Reportserver?/SQL+Server+User+Education+Team/_ContentTeams/folder123/team+project+report&teamgrouping2=xgroup&teamgrouping1=ygroup
En el ejemplo siguiente de dirección URL se incluye un parámetro "OrderID" con varios valores. El formato de un parámetro multivalor es repetir el nombre del parámetro para cada valor.
https://myserver/Reportserver?/SQL+Server+User+Education+Team/_ContentTeams/folder123/team+project+report&teamgrouping2=xgroup&teamgrouping1=ygroup&OrderID=747&OrderID=787&OrderID=12
En el siguiente ejemplo de dirección URL se pasa un único parámetro de SellStartDate con el valor "7/1/2005" para un servidor de informes en modo nativo.
http://myserver/ReportServer/Pages/ReportViewer.aspx?%2fProduct_and_Sales_Report_AdventureWorks&SellStartDate=7/1/2005