> ## Documentation Index
> Fetch the complete documentation index at: https://agile-docs.3code.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Filtrar

> O sistema de filtragem do Agile é uma ferramenta poderosa que permite localizar dados de forma rápida e eficiente.

O Agile oferece um sistema de filtragem avançado que permite aos usuários localizar dados de forma rápida e eficiente. O botão de filtro está sempre visível ao lado do botão "**[Criar Novo](/general/create)**", facilitando o acesso imediato à ferramenta de busca personalizada, sem a necessidade de navegar para outra página.

<div>
  <img className="block dark:hidden rounded-lg" src="https://mintcdn.com/3code/Arxx7HuBTuymTmMK/public/images/organization/general/filter/filter-light.png?fit=max&auto=format&n=Arxx7HuBTuymTmMK&q=85&s=0f9c3f0bf801d9d76c4b29e2b8fbb334" width="372" height="117" data-path="public/images/organization/general/filter/filter-light.png" />

  <img className="hidden dark:block rounded-lg" src="https://mintcdn.com/3code/Arxx7HuBTuymTmMK/public/images/organization/general/filter/filter-dark.png?fit=max&auto=format&n=Arxx7HuBTuymTmMK&q=85&s=6baafeaba5c62bd1d098b1f08e0a45dd" width="372" height="117" data-path="public/images/organization/general/filter/filter-dark.png" />
</div>

***

## Formulário de filtro

Ao clicar no botão de filtro, o sistema exibe um conjunto de campos específicos para refinar os resultados apresentados na tela. Em dispositivos desktop, esses campos são exibidos em uma aba lateral que se abre na interface. Já em dispositivos móveis, um modal sobe a partir da parte inferior da tela, garantindo uma experiência otimizada para cada tipo de dispositivo. Essa abordagem torna a navegação mais intuitiva e produtiva, independentemente do tamanho da tela.

<Card>
  Desktop

  <div>
    <img className="block dark:hidden rounded-lg" src="https://mintcdn.com/3code/Arxx7HuBTuymTmMK/public/images/organization/general/filter/form-light.png?fit=max&auto=format&n=Arxx7HuBTuymTmMK&q=85&s=f17a908aa4112de62a12b540d449a169" width="1920" height="1080" data-path="public/images/organization/general/filter/form-light.png" />

    <img className="hidden dark:block rounded-lg" src="https://mintcdn.com/3code/Arxx7HuBTuymTmMK/public/images/organization/general/filter/form-dark.png?fit=max&auto=format&n=Arxx7HuBTuymTmMK&q=85&s=8420aa93c5e0360ad1f41eec50aa81ca" width="1920" height="1080" data-path="public/images/organization/general/filter/form-dark.png" />
  </div>

  Mobile

  <div>
    <img className="block dark:hidden rounded-lg" src="https://mintcdn.com/3code/Arxx7HuBTuymTmMK/public/images/organization/general/filter/form-mobile-light.png?fit=max&auto=format&n=Arxx7HuBTuymTmMK&q=85&s=224744504ee3a4dd25036e4e04e5fc8e" width="822" height="1080" data-path="public/images/organization/general/filter/form-mobile-light.png" />

    <img className="hidden dark:block rounded-lg" src="https://mintcdn.com/3code/Arxx7HuBTuymTmMK/public/images/organization/general/filter/form-mobile-dark.png?fit=max&auto=format&n=Arxx7HuBTuymTmMK&q=85&s=f047b42747f27b4dc0f3347eb1982895" width="822" height="1080" data-path="public/images/organization/general/filter/form-mobile-dark.png" />
  </div>

  <Info>
    Os campos de filtro são opcionais, permitindo que o usuário escolha quais
    critérios deseja aplicar para refinar os resultados. Isso proporciona
    flexibilidade e personalização na busca por informações específicas.
  </Info>
</Card>

***

## Filtro inicial

Em muitas telas que possuem o campo **Status**, o filtro já vem aplicado por padrão (por exemplo, **Ativo** ou **Todos**), para oferecer uma visão útil logo no primeiro acesso. Os campos disponíveis variam conforme a tela — cada listagem expõe apenas os filtros que fazem sentido para o seu conteúdo.

***

## Filtros salvos

O sistema permite que usuários com permissão adequada salvem suas configurações de filtro para uso futuro. Esta funcionalidade otimiza o tempo e aumenta a produtividade, evitando a necessidade de reconfigurar filtros utilizados com frequência.

### Salvando um filtro

Para salvar um filtro personalizado, o usuário deve:

1. **Configurar o filtro** utilizando os campos desejados no formulário de filtragem

2. **Clicar no botão "Salvar filtros"** (visível apenas para usuários com permissão)

