Adicionar Elementos Personalizados
Programa: CSW1CUSTOM020A
Pré-Requisitos
O acesso à Camada de Personalização é concedido no programa Configuração de Permissão de Perfil e Usuário (CSWMEN070), 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 (exceto Componentes) Ícone de Cubo - Camada de Personalização (canto superior direito da tela) Opção Elementos Personalizados Elementos Personalizados (CSW1CUSTOM020) Botão Novo
Visão Geral
O objetivo deste programa é adicionar componentes personalizados na interface de uma rotina do sistema sem alterar seu código-fonte. Esta tela centraliza a configuração do novo elemento, determinando sua posição, aparência (ícone e texto), a rotina que será executada ao ser acionado, e os parâmetros que essa rotina de destino receberá.
Importante
É necessário re-autenticar no sistema para que a alteração seja aplicada.
Importante
O item Instruções está posicionado no canto superior direito da área de preenchimento. Ao clicar, o usuário acessa as informações detalhadas para a criação do elemento personalizado.
### Campos
Campos assinalados com | são de preenchimento obrigatório.
Código da Rotina|
Informar o código da rotina de origem onde o elemento personalizado será aplicado. Ao executar esta tela este campo é preenchido de forma automática, mas pressionando a tecla Seta para Cima este campo habilita.
Botão F7
Apresenta tela com as rotinas configuradas neste programa para seleção.
#### Sequência|
Informar a ordem do elemento na rotina.
Tipo|
Selecionar o tipo de elemento a ser adicionado. A opção é: - Chamada de Rotina
Descrição|
Informar o nome do botão que será exibido na rotina de origem.
Situação|
Determinar a situação do elemento. As opções são: - Ativo - Inativo
Botão de Referência
Informar o código de um botão já existente na rotina de origem para que o novo botão copie seu comportamento de habilitação e desabilitação.
Botão F7
Apresenta tela com os botões padrões de referência disponíveis no código-fonte desta rotina para seleção.
#### Rotina Executada|
Informar o código da rotina de destino que será acionada quando o botão for clicado. Pode ser uma rotina padrão ou customizada.
Posição Vertical (Linha)|
Informar a linha vertical na tela onde o botão será posicionado.
Importante
Se o botão não for exibido na tela, ajuste estas opções até que ele se torne visível.
#### Posição Horizontal (Coluna)|
Informar a coluna horizontal na tela onde o botão será posicionado.
Importante
Certifique-se de que o botão não esteja sobreposto por qualquer outro componente da tela (como campos, displays, grids ou outros botões).
#### Tamanho
Informar a largura que o botão ocupará na tela.
Ícone
Informar o nome do ícone válido a ser exibido no botão.
Botão F7
Apresenta tela com os principais ícones disponíveis para seleção.
#### Atalho
Informar uma tecla de atalho para acionar o botão. Não é obrigatório, mas requer atenção para evitar conflitos com atalhos já existentes na rotina de origem.
Texto Ajuda
Informar o texto de dica ou tooltip que será exibido quando o mouse passar sobre o botão. Pode-se utilizar tags HTML como "<b>" e "<br>".
Colunas do Grid
Seq. Parâmetro
Informar o código com a ordem sequencial em que o parâmetro será passado para a rotina de destino.
Tipo
Definir a fonte do parâmetro. As opções são: - Variável de Contexto - Coluna de Grid (Display) - Coluna de Grid (Detalha) - Valor Fixo - Comando/Função ou Expressão
Importante
Para a correta configuração, é necessário ter conhecimento prévio dos parâmetros da rotina e das variáveis de contexto da rotina de origem.
#### Valor
Informar o valor do parâmetro. Depende do tipo escolhido: é o nome da variável, o código da coluna do grid, ou a expressão a ser avaliada.
Exemplo
$piece(VARIAVEL,Z,1)
#### Código Grid
Indicar de qual grid os dados serão obtidos.
Importante
Esta coluna será habilitada se a coluna Tipo estiver com a opção Coluna de Grid (Display) ou Coluna de Grid (Detalha) selecionada.
### Botões
Manutenção
As colunas permitidas são habilitadas para alteração dos dados.
Incluir
As colunas são habilitadas para inclusão de novos dados.
Remover
Permite excluir a linha selecionada no grid.
Salvar
Salva as configurações do novo elemento personalizado. Após salvar, o botão é imediatamente aplicado à rotina de origem.
Excluir
Permite excluir o elemento personalizado que está sendo editado.
Importante
Este botão será habilitado após a gravação dos dados.
#### Cancelar
Limpa as informações descritas na tela e retorna ao programa Elementos Personalizados (CSW1CUSTOM020).
Parâmetros
Apresenta tela com os parâmetros esperados para a rotina executada, caso haja.
Importante
Estes parâmetros estão definidos no código-fonte da rotina e requerem conhecimento técnico para sua correta identificação e uso.
***
Atenção
As descrições das principais funcionalidades do sistema estão disponíveis na documentação de Componentes. A utilização incorreta deste programa pode ocasionar problemas no funcionamento do sistema e nas integrações entre módulos.
Esse conteúdo foi útil?
Atualizado