Compartir vía


Parámetros de dirección URL en informes paginados en Power BI

SE APLICA A: Power BI Report Builder Power BI Desktop

Puede enviar comandos a informes paginados en Power BI agregando un parámetro a una dirección URL. Por ejemplo, puede que haya visto el informe con un conjunto específico de valores de parámetro de informe. Para encapsular esta información en la dirección URL, use los parámetros de acceso URL predefinidos. Puede personalizar aún más el modo en que Power BI procesa el informe mediante la inserción de parámetros para representar formatos o para la apariencia de la barra de herramientas de informe. Después, pegue esta dirección URL directamente en un correo o una página web para que otros usuarios puedan ver el informe de la misma manera en el explorador.

Estas son las acciones que puede realizar a través de los parámetros de acceso URL:

  • Enviar parámetros de informe a un informe.
  • Iniciar la exportación del contenido del informe en un formato de archivo compatible.
  • Ocultar o ver el panel de parámetros.
  • Especificar la configuración DeviceInfo.

Para obtener la lista completa de los comandos y las configuraciones disponibles mediante acceso URL, vea Referencia de parámetros de acceso URL en este artículo.

Conceptos de acceso URL

Las solicitudes URL a Power BI contienen parámetros que el servicio se encarga de procesar. La forma en que el servicio controla las solicitudes URL depende de los parámetros, los prefijos de parámetro y los tipos de elementos que se incluyen en la dirección URL. La función URL de informe paginado es compatible con la mayoría de los exploradores y las aplicaciones que admiten el direccionamiento de direcciones URL estándar.

Sintaxis de acceso URL

Las solicitudes URL pueden contener varios parámetros, que se enumeran en cualquier orden. Los parámetros están separados por una Y comercial (&). Los pares de nombre y valor están separados por un signo de igual (=). Por ejemplo:

powerbiservicereporturl?rp:parameter=value&rdl:parameter=value  

Descripción de la sintaxis

powerbiservicereporturl

Dirección URL servicio Power BI del informe paginado. Por ejemplo:

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0

?

Se usa para separar powerbiservicereporturl y los parámetros de acceso url.

&

Se usa para separar los pares de nombre y valor de los parámetros de acceso URL.

prefix

Prefijo para el parámetro de URL, que especifica una acción en el servicio Power BI. Por ejemplo, rp: o rdl:.

parámetro

El nombre del parámetro.

value

Texto de la URL que corresponde al valor del parámetro que se está usando.

Referencia de parámetro de informe de URL

Puede pasar parámetros de informe a un informe incluyéndolos en una URL de informe paginado.

Parámetros de informe (rp:)

Para obtener ejemplos de cómo pasar parámetros de informe en una dirección URL, vea Pasar un parámetro de informe en una dirección URL.

Nota

Los parámetros de informe necesitan el prefijo de parámetro rp: y distinguen entre mayúsculas y minúsculas.

Referencia de parámetros de acceso URL

Puede usar los siguientes parámetros como parte de una URL para configurar la apariencia de los informes paginados en Power BI. En esta sección se enumeran los parámetros más comunes. Los parámetros no distinguen entre mayúsculas y minúsculas y empiezan con el prefijo de parámetro rdl: si están relacionados con el formato de salida.

Comandos de informe (rdl:)

Formato de exportación

Especifica el formato en el que se va a representar y exportar un informe.

  • Por ejemplo: rdl:format=PDF

Valores disponibles:

  • PPTX (PowerPoint)
  • MHTML
  • IMAGEN
  • EXCELOPENXML (EXCEL)
  • WORDOPENXML (WORD)
  • CSV
  • PDF
  • ACCESSIBLEPDF (PDF)
  • XML

Vista de informe

Especifica el tipo de vista que se usa para mostrar el informe.

  • rdl:reportView

Valores disponibles:

  • interactive (valor predeterminado): carga el informe en modo interactivo.
  • pageView: carga el informe en el modo de vista de página.

Panel de parámetros

Especifica si el panel de parámetros está cerrado o abierto cuando se carga el informe, o si está oculto por completo.

  • rdl:parameterPanel

Valores disponibles:

  • collapsed: carga el informe con el panel de parámetros cerrado. El botón de parámetros está habilitado para que los usuarios puedan seleccionar el botón y expandirlo.
  • hidden: carga el informe con el panel de parámetros cerrado y el botón de parámetros deshabilitado.
  • expanded (valor predeterminado): carga el informe con el panel de parámetros abierto y el botón de parámetros habilitado.

Información del dispositivo

Puede especificar parámetros de salida adicionales para los siguientes formatos de exportación.

  • PDF / ACCESSIBLEPDF:

    • rdl:AccessiblePDF=true/false
    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • rdl:HumanReadablePDF=true/false
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=integer
  • CSV:

    Nota

    Para estos valores de cadena, haga referencia a la configuración de información del dispositivo CSV.

    • rdl:Encoding=string
    • rdl:ExcelMode=true/false
    • rdl:FieldDelimiter=string
    • rdl:NoHeader=true/false
    • rdl:Qualifier=string
    • rdl:RecordDelimiter=string
    • rdl:SuppressLineBreaks=true/false
    • rdl:UseFormattedValues=true/false
  • WORDOPENXML (WORD):

    • rdl:AutoFit=string -> True/False/Never/Default
    • rdl:ExpandToggles=true/false
    • rdl:FixedPageWidth=true/false
    • rdl:OmitDrillthroughs=true/false
    • rdl:OmitHyperlinks=true/false
  • EXCELOPENXML (EXCEL):

    • rdl:OmitDocumentMap=true/false
    • rdl:OmitFormulas=true/false
    • rdl:SimplePageHeaders=true/false
  • PPTX (PowerPoint):

    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=integer
    • rdl:UseReportPageSize=true/false
  • XML:

    • rdl:Encoding=string
    • rdl:Indented=true/false
    • rdl:OmitNamespace=true/false
    • rdl:OmitSchema=true/false
    • rdl:Schema=true/false
    • rdl:UseFormattedValues=true/false

Puede anexar rdl:targetSameWindow=truea la dirección URL del hipervínculo en el informe para que Power BI lo abra en la misma ventana del explorador. Para obtener información sobre cómo agregar hipervínculos a un informe, consulte Agregar un hipervínculo a una dirección URL.