{"section":"tutorials","requestedLocale":"pt","requestedSlug":"filtrando-dados-no-master-data","locale":"pt","slug":"filtrando-dados-no-master-data","path":"docs/pt/tutorials/master-data/configurações-do-master-data-v1/filtrando-dados-no-master-data.md","branch":"main","content":"No Master Data, é possível criar filtros tanto para acesso por API quanto para a visualização nos formulários. A criação de filtros facilita a busca e consulta de dados, possibilitando um maior controle sobre seus dados.\n\nA criação de filtro deve ser configurada primeiro na entidade de dados e posteriormente no formulário desejado, conforme os passos descritos nas seções a seguir.\n\n## Requisitos para filtros\n\nSiga as recomendações abaixo ao definir campos como filtros:\n\n- Não utilize campos dos tipos **CEP**, **Text** e **File** como filtros.\n- Adicione como filtro um campo que contenha poucas opções em seu preenchimento, como \"Categoria\", por exemplo.\n\n## Configurar filtro na entidade de dados\n\nSiga as instruções abaixo para definir um campo existente como filtro na entidade de dados:\n\n1. No Admin VTEX, acesse **Configurações da loja** > **Storefront** > **Master Data**.\n2. No Master Data, clique na engrenagem <i class=\"fas fa-cog\"></i> ao lado de uma aplicação.\n3. Clique em **Estrutura de dados**.\n4. Acesse a aba **Entidades de dados.**\n5. Clique no botão de edição <i class=\"fas fa-edit\"></i> na entidade em que deseja configurar o filtro.\n\n   Você será direcionado(a) para a listagem de campos da entidade.\n6. Clique no botão com símbolo de engrenagem <i class=\"fas fa-cog\"></i> no campo que deseja configurar como filtro.\n7. Marque a opção **É filtrável?**.\n8. Clique no botão `Salvar`.\n9. Na listagem de entidades, clique no botão de disquete <i class=\"fas fa-save\"></i> para publicar a entidade.\n10. Clique no botão de reindexação <i class=\"fas fa-expand-arrows-alt\"></i> para indexar a entidade.\n\n## Configurar filtro no formulário\n\nSiga as instruções abaixo para configurar filtros no formulário:\n\n1. No Admin VTEX, acesse **Configurações da loja** > **Storefront** > **Master Data**.\n2. Na aplicação em que está o formulário onde deseja criar o filtro, clique no símbolo de engrenagem <i class=\"fas fa-cog\"></i>.\n\n   Você será direcionado(a) para a listagem de formulários da aplicação.\n3. Clique no botão de edição <i class=\"fas fa-edit\"></i> na linha do formulário que deseja editar.\n4. Preencha o campo **Filtros** com o nome interno do campo marcado como filtro. O nome interno corresponde ao valor do primeiro campo na criação e edição de entidade de dados, o nome do campo que não é possível alterar. Para inserir mais de um valor, separe-os por vírgula, sem espaço.\n5. Clique no botão `Salvar`.\n\n## Filtrar registros do formulário\n\nApós a criação do filtro, é possível utilizá-lo no formulário. Para isso, siga o passo a passo abaixo:\n\n1. No Admin VTEX, acesse **Configurações da loja** > **Storefront** > **Master Data**.\n2. Na aplicação desejada, identifique o formulário que deseja visualizar e clique no ícone de listagem <i class=\"fas fa-bars\"></i>.\n\n   Você será direcionado(a) para a listagem de registros desse formulário. Na lateral, você verá os filtros configurados. \n3. Para filtrar, selecione o nome do filtro e seu valor e, em seguida, clique em `Filtrar`.\n\n   É 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."}