Uma consulta personalizada no Master Data é um filtro ou combinação de filtros que pode ser salva e acessada diretamente na listagem de registros de um formulário.

Antes de criar uma consulta, você precisa seguir os passos descritos em Filtrar dados no Master Data para configurar um filtro na entidade de dados e no formulário.

Siga o passo a passo abaixo para filtrar os registros de um formulário e salvar uma consulta personalizada.

1. No Admin VTEX, acesse Configurações da loja > Storefront > Master Data.

2. Certifique-se de que você está na aba Aplicações.

3. Na aplicação desejada, identifique o formulário que deseja visualizar e clique no ícone de listagem .

   Você será direcionado(a) para a listagem de registros desse formulário. Na lateral, você verá os filtros configurados.

4. Para filtrar, selecione o nome do filtro e seu valor e, em seguida, clique em Filtrar.

   É possível filtrar por vários campos ao mesmo tempo e vários valores no mesmo campo. Para retirar um filtro, clique no X ao lado do valor.

5. Clique no botão Salvar consulta.

6. Nomeie a consulta personalizada.

7. Clique em OK.

8. Clique em OK novamente.

9. Clique na aba Aplicações.

10. Clique no botão Recarregar aplicações.

Após seguir as instruções acima, a consulta vai aparecer como uma opção de visualização na listagem do formulário.

Você também pode acessar as consultas salvas clicando no botão Consultas, na listagem do formulário:

Para determinar que um formulário sempre abra a listagem com uma consulta personalizada em vez de exibir todos os registros, você pode configurar uma consulta padrão. Para isso, siga o passo a passo:

1. No Admin VTEX, acesse Configurações da loja > Storefront > Master Data.
2. Certifique-se de que você está na aba Aplicações.
3. Na aplicação em que deseja alterar o formulário, clique no símbolo de engrenagem .
4. Clique no ícone de edição na linha do formulário em que deseja adicionar a consulta padrão.
5. Na opção Consulta padrão, selecione a consulta personalizada que deseja exibir sempre que abrir a lista de registros do formulário.
6. Clique no botão Salvar.