Pasar un parámetro de informe en una URL para un informe paginado en Power BI

  • Artículo

SE APLICA A: Power BI Report Builder Power BI Desktop

Puede pasar parámetros de informe a un informe incluyéndolos en una dirección URL de informe para Informes paginados. Estos parámetros de dirección URL no tienen prefijo porque se pasan directamente al motor de procesamiento de informes.

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 (Power BI Report Builder).

Reglas de parámetros de informe paginado

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.
  • Si no incluye la sintaxis de proxy, agregue rp: como prefijo del parámetro.

Ejemplos de parámetros de informe paginado

Para establecer un parámetro de informe dentro de una dirección URL, use la siguiente sintaxis:

  
rp:parameter=value

Por ejemplo, para especificar dos parámetros, "Salesperson" y "State", definidos en un informe de Mi área de trabajo, usaría la siguiente dirección URL:

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:State=Utah

Para especificar los mismos dos parámetros definidos en un informe en una aplicación, usaría esta URL:

https://app.powerbi.com/groups/me/apps/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0/rdlreports/xxxxxxx-639e-41d0-b733-05d2bca9853c?rp:Salesperson=Tiggee&rp:State=Utah

Para pasar un valor NULL para un parámetro, use la siguiente sintaxis:

  
parameter:isnull=true

Por ejemplo,

rp: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 de 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.

Ejemplos adicionales

En el siguiente ejemplo de URL se incluye un parámetro de varios valores "Salesperson". El formato para un parámetro multivalor es repetir el nombre del parámetro para cada valor.

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:Salesperson=Mickey

En el siguiente ejemplo de dirección URL se pasa un único parámetro de SellStartDate con un valor de "7/1/2005".

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:SellStartDate=7/1/2005

Consideraciones y limitaciones

  • Si el informe contiene un parámetro de informe con un valor predeterminado y el valor de la propiedad Prompt es false (es decir, la propiedad Prompt User no está seleccionada en Power BI Report Builder), no se puede pasar un valor para ese parámetro de informe dentro de una dirección URL. Esto proporciona a los administradores la opción de impedir que los usuarios finales agreguen o modifiquen los valores de determinados parámetros de informe.
  • Power BI no admite una cadena de consulta de más de 2000 caracteres. Es posible que supere accidentalmente este valor si usa parámetros de dirección URL para ver el informe paginado, en especial si la cadena de consulta contiene varios valores de parámetro. Para cargar correctamente el informe, reduzca el número de caracteres a menos de 2000.
  • El límite de la cadena de consulta se evalúa después de haber iniciado sesión en Power BI. Si abre el informe antes de iniciar sesión, se reduce el límite.

Contenido relacionado