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 a uma URL. Por exemplo, você pode ter visualizado o relatório usando um conjunto específico de valores de parâmetros de relatório. Você encapsula essas informações na URL usando parâmetros de acesso à URL predefinidos. Você personaliza ainda mais como o Power BI processa o relatório incorporando parâmetros para formatos de renderização ou para a aparência da barra de ferramentas de relatório. Em seguida, você cola esse URL diretamente em um e-mail ou página da Web para que outras pessoas experimentem seu relatório da mesma maneira no 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 para um relatório.
  • Inicie a exportação do conteúdo do relatório em um formato de arquivo suportado.
  • Oculte ou visualize o painel de parâmetros.
  • Especifique a configuração DeviceInfo .

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

Conceitos de acesso a 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 lida com solicitações de URL depende dos parâmetros, prefixos de parâmetros e 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 suportam endereçamento de URL padrão.

Sintaxe de 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 do serviço Power BI do seu 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 à URL.

&

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

prefixo

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

parâmetro

O nome do parâmetro.

valor

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

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

Você pode passar parâmetros de relatório para um relatório incluindo-os em uma URL de relatório paginada.

Parâmetros do relatório (rp:)

Para obter exemplos de passagem de parâmetros de relatório em uma URL, consulte Passar um parâmetro de relatório em uma URL.

Nota

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

Referência de parâmetro de acesso a URL

Você pode usar os seguintes parâmetros como parte de uma URL para configurar a aparência de seus relatórios paginados no Power BI. Os parâmetros mais comuns estão listados nesta seção. Os parâmetros não diferenciam maiúsculas de minúsculas e começam com o prefixo rdl: do parâmetro se estiverem relacionados 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 (PALAVRA)
  • CSV
  • PDF
  • ACESSÍVELPDF (PDF)
  • XML

Vista de relatório

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

  • rdl:reportView

Valores disponíveis:

  • interativo (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 é fechado ou aberto quando o relatório é carregado ou se está completamente oculto.

  • rdl:parameterPanel

Valores disponíveis:

  • recolhido: carrega o relatório com o painel de parâmetros fechado. O botão de parâmetro é ativado para que os usuários possam selecionar o botão para expandir.
  • oculto: carrega o relatório com o painel de parâmetros fechado e o botão de parâmetros desativado.
  • expandido (padrão): carrega o relatório com o painel de parâmetros aberto e o botão de parâmetro ativado.

Informações do dispositivo

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

  • PDF / ACESSÍVELPDF:

    • rdl:AccessiblePDF=true/false
    • rdl:Colunas=inteiro
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=inteiro
    • rdl:DpiY=inteiro
    • rdl:EndPage=inteiro
    • rdl:HumanReadablePDF=verdadeiro/falso
    • 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=inteiro

  • VCS:

    Nota

    Para esses valores de cadeia de caracteres, consulte as configurações de informações do dispositivo CSV.

    • rdl:Encoding=string
    • rdl:ExcelMode=verdadeiro/falso
    • rdl:FieldDelimiter=string
    • rdl:NoHeader=true/false
    • rdl:Qualifier=string
    • rdl:RecordDelimiter=string
    • rdl:SuppressLineBreaks=true/false
    • rdl:UseFormattedValues=true/false

  • WORDOPENXML (PALAVRA):

    • rdl:AutoFit=string -> Verdadeiro/Falso/Nunca/Padrão
    • rdl:ExpandToggles=true/false
    • rdl:FixedPageWidth=true/false
    • rdl:OmitDrillthroughs=true/false
    • rdl:OmitHyperlinks=true/false

  • EXCELOPENXML (EXCEL):

    • rdl:OmitDocumentMap=true/false
    • rdl:OmitFormulas=verdadeiro/falso
    • rdl:SimplePageHeaders=verdadeiro/falso

  • PPTX (PowerPoint):

    • rdl:Colunas=inteiro
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=inteiro
    • rdl:DpiY=inteiro
    • rdl:EndPage=inteiro
    • 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=inteiro
    • rdl:UseReportPageSize=true/false

  • XML:

    • rdl:Encoding=string
    • rdl:Recuado=verdadeiro/falso
    • 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 em seu relatório para fazer com que o Power BI abra esse hiperlink na mesma janela do navegador. Para obter informações sobre como adicionar hiperlinks a um relatório, consulte Adicionar um hiperlink a uma URL.

Conteúdos relacionados