Compartilhar via

Parâmetros de URL em relatórios paginados no Power BI

  • Artigo

APLICA-SE A: Power BI Report Builder Power BI Desktop

Você pode enviar comandos para relatórios paginados no Power BI adicionando um parâmetro em uma URL. Por exemplo, você pode ter exibido o relatório usando um conjunto específico de valores de parâmetro de relatório. Você encapsula essas informações na URL usando parâmetros de acesso à URL predefinidos. Você pode personalizar ainda mais a forma como o Power BI processa o relatório inserindo parâmetros para formatos de renderização ou para determinar a aparência e o estilo da barra de ferramentas de relatório. Em seguida, você pode colar essa URL diretamente em um email ou uma página da Web para que outras pessoas experimentem o relatório da mesma maneira em um navegador.

Aqui estão as ações que você pode executar por meio de parâmetros de acesso à URL:

  • Enviar parâmetros de relatório a um relatório.
  • Iniciar a exportação do conteúdo do relatório em um formato de arquivo compatível.
  • Ocultar ou exibir o painel de parâmetros.
  • Especificar a configuração DeviceInfo.

Para obter a lista completa de comandos e configurações disponíveis por meio do acesso à URL, confira Referência de parâmetro de acesso à URL mais adiante neste artigo.

Conceitos de acesso à URL

As solicitações de URL para o Power BI contêm parâmetros que são processados pelo serviço. A maneira como o serviço gerencia as solicitações de URL depende dos parâmetros, dos prefixos de parâmetro e dos tipos de itens incluídos na URL. A funcionalidade de URL de relatório paginado é compatível com a maioria dos navegadores e aplicativos que são compatíveis com o endereçamento de URL padrão.

Sintaxe do acesso à URL

As solicitações de URL podem conter vários parâmetros, listados em qualquer ordem. Os parâmetros são separados por um E comercial (&). Os pares de nome e valor são separados por um sinal de igual (=). Por exemplo:

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

Descrição da sintaxe

powerbiservicereporturl

A URL de serviço do Power BI do relatório paginado. Por exemplo:

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

?

Usado para separar o powerbiservicereporturl e os parâmetros de acesso da URL.

&

Usado para separar os pares de nome e valor dos parâmetros de acesso à URL.

prefixo

Um prefixo para o parâmetro da URL que especifique uma ação no serviço do Power BI. Por exemplo, rp: ou rdl:.

parâmetro

O nome do parâmetro.

value

Texto da URL correspondente ao valor do parâmetro que está sendo usado.

Referência de parâmetro de relatório da URL

Você pode passar parâmetros de relatório para um relatório, incluindo-os na URL de um relatório paginado.

Parâmetros de relatório (rp:)

Para ver exemplos de como passar parâmetros de relatório em uma URL, confira Passar um parâmetro de relatório em uma URL.

Observação

Os parâmetros de relatório exigem um prefixo de parâmetro rp: e diferenciam maiúsculas de minúsculas.

Referência de parâmetro de acesso à URL

Você pode usar os parâmetros a seguir como parte de uma URL para configurar a aparência e o estilo dos seus relatórios paginados no Power BI. Os parâmetros mais comuns são listados nesta seção. Os parâmetros não diferenciam maiúsculas de minúsculas e começam com o prefixo de parâmetrordl:, se relacionado ao formato de saída.

Comandos de relatório (rdl:)

Formato de exportação

Especifica o formato no qual renderizar e exportar um relatório.

  • Por exemplo: rdl:format=PDF

Valores disponíveis:

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

Exibição de relatório

Especifica o tipo de visualização usado para exibir o relatório.

  • rdl:reportView

Valores disponíveis:

  • interactive (padrão): carrega o relatório no modo interativo.
  • pageView: carrega o relatório no modo de exibição de página.

Painel de parâmetros

Especifica se o painel de parâmetros fica fechado, aberto ou totalmente oculto quando o relatório é carregado.

  • rdl:parameterPanel

Valores disponíveis:

  • hidden: carrega o relatório com o painel de parâmetros fechado. O botão de parâmetro é habilitado para que os usuários possam selecionar o botão para expandi-lo.
  • oculto: carrega o relatório com o painel de parâmetros fechado e o botão de parâmetro desabilitado.
  • expanded (padrão): carrega o relatório com o painel de parâmetros aberto e o botão de parâmetro habilitado.

Informações do dispositivo

Você pode especificar parâmetros de saída adicionais para os formatos de exportação a seguir.

  • 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:

    Observação

    Para esses valores string, faça referência às configurações de informações do 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

Você pode acrescentar rdl:targetSameWindow=true à URL do hiperlink no seu relatório para que o Power BI abra esse hiperlink na mesma janela do navegador. Para obter informações sobre como adicionar hiperlinks a um relatório, confira Adicionar um hiperlink a uma URL.

Conteúdo relacionado