Configuração do Widget
Visão Geral
Os widgets permitem exibir qualquer dado necessário dentro do seu dashboard. A biblioteca de widgets oferece múltiplos tipos de widgets, cada um com seu próprio comportamento e opções de configuração.
A configuração de um widget envolve três seções principais: Query, Display e Layout.
Dentro de um dashboard, clique em add widget para seguir cada uma das seções abaixo.
Secção 1: Query
Na seção Query, você define como o widget irá buscar os dados. Selecione o recurso desejado, crie uma query e configure-a de acordo com suas necessidades.
É possível criar múltiplas queries — elas serão listadas como A, B, C, e assim por diante.
No exemplo abaixo, informações de temperatura são consultadas para serem exibidas em um widget do tipo Tile:
Uma query retorna uma lista de itens. Após configurá-la, você pode clicar no botão play para executá-la e verificar quais dados estão sendo retornados:
Após a query estar configurada corretamente e os dados retornados estarem corretos, você pode prosseguir para a seção Display.
Secção 2: Display
A seção Display define quais dados da query o widget utilizará para renderização.
A configuração principal aqui é definir o path para a informação que será exibida.
- Escolha uma query.
- Defina a expressão de path.
- Extraia os dados utilizando JSONPath RFC 9535 (Query Expressions for JSON).
Widgets de valor único esperam exatamente um valor.
Se o path retornar uma lista com múltiplos valores, apenas o último item será exibido.
Secção 3: Layout
A seção Layout define as configurações estruturais do widget, como header, body e footer.
Aqui você pode atualizar o título, ajustar cores e customizar diversos aspectos visuais.
