> 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/adicionar-labels-e-displays-personalizados-codigo-low-code.md).

# Adicionar Labels e Displays Personalizados (Código Low Code)

Programa: CSW1CUSTOM021A

### Pré-Requisitos

***

O acesso à Camada de Personalização é concedido no programa [Configuração de Permissão de Perfil e Usuário (CSWMEN070)](/modulos/componentes/manuais-de-telas/configuracao-dos-componentes/configuracao-de-permissao-de-perfil-e-usuario.md), onde se deve marcar a opção *Permitir Acesso a Camada de Personalização de Programas* na coluna **Configuração**. Este acesso é automaticamente liberado para **Usuários Administradores** e **Usuários Consistem**.

### Acesso

***

Programa do ERP\
[Ícone de Cubo](https://ajuda.consistem.com.br/tecnologia/erp/componentes7/interface-visual/elementos/barra-de-titulo#id-8.-camada-de-personalizacao) - Camada de Personalização (canto superior direito da tela)\
Opção *Elementos Personalizados*\
[Elementos Personalizados (CSW1CUSTOM020)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/elementos-personalizados.md)\
Botão **Novo**\
Opção *Adicionar Label e Display*

### Visão Geral

***

O objetivo deste programa é permitir a configuração, inclusão e manutenção de rótulos (labels) e campos de texto dinâmicos (displays) personalizados na interface do sistema através de código low code, possibilitando a exibição de informações complementares e personalizações visuais sem a necessidade de alteração direta no programa de origem.

### Campos

***

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

#### Código da Rotina<mark style="color:red;">**|**</mark>

Informar o código do programa que receberá a personalização.

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

Apresenta as rotinas disponíveis para inclusão da opção de label e display.
{% endhint %}

#### Status do Low Code

Exibe o código da rotina de low code gerada.

#### Sequência<mark style="color:red;">**|**</mark>

Informar o número sequencial do elemento personalizado na rotina.

#### Situação

Selecionar a situação do registro, marcando a opção *Inativo* ou *Ativo*.

#### Descrição da Label

Informar o texto que será apresentado na etiqueta visual (label) da tela.

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

Evite o uso de vírgulas ou caracteres especiais no texto.
{% endhint %}

#### Posição Vertical (Linha)<mark style="color:red;">**|**</mark>

Informar a linha em que o elemento deve ser posicionado.

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

Se o elemento não estiver visível na tela, tente alterar a posição de sua linha ou coluna. Ele pode estar oculto atrás de outros componentes (como campos ou grids). Faça os ajustes necessários até obter a visualização desejada.
{% endhint %}

#### Posição Horizontal (Coluna)<mark style="color:red;">**|**</mark>

Informar a coluna em que o elemento deve ser posicionado.

#### Tamanho do Display

Informar o tamanho do display em pixel.

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

Caso o campo não seja preenchido, o sistema assumirá um valor padrão. Para omitir a exibição do display, informe o valor zero (0).
{% endhint %}

#### Elemento de Referência

Informar o elemento de referência que servirá de base para executar o display personalizado.

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

Apresenta tela com os elementos de referência cadastrados no programa [Elementos Personalizados (CSW1CUSTOM020)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/elementos-personalizados.md) para seleção.
{% endhint %}

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

O elemento deve existir na rotina de origem.\
O código-fonte não será executado caso a referência não seja informada.
{% endhint %}

#### Texto de Ajuda

Informar o texto de instrução (tooltip) apresentado na label.

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

Evite vírgulas e caracteres especiais. É permitido o uso das tags \<b> (negrito) e \<br> (quebra de linha).
{% endhint %}

{% hint style="success" %} <mark style="color:green;">**Exemplo**</mark>

\<br>\<b>texto1\</b>...
{% endhint %}

#### Label em Negrito

Informar *Sim* ou *Não* para determinar se o texto da etiqueta deve ser exibido em formato negrito, selecionando entre as opções disponíveis.

#### Cor de Fonte da Label

Informar a cor da fonte a ser aplicada na etiqueta visual. As opções são:\
\- *Padrão Sistema*\
\- *Preto*\
\- *Vermelho*\
\- *Azul*\
\- *Amarelo*\
\- *Verde*\
\- *Cinza*

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

A cor deve ser informada em hexadecimal (ex: #FF0000) ou pelo número correspondente: 1-Preto | 2-Vermelho | 3-Azul | 4-Amarelo | 5-Verde | 6-Cinza | 7-Branco
{% endhint %}

#### Código Fonte<mark style="color:red;">**|**</mark>

Digite o código ObjectScript que será compilado e executado para gerar o conteúdo exibido no display.

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

Preencha o parâmetro *tabRetorno(dados)* com o valor que deseja exibir. Se precisar de ajuda, clique em **Sugerir Exemplo** para carregar modelos prontos.
{% endhint %}

#### Aviso (Dica do Código Fonte)

Exibe instruções, exemplos de sintaxe e dicas de comandos válidos para a construção do código low code.

### Botões

***

#### Salvar

Salva as informações da tela.

#### Excluir

Permite remover a configuração do elemento personalizado selecionado.

#### Cancelar

Limpa as informações descritas na tela e retorna ao campo **Consulta de Rotinas**.

#### Sugerir Exemplo

Apresenta tela com exemplos de modelos prontos de código para a criação do low code.

#### Variáveis

Apresenta o programa [Definição de Variáveis (CSW1CUSTOM114)](https://app.gitbook.com/s/0E9n0hpwK2TzblZSHb8i/manuais-de-telas/camada-de-personalizacao/definicao-de-variaveis114) para consultar a lista de variáveis de contexto disponíveis para uso no código. Use esta opção para vincular no código-fonte as variáveis declaradas no formato :variavel:.

#### Histórico

Apresenta o programa [Histórico do Código Low Code (CSW1CUSTOM112)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/historico-do-codigo-low-code.md) para consultar o histórico de alterações efetuadas na configuração do elemento.

#### Ajuda

Apresenta o programa [Observação (CSW1OBS2)](/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/observacao.md), com instruções para implementar os elementos de label e display na rotina de origem.

#### Instruções

Exibe dicas e instruções adicionais sobre a personalização da tela.

***

{% 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/adicionar-labels-e-displays-personalizados-codigo-low-code.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.
