Partilhar via

Coleções internas - Referências globais e de usuário em um relatório paginado (Construtor de Relatórios do Power BI)

  • Artigo

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

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

Use a Coleção Globals

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

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

Para numerar páginas em 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. Não suportado em grupos de hierarquia de colunas tablix.

PageNumber só pode ser usado 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 que OverallTotalPages.

TotalPages só pode ser usado em uma expressão em um cabeçalho ou rodapé de página.
Nome da página Cadeia O nome da página. No início do processamento do relatório, o valor inicial é definido a partir de InitialPageName, uma propriedade de relatório. À medida que cada item de 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. Não suportado em grupos de hierarquia de colunas tablix.

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

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

OverallTotalPages só pode ser usado 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.

Os membros da coleção Globals retornam uma variante. Se você quiser usar um membro dessa coleção em uma expressão que exija um tipo de dados específico, você deve primeiro converter a variável. Por exemplo, para converter a variante de tempo de execução em um formato Data, use =CDate(Globals!ExecutionTime). Para obter mais informações, consulte Tipos de dados em expressões (Construtor de Relatórios do Power BI).

RenderFormat

A tabela a seguir descreve os membros para RenderFormat.

Membro Tipo Description
Name Cadeia O nome do renderizador registrado.

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

Os valores de cadeia de caracteres podem ser especificados usando a chave ou um índice na coleção.

Exemplos

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

  • Esta expressão, colocada numa caixa de texto no rodapé de um relatório, fornece o número da página e o total de páginas do 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 formatação do Microsoft .NET Framework para data curta:

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

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

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

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

Usar a coleção de usuários

A coleção User contém dados sobre o usuário que está executando o relatório. Você pode usar essa coleção para filtrar os dados que aparecem em um relatório, por exemplo, mostrando apenas os dados do usuário atual, ou para exibir o UserID, por exemplo, em um título de relatório. Na superfície de design, essas variáveis aparecem prefixadas por um & (e comercial), por exemplo, [&UserID].

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

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

Usar configurações de localidade

Você pode usar expressões para fazer referência às configurações de localidade em um computador cliente por meio do valor User.Language para determinar como um relatório aparece para o usuário. Por exemplo, você pode criar um relatório que usa uma expressão de consulta diferente com base no valor de localidade. A consulta pode mudar para recuperar informações localizadas de uma coluna diferente, dependendo do idioma retornado. Você também pode usar uma expressão nas configurações de idioma do relatório ou itens de relatório com base nessa variável.

Nota

Embora seja possível alterar as configurações de idioma de um relatório, você deve ter cuidado com quaisquer problemas de exibição que isso possa causar. Por exemplo, alterar a configuração de localidade do relatório pode alterar o formato de data no relatório, mas também pode alterar o formato de moeda. A menos que haja um processo de conversão para a moeda, isso pode fazer com que o símbolo de moeda incorreto seja exibido no relatório. 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 para um idioma específico.

Próximos passos