Sobre Filtros

Use a sintaxe de filtro dinâmico para criar filtros flexíveis que você possa designar a diversos usuários e grupos.

As linhas de filtro podem conter os seguintes elementos como parte de sua definição, além das expressões de membro.

$loginuser

Essa variável armazena o valor do usuário atual conectado no runtime. Ela pode ser usada em conjunto com o método @datasourcelookup.

$logingroup

Essa variável armazena o valor de todos os grupos aos quais o usuário atual conectado pertence. Ela inclui grupos diretos e indiretos. Quando usado em conjunto com o método @datasourcelookup, cada grupo é consultado individualmente na Origem de Dados.

@datasourcelookup

Esse método extrai registros de uma Origem de Dados.

Sintaxe

@datasourcelookup (dataSourceName, columnName, columnValue, returnColumnName)

Descrição

Uma chamada @datasourcelookup é equivalente à seguinte consulta SQL:

select returnColumnName from dataSourceName where columnName=columnValue

@datasourcelookup pesquisa a Origem de Dados em questão e procura registros, em que columnName contém columnValue. Se você especificar columnValue como $loginuser, esse método procurará registros em que columnName contém o nome do usuário conectado atualmente.

O Essbase forma a linha de definição de filtro, combinando os elementos da lista como uma string separada por vírgula. Se qualquer registro contiver caracteres especiais, espaços ou somente números, será colocado entre aspas.

Exemplos

Coloque os parâmetros entre aspas.

A seguinte chamada consulta uma Origem de Dados global e retorna uma lista de nomes de loja onde Mary é a gerente.

@datasourceLookup("StoreManagersDS","STOREMANAGER","Mary","STORE")

A seguinte chamada consulta uma Origem de Dados no nível do aplicativo e retorna uma lista de nomes de loja onde o usuário atualmente conectado é o gerente.

@datasourceLookup("Sample.StoreManagersDS","STOREMANAGER","$loginuser","STORE")

A seguinte chamada consulta uma Origem de Dados no nível do aplicativo e retorna uma lista de nomes de loja onde o departamento da loja corresponde a qualquer um dos grupos aos quais o usuário conectado pertence.

@datasourceLookup("Sample.StoreManagersDS","STORE_DEPARTMENT","$logingroup","STORE")

Se o usuário conectado pertencer a 3 grupos, o método @datasourcelookup acima retornará todos os valores de coluna correspondentes de cada grupo.

Use o seguinte workflow geral para criar filtros dinâmicos.

Esse workflow de filtros dinâmicos presume que você já tenha um cubo, além de usuários e grupos provisionados.

1. Identifique uma origem de dados, quer seja um arquivo ou uma origem relacional.
2. Defina a conexão e a Origem de Dados no Essbase, seja globalmente ou no nível do aplicativo.
3. Crie filtros no nível do cubo,
   • Na Interface Redwood, navegue até o cubo, escolha Personalização e depois escolha Filtros.

   • Na Interface Web Clássica, use a seção Filtros do inspetor de banco de dados.

4. Defina linhas para cada filtro, usando a sintaxe de filtro dinâmico para empregar a variável $loginuser, a variável $logingroup e o método @datasourcelookup, conforme necessário.
5. Designe os filtros a usuários ou grupos.
6. Se você tiver atribuído o filtro a um grupo, atribua o grupo ao aplicativo a ser filtrado,
   • Na Interface Redwood, navegue até o aplicativo, escolha Personalização e depois escolha Permissões.
   • Na Interface Web Clássica, use a seção Filtros do inspetor de banco de dados.

O filtro dinâmico a seguir funciona com o cubo chamado Efficient.UserFilters, disponível na galeria como modelo de amostra.

Para aprender a criar e aplicar esse filtro dinâmico, faça download do modelo de pasta de trabalho, Efficient_Filters.xlsx, na seção Técnico da galeria, e siga as instruções do LEIA-ME na pasta de trabalho. A galeria está disponível na seção Arquivos da interface Web do Essbase.