GetUserAttr – função de script e gráfico

Este exemplo define um conjunto de variáveis de script que podem ser usadas no conteúdo do aplicativo que você cria. Cada vez que o aplicativo é recarregado, os atributos são avaliados e adicionados a ele.

Faça o seguinte:

1. Crie um novo aplicativo Qlik Sense.

2. Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção. O script de carregamento contém:

   • Uma nova tabela, chamada Transactions, com dados de transação de amostra. Isso pode ser substituído por qualquer dado e é apenas adicionado como um espaço reservado.

   • Uma instrução de script que define a variável de sistema QlikCloudGroupMode como 2. O atributo userGroups retornará os grupos de IdP e personalizados aos quais o usuário pertence.

   • Uma série de definições de variáveis de script para os atributos disponíveis que a função GetUserAttr pode retornar.

   Set QlikCloudGroupMode = 2;
   Transactions:
   Load * inline [
   id,date,amount
   1,1/1/2023,500.67
   2,1/2/2023,458.91
   3,1/3/2023,12.34
   4,1/4/2023,90.90
   5,1/5/2023,256.30
   6,1/6/2023,789.16
   7,1/7/2023,501.25
   8,1/8/2023,87.01
   9,1/9/2023,161.16
   10,1/10/2023,300.06
   ];
   Let vUserEmail = GetUserAttr('userEmail');
   Let vUserSubject = GetUserAttr('userSubject');
   Let vUserGroups = GetUserAttr('userGroups');
   Let vUserLocale = GetUserAttr('userLocale');
   Let vUserZoneinfo = GetUserAttr('userZoneinfo');

3. Carregue os dados e abra uma nova pasta no modo de edição avançada.

4. Crie um objeto de Tabela e adicione as seguintes expressões como dimensões:

• =vUserEmail

• =vUserSubject

• =vUserGroups, isso retorna uma lista separada por vírgulas em uma string

• =vUserLocale

• =vUserZoneinfo

A saída na tabela exibe dinamicamente os atributos de usuário disponíveis. A tabela a seguir mostra um exemplo de resultados retornados usando a função GetUserAttr.

Neste exemplo, em vez de definir variáveis no script de carregamento, as variáveis são definidas no aplicativo. Uma vez definidas, as variáveis podem ser usadas em expressões de gráfico no aplicativo. O principal benefício de usar a função em expressões de gráfico é que os atributos serão atualizados automaticamente sem precisar recarregar o aplicativo. Isso permite uma movimentação mais suave de aplicativos entre usuários como parte do ciclo de vida do aplicativo.

Faça o seguinte:

1. Crie um novo aplicativo Qlik Sense.

2. Abra uma nova pasta no modo de edição avançada.

3. Abra o diálogo de variáveis.

4. Selecione Criar novo e, em seguida, faça o seguinte:

   • Em Nome, digite vUserEmail.

   • Em Definição, digite =GetUserAttr('userEmail').

   • Selecione Criar.

Uma variável de aplicativo é criada para exibir o endereço de e-mail do usuário. Repita essa etapa para criar uma variável para os atributos restantes usando os parâmetros a seguir:

• Assunto do usuário

  • Nome: vUserSubject

  • Definição: =GetUserAttr('userSubject')

• Grupos de usuários

  • Nome: vUserGroups

  • Definição: =GetUserAttr('userGroups')

• Localidade do usuário

  • Nome: vUserLocale

  • Definição: =GetUserAttr('userLocale')

• Usuário Zoneinfo

  • Nome: vUserZoneinfo

  • Definição: =GetUserAttr('userZoneinfo')

5. Crie um objeto de Tabela e adicione as seguintes expressões como dimensões:

• =vUserEmail

• =vUserSubject

• =vUserGroups (retorna uma lista separada por vírgulas em uma string)

• =vUserLocale

• =vUserZoneinfo

A saída na nova tabela exibe dinamicamente os atributos de usuário disponíveis. A tabela a seguir mostra um exemplo de resultados retornados da função GetUserAttr.

Você também pode usar a função em seus aplicativos sem uma variável. Esse exemplo demonstra como carregar uma tabela com cada atributo como um campo individual. A partir daqui, você pode criar visualizações no aplicativo para exibir esses detalhes.

Faça o seguinte:

1. Crie um novo aplicativo Qlik Sense.

2. Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção. O script de carregamento contém:

   • Uma nova tabela, chamada Attributes, que contém cada atributo como campo.

   • Uma instrução de script que define a variável de sistema QlikCloudGroupMode como 1 para grupos personalizados. O atributo userGroups retornará apenas os grupos personalizados aos quais o usuário pertence.

   Set QlikCloudGroupMode = 1;
   Attributes:
   Load RowNo() as Key,
   GetUserAttr('userEmail') as UserEmail,
   GetUserAttr('userSubject') as UserSubject,
   GetUserAttr('userLocale') as UserLocale,
   GetUserAttr('userZoneinfo') as UserZoneinfo,
   GetUserAttr('userGroups') as UserGroups autogenerate 1;
   

3. Carregue os dados. Uma tabela é criada no modelo de dados que exibe cada um dos atributos em campos individuais.

Agora você pode usar os campos de atributos em visualizações, como tabelas ou objetos de texto e imagem.

Você pode inserir a função diretamente nas expressões do gráfico sem usar uma variável. Os atributos do usuário serão atualizados sem a necessidade de recarregar o aplicativo. Isso permite uma movimentação mais suave dos aplicativos entre os usuários como parte do ciclo de vida do aplicativo.

Faça o seguinte:

1. Crie um novo aplicativo Qlik Sense.

2. Abra uma nova pasta no modo de edição avançada.

3. Arraste um objeto de texto e imagem até a pasta.

4. Clique dentro do gráfico em branco e digite o seguinte rótulo:

   E-mail do usuário:

5. No painel de propriedades, selecione Adicionar medida.

6. Insira a seguinte expressão:

   • =GetUserAttr('userEmail')

7. Adicione rótulos e medidas para os outros atributos em novas linhas. Use as expressões a seguir para cada atributo:

   • =GetUserAttr('userSubject'), para assunto do usuário

   • =GetUserAttr('userGroups') para grupos de usuários

   • =GetUserAttr('userLocale'), para a localidade do usuário

   • =GetUserAttr('userZoneinfo'), para informações da zona do usuário​