# GRÁFICO DE SETORES
O widget Gráfico de Setores exibe gráficos circulares. Ele suporta dicas de ferramentas ou a capacidade de destacar segmentos individuais, permitindo uma análise detalhada dos dados.
## Início da configuração do widget
Para configurar o widget, clique no ícone de edição .
Uma janela pop-up “Configurações do widget” será aberta:
Preencha os campos necessários para configurar o widget.
## **Campos Gerais**
* **“Nome do widget \*”** – campo de texto, preenchido manualmente com o teclado;
* **“Modo”** – lista suspensa, onde você deve escolher o modo de criação de consulta para o widget:
| **Nome** | **Descrição** |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Modo Construtor](#rezhim-konstruktora) | Permite montar uma consulta a partir de blocos separados. Em cada bloco (União de tabelas, Filtros, Séries do widget, Agrupamento por, Ordenação, Número de linhas) há a possibilidade de configurar os comandos necessários para trabalhar com os dados, comandos aritméticos e lógicos, operadores de comparação. |
| [Modo Avançado](#rasshirennyi-rezhim) |
Permite inserir uma consulta manualmente no campo SQL:
|
* **“Tabelas”** – lista suspensa com todas as tabelas disponíveis no banco de dados.
## **Campos adicionais disponíveis para configuração apenas no Modo Construtor**
### **União de Tabelas**
A união de tabelas é necessária para extrair dados de várias tabelas relacionadas e formar resultados mais completos e informativos.
Para comparar duas tabelas, para posterior união, são utilizados os seguintes operadores:
| **Nome** | **Descrição** |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| = | Retorna linhas de duas tabelas onde os valores nas colunas especificadas são iguais. |
| != | Retorna linhas de duas tabelas onde os valores nas colunas especificadas não são iguais. |
| > | Retorna linhas onde o valor na coluna especificada da primeira tabela é maior que o valor na coluna especificada da segunda tabela. |
| < | Retorna linhas onde o valor na coluna especificada da primeira tabela é menor que o valor na coluna especificada da segunda tabela. |
Se for necessário unir apenas 2 tabelas, é preciso preencher os campos:
1. **“Coluna”** da lista suspensa;
2. **“Operador”** da lista suspensa;
3. **“Coluna 2”** da lista suspensa;
Por exemplo,
Se for necessário unir mais de duas tabelas, deve-se clicar no botão , após o que preencher os campos necessários.
Se for necessário remover a união de tabelas, deve-se clicar no botão .
### **Filtros**
Os filtros permitem definir condições para os dados selecionados usando operadores de comparação e operadores lógicos.
Para definir uma condição, é necessário preencher os campos:
1. **“Coluna”** da lista suspensa;
2. **“Operador”** da lista suspensa;
3. **“Valor”** manualmente com o teclado;
Por exemplo,
Se for necessário combinar várias condições em uma só, por exemplo, ((robots.is\_deleted = 0) AND (robots.id > 13)), deve-se usar operadores lógicos. Para isso, escolha o operador desejado, clicando no ícone , para mudar para OR, ou , para mudar para AND. Em seguida, clique no botão , após o que preencher os campos necessários:
Se for necessário definir uma condição complexa para o Filtro, incluindo várias parênteses, deve-se clicar no botão , após o que preencher os campos necessários.
Se for necessário remover uma condição, deve-se clicar no botão .
### **Séries do Widget**
As séries do widget são usadas para indicar as colunas de dados que precisam ser extraídas do banco de dados. Elas definem quais dados serão retornados nos resultados da consulta.
Para configurar as Séries do widget, é necessário preencher os campos:
1. **“Coluna”** da lista suspensa;
2. **“Operador”** da lista suspensa;
3. **“Nome da série”** manualmente com o teclado;
Por exemplo,
Se for necessário exibir dados adicionais na legenda, pressione o botão .
### **Agrupamento por**
Campo para configurar o processo de combinação de linhas de dados com valores iguais em uma determinada coluna (ou colunas) em um único conjunto, permitindo a execução de operações agregadas sobre esses grupos. Para combinar linhas de dados, é necessário preencher o campo coluna a partir da lista suspensa;
### **Ordenação**
Campos para configurar o processo de ordenação dos dados no conjunto resultante em uma determinada ordem, dependendo dos valores em uma ou mais colunas. Para ordenação crescente, é necessário inserir no campo “Ordenar por” o valor “ASC”. Para ordenação decrescente, o valor “DESC”. Em seguida, é necessário preencher o campo “Coluna” a partir da lista suspensa;
### **Número de linhas**
Campo preenchido manualmente com o teclado ou com a ajuda do contador . Este campo permite limitar o número de registros retornados na consulta para a construção do Dashboard.
## Teste
Para garantir que a consulta está configurada corretamente, é necessário pressionar o botão , após o que aparecerá uma tabela com os dados que serão usados para construir o Dashboard Pie Chart.
Para exibir o Dashboard no painel, pressione o botão “OK”.
Para remover todos os dados preenchidos, pressione o botão “Cancelar”.
Exemplo:
Para exibir os status dos Robôs no Dashboard Pie Chart, é necessário inserir nos campos correspondentes na janela "Configurações do widget" os dados:
## Modo construtor (exemplo)
É necessário preencher os campos:
**Tabelas \***
*robots*
*robot\_statuses*
**União de tabelas**
| **Coluna** | **Operador** | **Coluna 2** |
| --------------- | ------------ | ---------------------- |
| *robots.status* | *=* | *robot\_statuses.code* |
**Filtros**
Coluna
robots.is_deleted
=
0
**Linhas do widget**
Coluna
Nome da linha
robots.status
COUNT
robot_statuses.description
**Agrupamento por**
*robots.status*
**Número de linhas**
*1000*
## Modo avançado (exemplo)
É necessário preencher o campo:
**SQL**
```sql
SELECT
count(robots.status) AS count,
robot_statuses.description AS name
FROM
robots LEFT JOIN robot_statuses
ON robots.status=robot_statuses.code
WHERE
robots.is_deleted=0
GROUP BY
robots.status
LIMIT 1000
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-orchestrator/rabota-v-sherpa-orchestrator/ekrany/obzor/pie-chart.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
.png?alt=media)
