Compartilhar via

Coleções integradas - referências Globais e de Usuário em um relatório paginado (Power BI Report Builder)

  • Artigo

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

A coleção de campos internos, que inclui as coleções Globals e User, representa valores globais fornecidos pelo Reporting Services quando um relatório paginado é processado. A coleção de Globals fornece valores, como o nome do relatório, a hora em que o seu processamento foi iniciado e os números das páginas atuais para o cabeçalho ou o rodapé do relatório. A coleção de User fornece o identificador de usuário e configurações de idioma. Esses valores podem ser usados em expressões para filtrar resultados em um relatório.

Use a Coleção de Globais

A coleção de Globals contém as variáveis globais para o relatório. Na superfície de design, essas variáveis são exibidas prefixadas por um & (E comercial), por exemplo, [&ReportName]. A tabela a seguir descreve os membros da coleção de Globals .

Membro Tipo Descrição
ExecutionTime DateTime A data e a hora em que o relatório começou a ser executado.
PageNumber Inteiro O número da página atual em relação às quebras de página que redefinem o número da página. No início do processamento do relatório, o valor inicial é definido como 1. O número da página é incrementado para cada página renderizada.

Para numerar páginas dentro de quebras de página para um retângulo, uma região de dados, um grupo de regiões de dados ou um mapa, na propriedade PageBreak, defina a propriedade ResetPageNumber como True. Sem suporte em grupos de hierarquias de colunas tablix.

PageNumber somente pode ser usada em uma expressão em um cabeçalho ou rodapé de página.
TotalPages Inteiro O número total de páginas em relação às quebras de página que redefinem PageNumber. Se nenhuma quebra de página for definida, esse valor será o mesmo de OverallTotalPages.

TotalPages somente pode ser usada em uma expressão em um cabeçalho ou rodapé de página.
PageName Cadeia de caracteres O nome da página. No início do processamento do relatório, o valor inicial é definido por meio de InitialPageName, uma propriedade de relatório. À medida que cada item do relatório é processado, esse valor é substituído pelo valor correspondente de PageName de um retângulo, uma região de dados, um grupo de regiões de dados ou um mapa. Sem suporte em grupos de hierarquias de colunas tablix.

PageName somente pode ser usada em uma expressão em um cabeçalho ou rodapé de página.
OverallPageNumber Inteiro O número da página atual para todo o relatório. Esse valor não é afetado por ResetPageNumber.

OverallPageNumber somente pode ser usada em uma expressão em um cabeçalho ou rodapé de página.
OverallTotalPages Inteiro O número total de páginas para todo o relatório. Esse valor não é afetado por ResetPageNumber.

OverallTotalPages somente pode ser usada em uma expressão em um cabeçalho ou rodapé de página.
RenderFormat RenderFormat Informações sobre a solicitação de renderização atual.

Para obter mais informações, consulte "RenderFormat" na próxima seção.

Membros da coleção de Globals retornam uma variante. Se você desejar usar um membro dessa coleção em uma expressão que exige um tipo de dados específico, deverá primeiro converter a variável. Por exemplo, para converter a variante de tempo de execução em um formato de Data, use =CDate(Globals!ExecutionTime). Para saber mais, confira Tipo de Dados em Expressões (Power BI Report Builder).

RenderFormat

A tabela a seguir descreve os membros de RenderFormat.

Membro Type Descrição
Nome Cadeia de caracteres O nome do renderizador registrado.

Disponível durante partes específicas do ciclo de processamento/renderização do relatório.
IsInteractive Booliano Se a solicitação de renderização atual usa um formato de renderização interativo.
DeviceInfo Coleção de nomes/valores somente leitura Pares de chave/valor para parâmetros deviceinfo da solicitação de renderização atual.

É possível especificar valores de cadeia de caracteres usando a chave ou um índice na coleção.

Exemplos

Os exemplos a seguir mostram como usar uma referência à coleção de Globals em uma expressão:

  • Esta expressão, colocada em uma caixa de texto no rodapé de um relatório, fornece o número da página e o total de páginas no relatório:

    =Globals.PageNumber & " of " & Globals.TotalPages

  • Esta expressão fornece o nome do relatório e a hora em que foi executado. A hora é formatada com a cadeia de caracteres de formatação de data abreviada do Microsoft .NET Framework:

    =Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")

  • Esta expressão, colocada na caixa de diálogo Visibilidade da Coluna para uma coluna selecionada, exibe a coluna somente quando o relatório é exportado para o Excel. Caso contrário, a coluna fica oculta.

    EXCELOPENXML se refere ao formato do Excel que é incluído no Office 2007. EXCEL se refere ao formato do Excel que é incluído no Office 2003.

    =IIF(Globals!RenderFormat.Name = "EXCELOPENXML" OR Globals!RenderFormat.Name = "EXCEL", false, true)

Usando a Coleção de Usuário

A coleção de User contém dados sobre o usuário que está executando o relatório. É possível usar essa coleção para filtrar os dados exibidos em um relatório, por exemplo, mostrando apenas os dados do usuário atual ou para exibir a ID do usuário, por exemplo, em um título do relatório. Na superfície de design, essas variáveis são exibidas prefixadas por um & (E comercial), por exemplo, [&UserID].

A tabela a seguir descreve os membros da coleção de User .

Membro Tipo Descrição
Idioma Cadeia de caracteres O idioma do usuário que está executando o relatório. Por exemplo, en-US.
UserID Cadeia de caracteres A ID do usuário que está executando o relatório.

Configurações de Localidade

É possível usar expressões para se fazer referência a configurações de localidade em um computador cliente por meio do valor de User.Language para determinar como um relatório é exibido para o usuário. Por exemplo, você pode criar um relatório que usa uma expressão de consulta diferente baseada no valor da localidade. A consulta pode se alterada para recuperar informações localizadas de uma coluna diferente dependendo do idioma retornado. Também é possível usar uma expressão nas configurações do idioma do relatório ou de itens de relatório baseados nessa variável.

Observação

Embora seja possível alterar as configurações do idioma de um relatório, você deve ter cuidado em relação a qualquer problema de exibição que isso possa provocar. Por exemplo, a alteração da configuração de localidade do relatório pode alterar o formato de data no relatório, mas também o formato da moeda. Isso pode fazer com que o símbolo da moeda incorreta seja exibido no relatório, a não ser que haja um processo de conversão de moeda. Para evitar isso, defina as informações de idioma sobre os itens individuais que você deseja alterar ou defina o item com os dados de moeda como um idioma específico.

Próximas etapas