> 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.6/client-desktop/criacao-e-edicao-de-dashboards/componente-cartao.md).

# Componente Cartão

### Exempl&#x6F;**:**

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

O componente *<mark style="color:blue;">Cartão</mark>* traz a possibilidade de sumarização de valores de forma simples e agrupados em divisões de Séries. Outra aplicação prática deste objeto, é a viabilidade de analisar variações de valores automaticamente, verificando um valor monitorado em relação a um valor alvo, e em paralelo podendo ser classificados.

As unidades de cada divisão do cartão podem assumir cores, conforme regras de formatação, que podem ser cores fixas ou assumir cores dinamicamente de acordo com valores atualizados provenientes do metadado deste objeto.

Para sua criação, na última tela do assistente do componente *<mark style="color:blue;">Cartão</mark>*, é necessário selecionar pelo menos um campo e arrastá-lo para a área *<mark style="color:blue;">Valores</mark>* e, se desejado, poderá ser adicionado um ou mais campos para a área *<mark style="color:blue;">Séries</mark>*, dividindo o valor em diversos cartões.

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

A listagem à esquerda da tela são os *<mark style="color:blue;">Campos</mark>* *<mark style="color:blue;">disponíveis</mark>*, conforme disponibilizados pelo metadado informado na confecção do componente em fases anteriores. Caso algum campo estiver faltando ou ainda não existir edite o seu metadado, ou crie um campo calculado.

Para os campos em *<mark style="color:blue;">Séries</mark>* é possível alterar sua formatação. Essa opção é uma funcionalidade genérica e possui mais informações no tópico <mark style="color:blue;">**Componentes -**</mark> <mark style="color:blue;">**Opções Gerais**</mark> deste mesmo documento.

Já para *<mark style="color:blue;">Valores</mark>*, para análise de um valor simples basta arrastar um campo na área valores, e onde então será possível alterar o título, a função de agregação (Soma, Média, Contagem, Máximo, Mínimo) e sua formatação.

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

Caso 2 valores sejam referenciados em conjunto nesta área valores, o primeiro valor será um valor monitorado e comparado ao segundo valor citado. Ao utilizar esta técnica, podemos aplicar o cálculo automático de variação, que será visto em algumas das próximas telas de configuração deste objeto.

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

### Exemplo de resultado prático:

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

Em seu modo de edição permite realizar alterações no seu *layout* incluindo a *<mark style="color:blue;">Formatação</mark>* *<mark style="color:blue;">Condicional</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">e</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Personalizações</mark>*. Para configurar uma escala de cores para os cartões, por exemplo, basta entrar na opção *<mark style="color:blue;">Menu</mark>* *<mark style="color:blue;">Lateral</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">>></mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Cartão</mark>* *<mark style="color:blue;">(Padrão)</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">>></mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Cor de fundo</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">>></mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Modo</mark>* <mark style="color:blue;"></mark><mark style="color:blue;">e selecionar a opção</mark> <mark style="color:blue;"></mark>*<mark style="color:blue;">Escala</mark>*:

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

Nessa opção será possível utilizar os padrões de escala vindos de fábrica e modificá-los conforme necessidade ou ainda criar a sua própria escala selecionando qual a *<mark style="color:blue;">Variável</mark>* que está sendo utilizada.

Outra opção importante são as configurações das *<mark style="color:blue;">Linhas</mark>*, em qual as cores, textos e ícones que aparecem como conteúdo são selecionados e formatados de acordo com a necessidade.

O cartão possui três linhas, duas menores nas áreas *<mark style="color:blue;">Inferior</mark>* e *<mark style="color:blue;">Superior</mark>* do cartão e uma mais destacada denominada *<mark style="color:blue;">Intermediária</mark>*.

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

Na imagem acima é possível visualizar um exemplo da formatação da *<mark style="color:blue;">Linha</mark>* *<mark style="color:blue;">inferior</mark>* do cartão. Dentre as opções disponíveis, destaca-se o campo *<mark style="color:blue;">Texto</mark>* para configuração das variáveis que serão dispostas na linha e o *Ícone* que trará um símbolo de acordo com a variação calculada.

Em *<mark style="color:blue;">Menu</mark>* *<mark style="color:blue;">Lateral</mark>* >> *<mark style="color:blue;">Aparência</mark>* >> *<mark style="color:blue;">Geral</mark>* >> *<mark style="color:blue;">Colunas</mark>* é possível selecionar quantas colunas de cartões será apresentado. Caso o número de colunas informado seja zero, o componente se autodistribuirá conforme espaçamento em tela. Não há limite para o número de colunas, logo deverá ser configurado da forma que melhor atender as necessidades do indicador, exemplos:

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

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

![](/files/y0Me0EBv4j4sJLWONQkm)

A partir da versão 2.5, o Weknow conta com opções de tratamento de quebra de texto conforme necessidade do contexto. Esta opção também se encontra a disposição dentre as opções em:\
*<mark style="color:blue;">Menu</mark>* *<mark style="color:blue;">Lateral</mark>* >> *<mark style="color:blue;">Aparência</mark>* >> *<mark style="color:blue;">Geral</mark>* >> *<mark style="color:blue;">Colunas</mark>*.

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

Ao encerrar as configurações necessárias, clique em <mark style="color:blue;">**CONCLUIR**</mark>.