<Card>
  <div>
    <img className="block dark:hidden rounded-lg" src="https://mintcdn.com/3code/dZxcJTQCqw-raVG-/public/images/organization/general/filter/filter-saved-form-light.png?fit=max&auto=format&n=dZxcJTQCqw-raVG-&q=85&s=e22b92f7da3e9abe429e0a497a1fb5da" width="1920" height="1080" data-path="public/images/organization/general/filter/filter-saved-form-light.png" />

    <img className="hidden dark:block rounded-lg" src="https://mintcdn.com/3code/dZxcJTQCqw-raVG-/public/images/organization/general/filter/filter-saved-form-dark.png?fit=max&auto=format&n=dZxcJTQCqw-raVG-&q=85&s=af3fbe5ee0e1a2fb3567757c3ee35aeb" width="1920" height="1080" data-path="public/images/organization/general/filter/filter-saved-form-dark.png" />
  </div>
</Card>

3. **Preencher as informações** no diálogo que será exibido:
   * **Nome do filtro**: Identificação única para fácil reconhecimento
   * **Visibilidade**: Escolher entre público ou privado
     * **Público**: Disponível para todos os usuários da organização
     * **Privado**: Acesso exclusivo do usuário que criou o filtro

<Card>
  <div>
    <img className="block dark:hidden rounded-lg" src="https://mintcdn.com/3code/dZxcJTQCqw-raVG-/public/images/organization/general/filter/filter-saved-name-light.png?fit=max&auto=format&n=dZxcJTQCqw-raVG-&q=85&s=95d369c9746274cb00253a7a1a3db7b5" width="1920" height="1080" data-path="public/images/organization/general/filter/filter-saved-name-light.png" />

    <img className="hidden dark:block rounded-lg" src="https://mintcdn.com/3code/dZxcJTQCqw-raVG-/public/images/organization/general/filter/filter-saved-name-dark.png?fit=max&auto=format&n=dZxcJTQCqw-raVG-&q=85&s=516d0b17b00663e07cb7ae15a556f17d" width="1920" height="1080" data-path="public/images/organization/general/filter/filter-saved-name-dark.png" />
  </div>

  <Info>
    A funcionalidade de salvar filtros está disponível apenas para usuários que possuem a permissão necessária no sistema. Além disso, a opção de tornar um filtro público também requer uma permissão específica. Caso não tenha acesso a essas opções, entre em contato com o administrador do sistema.
  </Info>
</Card>

### Utilizando filtros salvos

Para aplicar um filtro salvo anteriormente:

1. **Acessar o menu "Mais opções"** no grid de tickets
2. **Selecionar "Filtros salvos"** para visualizar a lista disponível
3. **Escolher o filtro desejado** para aplicação automática

<Card>
  <div>
    <img className="block dark:hidden rounded-lg" src="https://mintcdn.com/3code/dZxcJTQCqw-raVG-/public/images/organization/general/filter/filter-saved-grid-options-light.png?fit=max&auto=format&n=dZxcJTQCqw-raVG-&q=85&s=58df8a1e5cac25d21b65b06c1e6a3de4" width="1920" height="1080" data-path="public/images/organization/general/filter/filter-saved-grid-options-light.png" />

    <img className="hidden dark:block rounded-lg" src="https://mintcdn.com/3code/dZxcJTQCqw-raVG-/public/images/organization/general/filter/filter-saved-grid-options-dark.png?fit=max&auto=format&n=dZxcJTQCqw-raVG-&q=85&s=f6087a9614a389e247e60d8356c83d4f" width="1920" height="1080" data-path="public/images/organization/general/filter/filter-saved-grid-options-dark.png" />
  </div>

  <div>
    <img className="block dark:hidden rounded-lg" src="https://mintcdn.com/3code/dZxcJTQCqw-raVG-/public/images/organization/general/filter/filter-saved-overview-light.png?fit=max&auto=format&n=dZxcJTQCqw-raVG-&q=85&s=2f5a919973b6b71fc7671355b8693c38" width="1920" height="1080" data-path="public/images/organization/general/filter/filter-saved-overview-light.png" />

    <img className="hidden dark:block rounded-lg" src="https://mintcdn.com/3code/dZxcJTQCqw-raVG-/public/images/organization/general/filter/filter-saved-overview-dark.png?fit=max&auto=format&n=dZxcJTQCqw-raVG-&q=85&s=391fd2a34cb6f6a3284098c1c86dd365" width="1920" height="1080" data-path="public/images/organization/general/filter/filter-saved-overview-dark.png" />
  </div>
</Card>

Os filtros salvos aparecem de forma organizada, permitindo identificação rápida através dos nomes personalizados. O sistema aplica instantaneamente todos os critérios configurados, refrescando a visualização dos dados conforme as preferências selecionadas.
