> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.1/wedocs-4.1/client-desktop/criacao-e-edicao-de-dashboards/filtro/filtro-de-selecao-unica.md).

# Filtro de Seleção Única

### Exemplo:

<div align="left"><img src="/files/LsO6j5cErKc1a4TTBDDg" alt=""></div>

<div align="left"><img src="/files/FicZ1TQd8BQOBbxxV1Lw" alt=""></div>

Exemplo de uso de filtros de seleção única, com lista de valores a serem considerados no vínculo, seguidos de descrição a ser exibida entre as opções a serem escolhidas no contêiner de filtros:

<div align="left"><img src="/files/l8e1pL1rqpOZG9DqaSdq" alt=""></div>

<div align="left"><img src="/files/G6Ufdg8R17j8D2ylq3Jw" alt=""></div>

Exibição deste exemplo ao visualizar o filtro inicialmente:

<div align="left"><img src="/files/bpCV8kIeFDTN2jSvLuXf" alt=""></div>

## *Filtro Seleção Múltipla*

<div align="left"><img src="/files/4SXEJQseC7Tx79HbDdBA" alt=""></div>

<div align="left"><img src="/files/iaivyna20A9d5D8DmtYP" alt=""></div>

## *Filtro Pesquisa*

<div align="left"><img src="/files/YCsXrL7OizwzpRAaWcVd" alt=""></div>

Para este tipo de Filtro, é necessário informar um campo chave de pesquisa (quando informado por SQL deve ser referenciado por *<mark style="color:blue;">cKey</mark>*), e um campo de Descrição para utilização na pesquisa/localizador, e que quando por SQL deve ser referenciado por *<mark style="color:blue;">cValue</mark>*).

#### *Exemplo*:

*Select cd\_estabelecimento cKey,*

*upper(cd\_estabelecimento||' - '||nm\_fantasia\_estab) cValue*

*From estabelecimento*

<div align="left"><img src="/files/LxTW4oyE8U6wzZmxB5pF" alt=""></div>

Após validado o SQL, o botão OK do executor rápido de SQL é habilitado, e então possível concluir a edição do Filtro. Em seu resultado visual, digite trecho a ser pesquisado, e automaticamente as opções relacionadas a pesquisa serão exibidas:

<div align="left"><img src="/files/DPxnOc2MsXNC0I98h0js" alt=""></div>
