# Checkbox Group

Para configurar o widget, é necessário realizar as seguintes ações:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdJt6PjvC9_dWf5J8e2DedqXvgel6F42Uq6TYM6SqWhsYh6Vuffib0JppC5f7P9v8Zo60IGhZVd6UyejJQ3hW4UdT4tda_Hp5vUv6hoxOgu5aBapzriGEdepr8Zsbm3EnG4zB66fA?key=-T9NX3CGBv1M5bfMJgGn1DiB" alt=""><figcaption></figcaption></figure>

O widget Checkbox Group exibe um campo para criar um grupo de checkboxes, permitindo que os Usuários escolham várias opções entre as apresentadas. Cada checkbox pode ser ativado ou desativado independentemente dos outros.

Para configurar o elemento, clique no ícone de edição ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfZuvqSj03YYpiFrGLGQqAKZhSbhlR6emrvSC_F0_lEfOhjR6BRS5ZKiCGpi0NmROzWW8gpNTE3jP5xV9pSiPKpVKjWYMJi-Udh6V_EiqwSVHg0IztmMRmop0T2hZp68d73ZpDW?key=-T9NX3CGBv1M5bfMJgGn1DiB).

Uma janela pop-up “Configurações do elemento” será aberta:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeWhBpb2L3cIl0qHxa5eUxaXL6yrNeroMaRy8xlCrm9ZAgJ7umCDMw8-O38ZeGyTEoHOh85-fQSmYNptDP0KZo2coCyntUBezIBG077JN5yIZntQ15bQGYc8GEikxW_N6P6EZCl4Q?key=-T9NX3CGBv1M5bfMJgGn1DiB" alt=""><figcaption></figcaption></figure>

### Campos para configuração do widget

Preencha os campos necessários para configurar o widget.

**“Obrigatório”** – checkbox, preenchido manualmente com o botão esquerdo do mouse. Destina-se a colorir o campo de vermelho, se o Usuário não preencher este widget.

**“Nome visível”** – campo de texto, preenchido manualmente com o teclado. Permite especificar um nome para o widget.

**“Nome do Parâmetro na Tarefa (Task)”** – campo de texto, preenchido manualmente com o teclado. Neste campo é exibido o texto que corresponde ao valor do Parâmetro especificado da Tarefa selecionada. O Usuário pode alterar esse valor no campo de texto, e após salvar o formulário, o novo valor será gravado no Parâmetro da Tarefa selecionada. Isso significa que ao fazer alterações no campo de texto, o Usuário pode atualizar as informações na Tarefa, bastando apenas inserir um novo valor e salvar as alterações.

**“Placeholder”** – campo de texto, preenchido manualmente com o teclado. Permite especificar um texto de placeholder que será exibido no campo de entrada até que o usuário comece a digitar um valor.

**“Classe”** – campo de texto, preenchido manualmente com o teclado. Permite especificar uma classe CSS que será aplicada ao elemento. Isso permite alterar o estilo do widget, por exemplo, cor, tamanho ou fonte.

**“Expressão regular (Regexp)”** – campo de texto, preenchido manualmente com o teclado. Permite definir uma expressão regular para validação da entrada.

**“Mensagem de erro de validação”** – campo de texto, preenchido manualmente com o teclado. Permite especificar um texto que será exibido ao Usuário caso o valor inserido não passe na validação.

**“Dica”** – campo de texto, preenchido manualmente com o teclado. Permite especificar uma dica adicional que ajudará o usuário a entender o que exatamente deve ser inserido.

**“Valor padrão”** – campo de texto, preenchido manualmente com o teclado. Permite especificar um valor que será exibido no campo de entrada por padrão.

**“Chave”** – campo de texto, preenchido manualmente com o teclado. Permite atribuir um identificador único ao controle ou suas opções. A chave é necessária para o processamento de dados no lado do servidor ou ao processar o formulário programaticamente.

**“Nome da opção”** – campo de texto, preenchido manualmente com o teclado. Permite especificar o texto que será mostrado ao Usuário na interface como uma opção de escolha.

Se for necessário adicionar outras opções de escolha, o Usuário deve clicar no botão ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXe34ZjMmUDu6_6lDIjmFAmXS58LjEV9nfdsvBTa-U87JkhiCb2luBBPLPjC-93xqoAj9rUQ40bfV8aofGz6mMU2rVwAvZR4x0LH13wQw-gfRkftURFiNEustkjbA5Rx_1E0zbCQxQ?key=-T9NX3CGBv1M5bfMJgGn1DiB).

### **Exemplo de preenchimento**

<table data-header-hidden><thead><tr><th width="212"></th><th></th></tr></thead><tbody><tr><td><strong>Nome do campo</strong></td><td><strong>Valor</strong></td></tr><tr><td>Checkbox "Obrigatório"</td><td><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe4mbAVUDpglGzt3Ex7lXp9xpg4SZm1C3GkCnL63jBg0al-WOLp1t_6dauvCXnykMn0jhTUiT31pIlU7ZuRmm_ll6E7sDJ7PDm6xxGiW7pAeAh6brtDgbnGtI1AwKUH_F1BVByp4Q?key=-T9NX3CGBv1M5bfMJgGn1DiB" alt=""></td></tr><tr><td>Nome visível</td><td>Informe suas preferências</td></tr><tr><td>Nome do Parâmetro na Tarefa (Task)</td><td>preferences</td></tr><tr><td>Placeholder</td><td>Escolha uma ou mais opções</td></tr><tr><td>Classe</td><td>checkbox-group</td></tr><tr><td>Expressão regular (Regexp)</td><td><br></td></tr><tr><td>Mensagem de erro de validação</td><td>Por favor, escolha pelo menos uma opção.</td></tr><tr><td>Dica</td><td>Escolha suas preferências entre as opções apresentadas.</td></tr><tr><td>Valor padrão</td><td><br></td></tr><tr><td>Chave</td><td>Opção 1</td></tr><tr><td>Nome da opção</td><td>Café</td></tr><tr><td>Chave</td><td>Opção 2</td></tr><tr><td>Nome da opção</td><td>Chá</td></tr><tr><td>Chave</td><td>Opção 3</td></tr><tr><td>Nome da opção</td><td>Suco</td></tr><tr><td>Chave</td><td>Opção 4</td></tr><tr><td>Nome da opção</td><td>Água</td></tr></tbody></table>

Resultado:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcps28y5Z3qSg13vgjfe2yUxicWE3oms8FIRx-17WMydqlNR3ktfrh7oPJav4KwdHDJf-jllNvr7wrUMvB1cdFpZJB1HHLZG04-wuy75ELKwBjK8jqMatCe3-RkwZ7QgtbaNw_NQg?key=-T9NX3CGBv1M5bfMJgGn1DiB" alt=""><figcaption></figcaption></figure>


---

# 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/deistviya/dizainer-formy/checkbox-group.md?ask=<question>
```

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.