> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/camada-de-personalizacao/parametros-de-clique.md).

# Parâmetros de Clique

Programa: CSW1CUSTOM150

### Pré-Requisitos

***

Não há.

### Acesso

***

Módulo: Componentes\
Grupo: Camada de Personalização\
[Gerador de Workspace (CSW1CUSTOM140)](https://app.gitbook.com/s/0E9n0hpwK2TzblZSHb8i/manuais-de-telas/camada-de-personalizacao/gerador-de-workspace)\
Botão **Novo Workspace**\
[Cadastro do Workspace (CSW1CUSTOM141)](https://app.gitbook.com/s/0E9n0hpwK2TzblZSHb8i/manuais-de-telas/camada-de-personalizacao/cadastro-do-workspace)\
[Aba Cards (CSW1CUSTOM141TAB2)](https://app.gitbook.com/s/0E9n0hpwK2TzblZSHb8i/manuais-de-telas/camada-de-personalizacao/cadastro-do-workspace/aba-cards)\
Botão **Incluir**\
[Cadastro do Card (CSW1CUSTOM142)](https://app.gitbook.com/s/0E9n0hpwK2TzblZSHb8i/manuais-de-telas/camada-de-personalizacao/cadastro-do-card)\
Botão **Incluir**\
[Cadastro do Widget (CSW1CUSTOM143)](https://app.gitbook.com/s/0E9n0hpwK2TzblZSHb8i/manuais-de-telas/camada-de-personalizacao/cadastro-do-widget)\
*Aba Conteúdo (CSW1CUSTOM143TAB1)*\
Botão **Parâmetros de Clique**

### Visão Geral

***

O objetivo deste programa é cadastrar e gerenciar os argumentos/parâmetros que serão entregues à rotina de clique do widget, permitindo parametrizar o envio de dados do evento para acionar outras telas e rotinas do sistema. Estas telas do sistema precisam estar preparadas para receber parâmetros.

### Campos

***

*Campos assinalados com* <mark style="color:red;">**|**</mark> *são de preenchimento obrigatório.*

#### Workspace

Exibe o código, a descrição e a situação do workspace selecionado.

#### Card

Exibe o código, a sequência e o título do card a que pertence o widget.

#### Widget

Exibe a sequência e o título do widget em edição.

#### Rotina de Clique

Exibe o nome da rotina do sistema que será acionada ao clicar sobre o widget.

### Colunas do Grid

***

#### Sequência

Informar a posição sequencial do parâmetro na chamada da rotina de clique. A sequência sugere a próxima posição livre, mas aceita qualquer posição, permitindo a execução de um parâmetro não obrigatório da rotina a ser chamada.

#### Origem

Selecionar a proveniência do dado enviado à rotina de destino. As opções são:\
\- *Propriedade do Clique*\
\- *Filtro*\
\- *Contexto*\
\- *Valor Fixo*

#### Valor

Informar a propriedade do evento (cswObjEvent.name, cswObjEvent.value), o nome do filtro do painel, a variável de contexto (%codEmpresa, %codOperador) ou o texto fixo repassado ao parâmetro.

{% hint style="info" %} <mark style="color:blue;">**Botão F7**</mark>

Apresenta tela com sugestões conforme a origem escolhida para seleção.
{% endhint %}

#### Comando/Função

Informar a instrução ou função nativa do IRIS utilizada para transformar o valor antes do disparo da chamada (exemplo: $piece({var}," ",1) ou $zdateh({var},4)). A variável {var} representa o conteúdo capturado na coluna **Valor**.

{% hint style="warning" %} <mark style="color:orange;">**Importante**</mark>

Utilizar quando houver a necessidade de modificar o conteúdo de alguma variável. Exemplo: pegar um pedaço do conteúdo, ou transformar seu valor.
{% endhint %}

### Botões

***

#### Parâmetros

Apresenta a lista de consulta contendo a relação e a sequência de todos os parâmetros esperados pela rotina de clique configurada.

#### Manutenção

As colunas permitidas são habilitadas para alteração dos dados.

#### Incluir

As colunas permitidas são habilitadas para inclusão de novos dados.

#### Remover

Exclui a linha selecionada no grid.

#### Pré-Visualizar

Grava os parâmetros configurados e apresenta o programa [Executor de Teste do Workspace (CSW1CUSTOM149)](https://app.gitbook.com/s/0E9n0hpwK2TzblZSHb8i/manuais-de-telas/camada-de-personalizacao/executor-de-teste-do-workspace) para testar visualmente o workspace e a chamada do evento.

#### Ver Evento

Apresenta tela detalhando a estrutura do objeto de evento do widget, com a relação de propriedades e valores de exemplo.

#### Ajuda

Apresenta tela contendo instruções sobre as origens de dados, sintaxe de comandos e mapeamento de argumentos.

#### Salvar

Salva as informações da tela.

#### Cancelar

Descarta as alterações efetuadas na tela e recarrega os dados salvos.

***

{% hint style="danger" %} <mark style="color:red;">**Atenção**</mark>

As descrições das principais funcionalidades do sistema estão disponíveis na documentação de [Componentes](/tecnologia/erp/componentes.md).\
A utilização incorreta deste programa pode ocasionar problemas no funcionamento do sistema e nas integrações entre módulos.
{% endhint %}

<p align="center">Esse conteúdo foi útil?</p>

<p align="center"><a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-up">Sim</a> <a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-down">Não</a></p>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/camada-de-personalizacao/parametros-de-clique.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
