> 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-propriedades.md).

# Aba Propriedades

Programa: CSW1CUSTOM090TAB2

### 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 é configurar quais campos da tabela serão utilizados como variáveis e aplicar comandos ou funções de formatação.

### Colunas do Grid

***

#### Editar

Permite efetuar manutenção ao clicar na coluna do grid.

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

As colunas **Propriedade** e **Comando/Função** são habilitadas para a alteração dos dados.
{% endhint %}

#### Variável

Informar o nome da variável que será utilizada na etiqueta.

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

Ao clicar no link da coluna, é possível copiar e colar o nome da variável diretamente no aplicativo da etiqueta.
{% endhint %}

#### Propriedade

Informar o campo correspondente na tabela/classe de origem que contém o dado desejado a ser utilizado na etiqueta.

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

Ao clicar no link da coluna, é apresentada tela com especificações técnicas da propriedade selecionada. O objetivo é permitir ao usuário validar se a estrutura do campo está de acordo com o esperado para a composição do layout.
{% 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" %} <mark style="color:green;">**Exemplo**</mark>

* `**$extract({var},1,15)**` — Extrai do 1º ao 15º caractere.\
  \* `**$zconvert({var},&quot;U&quot;)**` — Converte todo o texto para maiúsculas.\
  \* `**$piece({var},&quot; &quot;,1)**` — Retorna apenas a primeira palavra.\
  \* `**$fnumber({var},&quot;.&quot;,3)**` — Converte o valor da propriedade para 3 casas decimais.\
  \* `**$piece({var},&quot;/&quot;,3)_&quot;/&quot;_$piece({var},&quot;/&quot;,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},&quot;&lt;&gt;W&quot;)**` — Remove espaços em branco do início e do fim da frase.\
  \* `**$translate({var},&quot; &quot;,&quot;-&quot;)**` — Troca espaços em branco por '-' (traço).\
  \* `**$select({var}=1:&quot;Sim&quot;,{var}=0:&quot;Não&quot;,1:&quot;Talvez&quot;)**` — 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),&quot; &quot;,0)**` — Justifica com zeros à esquerda (se o código for '123', ele transformará em '000123').
  {% endhint %}

### Botões

***

#### Manutenção

As colunas **Editar**, **Variável**, **Propriedade** e **Comando/Função** são habilitadas para a alteração dos dados.

#### Incluir

Permite adicionar uma nova linha ao grid para configurar uma nova variável.

#### Remover

Exclui a linha selecionada no grid.

***

{% 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 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-propriedades.md?ask=<question>&goal=<endgoal>
```

`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.