> 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/etiqueta/adicionar-variavel/aba-chaves.md).
# Aba Chaves
Programa: CSW1CUSTOM090TAB1
### Pré-Requisitos
***
Não há.
### Acesso
***
Módulo: Consistem ERP Componentes\
Grupo: Configuração de Etiqueta\
[Configuração de Etiqueta (CSW1TAG115)](/modulos/componentes/manuais-de-telas/etiqueta/configuracao-de-etiqueta.md)\
Botão **Variáveis Tipo Etiqueta**\
[Variáveis do Tipo de Etiqueta (CSW1TAG117)](/modulos/componentes/manuais-de-telas/etiqueta/variaveis-do-tipo-de-etiqueta.md)\
Botão **Incluir**\
[Adicionar Variável (CSW1CUSTOM090)](https://app.gitbook.com/s/0E9n0hpwK2TzblZSHb8i/manuais-de-telas/etiqueta/adicionar-variavel)
### Visão Geral
***
O objetivo desta aba é definir o vínculo entre a etiqueta e a tabela de origem, relacionando as chaves necessárias para a busca da informação.
### Colunas do Grid
***
#### Editar
Permite a alteração dos dados da chave de ligação configurada.
{% hint style="warning" %} **Importante**
Ao clicar na descrição da coluna, as colunas **Origem** e **Propriedade de Origem** são habilitadas para a alteração dos dados.
{% endhint %}
#### Sequência Chave
Exibe o número sequencial da chave de busca na tabela selecionada.
#### Descrição Chave
Exibe a descrição da chave de busca da tabela de origem.
{% hint style="warning" %} **Importante**
Ao clicar na descrição da coluna, será apresentada tela de consulta das características técnicas da tabela ou classe selecionada. O objetivo é auxiliar o usuário na identificação de metadados necessários para a configuração da variável.
{% endhint %}
#### Origem
Informar a origem do dado que alimentará a chave, como variáveis da etiqueta, valores fixos ou informações do sistema. As opções são:\
\- *Variável Etiqueta*: utiliza um campo padrão da própria etiqueta para realizar o vínculo.\
\- *Variável de Contexto*: utiliza informações gerais do sistema ou do ambiente de impressão (como empresa ou usuário).\
\- *Valor Fixo*: utiliza um dado definido manualmente, sem depender de outras variáveis do banco de dados.
#### Propriedade Origem
Informar o nome da propriedade ou campo específico que será utilizado como filtro conforme a origem selecionada.
{% hint style="info" %} **Botão F7**
Apresenta tela com informações técnicas para garantir que o usuário digite os dados da *Variável de Contexto* ou do *Valor Fixo* corretamente.
{% endhint %}
{% hint style="warning" %} **Importante**
Esta coluna será habilitada se a opção *Variável de Contexto* ou *Valor Fixo* estiver selecionada na coluna **Origem**.
{% endhint %}
#### Comando/Função
Informar comandos ou funções da linguagem Caché/IRIS para realizar conversões de texto, ajustes de datas ou cálculos sobre o valor original.
{% hint style="success" %} **Exemplo**
* `**$extract({var},1,15)**` — Extrai do 1º ao 15º caractere.\
\* `**$zconvert({var},"U")**` — Converte todo o texto para maiúsculas.\
\* `**$piece({var}," ",1)**` — Retorna apenas a primeira palavra.\
\* `**$fnumber({var},".",3)**` — Converte o valor da propriedade para 3 casas decimais.\
\* `**$piece({var},"/",3)_"/"_$piece({var},"/",2)**` — Converte uma data no formato DD/MM/AAAA para AAAA/MM.\
\* `**$zdateh({var},4,,4)**` — Converte uma data externa no formato DD/MM/AAAA para uma data interna no Caché/IRIS (formato utilizado no banco de dados).\
\* `**+$horolog-($zdateh({var},4,,4))**` — Calcula a diferença de dias entre a data atual '$horolog' e a data (data interna) da propriedade {var}.\
\* `**$zstrip({var},"<>W")**` — Remove espaços em branco do início e do fim da frase.\
\* `**$translate({var}," ","-")**` — Troca espaços em branco por '-' (traço).\
\* `**$select({var}=1:"Sim",{var}=0:"Não",1:"Talvez")**` — Se {var} for igual a *1*, retorna *Sim*; se for igual a *0*, retorna *Não*; caso contrário, retorna *Talvez*. O *1:* final funciona como um Else (valor padrão) e é de uso obrigatório na sintaxe.\
\* `**$translate($justify({var},6)," ",0)**` — Justifica com zeros à esquerda (se o código for '123', ele transformará em '000123').
{% endhint %}
### Botões
***
#### Manutenção
As colunas **Origem** e **Propriedade de Origem** são habilitadas para a alteração dos dados.
***
{% hint style="danger" %} **Atenção**
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 %}
Esse conteúdo foi útil?
Sim Não
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/etiqueta/adicionar-variavel/aba-chaves.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.