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

# Seletor de dimensão

> Passo a passo para criar um "Ver por" que troca o agrupamento de um card.

O seletor de dimensão deixa quem usa o painel escolher **por onde** o card agrupa. Um ranking de tempo de espera pode ser visto por convênio, por profissional ou por origem, no mesmo card.

<Note>
  Os nomes de indicador e de coluna desta página são fictícios.
</Note>

## Passo a passo

<Steps>
  <Step title="Crie o seletor">
    No modo de edição, use **+ Filtro** ou **⋯ › Adicionar filtro a este card**, como no [seletor de métrica](/paineis/parametros/seletor-de-metrica). Clique no seletor para abrir a barra lateral.
  </Step>

  <Step title="Escolha o tipo e as opções">
    Em **Tipo**, escolha **Seletor de dimensão (1)**. Em **Rótulo**, escreva algo como `Ver por`. Em **Opções**, escreva um nome por forma de ver: `Convênio`, `Profissional`.
  </Step>

  <Step title="Ligue cada opção a uma coluna">
    Em **Cards desta aba**, escolha para cada opção a coluna por onde o card agrupa (2).

    <Frame caption="(1) O tipo. (2) A coluna de agrupamento de cada opção. À direita, o card agrupado por convênio.">
      <img src="https://mintcdn.com/medemerge/vDDm7AxscFVgd1kE/images/parametros/barra-dimensao.png?fit=max&auto=format&n=vDDm7AxscFVgd1kE&q=85&s=b4dde7bdf52a21755899dedfcf199d5a" alt="Barra lateral com o Seletor de dimensão e, ao lado, um card de barras horizontais agrupado por convênio" width="1642" height="1160" data-path="images/parametros/barra-dimensao.png" />
    </Frame>

    A lista mostra só as colunas que o indicador do card oferece para agrupar.
  </Step>

  <Step title="Mostre a opção no título e salve">
    Use o código do seletor no título, como `Tempo de espera por {filtro_2}`. Clique em **Salvar**.
  </Step>
</Steps>

## O que o indicador precisa ter

Trocar o agrupamento muda a consulta do card. Por isso, o seletor de dimensão funciona só com indicadores do **construtor visual** que **agrupam** por alguma coluna no último passo.

Com um indicador em SQL, ou que não agrupa, o card aparece em **Cards desta aba** com o aviso **Este card não oferece dimensões para trocar**.

<Note>
  Por enquanto, as opções de dimensão são colunas de categoria, como convênio e profissional. Agrupamentos por tempo (mês, dia da semana) ainda não entram como opção. Para eles, use um indicador próprio para cada agrupamento, como em [Um seletor, vários cards](/paineis/parametros/um-seletor-varios-cards).
</Note>

## Os filtros do painel continuam valendo

Os filtros de convênio, período e origem continuam cortando os dados com qualquer dimensão escolhida.

A exceção é o filtro **Agrupar por tempo** ligado ao agrupamento que a dimensão substituiu: com outra dimensão na tela, ele não tem onde agir. O card avisa, em vez de mostrar um número sem o filtro.

## Métrica e dimensão juntas

Um card pode ouvir um seletor de métrica **e** um de dimensão ao mesmo tempo. Quem usa escolhe "Tempo de atendimento" e "Ver por: Profissional", e o card mostra os dois.

Se a opção de métrica roda **outro indicador**, a coluna da dimensão precisa existir também nesse indicador. Sem ela, o card mostra um erro que diz qual opção e qual indicador não combinam.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.