Criar consulta personalizada no Master Data v1

2 min de leitura

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.

Pré-requisitos

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.

Salvar uma consulta

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

No Admin VTEX, acesse Configurações da loja > Storefront > Master Data.
Certifique-se de que você está na aba Aplicações.
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.
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.
Clique no botão Salvar consulta.
Nomeie a consulta personalizada.
Clique em OK.
Clique em OK novamente.
Clique na aba Aplicações.
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.

${"base64":" ","img":{"width":537,"height":151,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":18497,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/master-data/aplica%C3%A7%C3%B5es-no-master-data-v1/criar-consulta-personalizada-no-master-data-v1_1.png"}}$

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

${"base64":" ","img":{"width":705,"height":220,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":29827,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/master-data/aplica%C3%A7%C3%B5es-no-master-data-v1/criar-consulta-personalizada-no-master-data-v1_2.png"}}$

Configurar uma consulta padrão

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:

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