InObject - função de gráfico
A função de gráfico InObject() avalia se o objeto atual está ou não contido em outro objeto com o ID especificado no argumento da função. O objeto pode ser uma pasta ou uma visualização.
Essa função pode ser usada para mostrar a hierarquia de objetos em uma pasta, desde o objeto de pasta de nível superior até visualizações aninhadas em outras visualizações. Essa função pode ser usada junto com as funções if e ObjectId para criar navegação personalizada em seus aplicativos.
Sintaxe:
InObject(id_str)
Tipo de dados de retorno: Booleano
No Qlik Sense, o valor booleano “true” é representado por -1, e o valor falso é representado por 0.
| Argumento | Descrição |
|---|---|
| id_str | Um valor de string representando a ID do objeto que está sendo avaliado. |
O ID da pasta pode ser obtido no URL do aplicativo. Para visualizações, use as opções de Desenvolvedor para identificar o ID do objeto e a string de texto do tipo de objeto.
Faça o seguinte:
-
No modo de análise, adicione o seguinte texto à sua URL:
/options/developer
-
Clique com o botão direito do mouse em uma visualização e clique em
Desenvolvedor. -
Em Propriedades, obtenha o ID do objeto no cabeçalho do diálogo e o tipo de objeto na propriedade "qType".
Limitações:
Essa função pode gerar resultados inesperados quando invocada em um objeto (por exemplo, um botão) dentro de um contêiner que é um item mestre. Essa limitação também se aplica aos itens mestres do painel de filtro, que são contêineres para várias caixas de listagem. Isso se deve à forma como os itens mestres usam a hierarquia de objetos.
InObject() é frequentemente usado em combinação com as seguintes funções:
| Função | Interação |
|---|---|
| if – função de script e gráfico | As funções if e ObjectId podem ser usadas juntas para criar expressões condicionais. Por exemplo, visualizações podem obter cores condicionais por meio de expressões usando essas funções. |
| ObjectId - função de gráfico | Semelhante a if, ObjectID também é usado com InObject para criar expressões condicionais. |
Exemplo 1 – Funcionalidade básica
O exemplo básico a seguir demonstra como determinar se um objeto está contido em outro objeto. Nesse caso, verificaremos se um objeto de Texto e imagem reside em um objeto de pasta usando o ID da pasta como argumento.
Faça o seguinte:
-
Abra uma nova pasta e arraste um gráfico de Texto e imagem até a pasta.
-
No painel de propriedades, clique em Adicionar medida.
-
Clique em
para abrir o editor de expressão. -
Cole a seguinte expressão no diálogo:
=InObject() -
Modifique a expressão para incluir o ID da sua pasta como uma string entre parênteses.
Por exemplo, para uma pasta com ID 1234-5678, você usaria o seguinte:
-
=InObject('1234-5678')
-
Clique em Aplicar.
O valor -1 é exibido no gráfico, indicando que a expressão foi avaliada como true.
Exemplo 2 – Objetos com cores condicionais
Visão geral
O exemplo a seguir demonstra como criar botões de navegação personalizados mostrando cores diferentes para indicar a pasta que está aberta no momento.
Comece criando um novo aplicativo e abrindo o Editor de carregamento de dados. Cole o script de carregamento a seguir em uma nova guia. Observe que os dados em si são um espaço reservado e não serão usados no conteúdo do exemplo.
Script de carregamento
Transactions:
Load
*
Inline
[
id,date,amount
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'4/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'7/26/2022',45.89
8198,'8/9/2022',36.23
8199,'9/22/2022',25.66
8200,'11/23/2022',82.77
8201,'12/27/2022',69.98
8202,'1/1/2023',76.11
8203,'2/8/2022',25.12
8204,'3/19/2022',46.23
8205,'6/26/2022',84.21
8206,'9/14/2022',96.24
8207,'11/29/2022',67.67
]; Criando as visualizações
Carregue os dados e crie duas novas pastas. Chame-os de Sales 2022 e Sales 2023, respectivamente.
Em seguida, crie dois objetos de botão que serão usados para navegar entre as duas pastas.
Faça o seguinte:
-
Adicione dois objetos Botão à pasta.
-
Em Aparência > Geral, defina o Rótulo de cada botão como Sales 2022 e Sales 2023, respectivamente.
- Organize os botões para combinar com a imagem a seguir.
Arranjo da pasta Sales 2022 com dois botões de navegação
-
Selecione o botão Sales 2022 e expanda Ações e navegação no painel de propriedades.
-
Clique em Adicionar ação e, em Navegação, selecione Ir para uma pasta.
-
Em Pasta, selecione Sales 2022.
-
Repita a configuração da ação desse botão para vincular o botão Sales 2023 à pasta Sales 2023.
-
Converta os botões em itens mestres clicando com o botão direito do mouse neles e selecionando
Adicionar a itens mestres.
Agora, você pode copiar cada botão e colá-lo na pasta Sales 2023, usando o mesmo tamanho e disposição na pasta.
Criando cores condicionais
Em seguida, configure os botões para que fiquem azuis se estiverem vinculados à pasta aberta no momento e para que fiquem cinza claro se estiverem vinculados à pasta que não está aberta.
Faça o seguinte:
-
Abra a pasta Sales 2022 e obtenha o ID dessa pasta no URL. Mantenha a pasta Sales 2022 aberta.
-
Clique no item mestre do botão Sales 2022 e selecione Editar no painel de propriedades.
-
Em Aparência > Plano de fundo, selecione para colorir o botão Por expressão.
-
Em Expressão, cole o seguinte texto:
=if(InObject(''), Blue(), LightGray())
-
Entre parênteses na expressão acima, cole o ID da pasta Sales 2022.
O botão agora está configurado para ficar azul quando a pasta Sales 2022 estiver aberta e para ficar cinza claro quando não estiver aberta.
Repita as instruções acima para a pasta Sales 2023, vinculando o item mestre do botão Sales 2023 ao ID da pasta Sales 2023.
Cada folha agora deve ter dois botões indicando a pasta aberta no momento com a cor azul.
Pasta Sales 2022 com coloração azul para indicar que Sales 2022 está sendo exibido atualmente
