Histórico da Página
...
O passo a passo para uma customização não requer muito esforço, mas requer bastante atenção, pois deve-se ter em mente que não se trata de um desenvolvimento de um formulário completo, mas apenas de um complemento a um formulário padrão da TOTVS já existente que não pode comprometer negativamente o funcionamento do formulário padrão.
A customização de um formulário, em poucas palavras, resume-se a alterar toda e qualquer informação existente no formulário que permita informar ou trocar um valor já preeenchidoo que faça parte de informações do formulário padrão liberado pela TOTVS.
Os eventos disponíveis nos formulários que permitem customização são identificados com o termo USER como prefixo, como por exemplo USER BEFORE LOAD, USER AFTER FIELD, USER AFTER INSERT, USER CONFIRM, etc. Estes eventos de usuário estão disponíveis nos quatro formulários citados logo acima (FRM1001, FRM1002, FRM1009 e FRM1016).
O que devo fazer para que o Logix permita customizar formulários metadado?
Para habilitar a customização dos formulários padrões TOTVS no Metadados é necessário ativar a chave de profile logix.metadata.customEnabled, atribuindo a ela o valor 1 (Ativo). Para mais informações sobre esta chave acesse Chaves de configuração no Profile - Freeform / Metadados.
Para criar novos formulários, preciso de alguma permissão, além do acesso aos programas com prefixo FRM?
Sim, para criar novos formulários no metadado e demais entidades relacionadas que formam um formulário é preciso, além de ter permissões de acesso para os programas com prefixo FRM, setar valor para chave de profile logix.metadata.resPrefix. O valor a ser informado deverá ser a sigla de prefixo que será considerado para nomear todos os novos formulários específicos que venham a ser incluídos no Logix. Esta chave permite informar mais do que uma sigla. Para mais informações sobre como registrar o valor desta chave acesse Chaves de configuração no Profile - Freeform / Metadados.
A cópia de formulários padrões irá automaticamente criar novos formulários específicos, pois estas cópias tratam-se de novos formulários e, com isso, deixam de ser padrões e passam a ser ESPECÍFICOS.
Qual a diferença entre formulário customizado e específico?
O formulário customizado trata-se de um formulário padrão TOTVS que possui algumas informações complementares que o você registrou.
A partir do pacote 12.1.2309, ao acessar os programas de cadastros de formulários metadado e consultar algum formulário que tenha uma customização registrada, será exibido um alerta no topo da tela para indicar (Formulário Customizado).
Quais informações do formulário padrão consigo acessar?
...
Quando os eventos complementares de usuário são acionados?
Por padrão a maioria dos eventos do metadado sempre executa primeiramente o evento definido para o formulário padrão Totvs e na sequência o evento customizado (evento de usuário).
Veja na tabela abaixo que existe apenas uma exceção onde o evento não é executado neste ordem:
| Evento | Acionado ANTES do evento padrão | Acionado APÓS o evento padrão |
|---|---|---|
| BEFORE LOAD | X | |
| AFTER LOAD | X | |
| BEFORE ZOOM | X | |
| AFTER_ZOOM | X | |
| BEFORE FIELD | X | |
| VALID FIELD | X | |
| AFTER FIELD | X | |
| BEFORE INSERT ROW | X | |
| AFTER INSERT ROW | X | |
| BEFORE ROW | X | |
| AFTER ROW | X | |
| BEFORE DELETE ROW | X | |
| AFTER DELETE ROW | X | |
| BEFORE INPUT OPERATION | X | |
| CANCEL INPUT OPERATION | X | |
| BEFORE CONFIRM OPERATION | X | |
| CONFIRM OPERATION | X | |
| AFTER CONFIRM OPERATION | X |
Definindo as tabelas novas no metadado
...
| Nota | ||
|---|---|---|
| ||
Atente que no programa Sincronizador Metadado existe uma opção para que você exporte apenas as customizações. É importante que assinale apenas a opção de exportar as customizações para evitar a exportação de recursos padrões, que numa futura importação de XML pode acabar sobrepondo informações padrões metadado do Logix que podem ter sido alteradas em alguma atualização de pacote do produto. |
Pontos de atenção
...
Apesar das telas de cadastro que permitem customização darem acesso a alterar muitas informações, deve-se tomar cuidado na mudança de Agrupamento de componentes, ordenação de campos, máscaras de edição que podem comprometer o funcionamento padrão do programa/formulário.
Se alguma alteração realizada gerar impacto, basta desfazer a alteração e realizar novos testes até que a customização desejada esteja completamente funcional.
Tabelas envolvidas
...
As informações de formulários específicos e customizados do Logix são armazenados em uma lista de tabelas isoladas das tabelas dos formulários padrões Totvs.
As tabelas envolvidas são:
| Tabela | Descrição |
|---|---|
| frm_user_toolbar | Barra de Ferramentas |
| frm_user_form | Formulários de cadastro (CRUD) |
| frm_user_form_table | Tabelas dos formulários |
| frm_user_form_component | Componentes dos formulários |
| frm_user_form_group | Grupos de componentes dos formulários |
| fm_user_virtual_column | Colunas virtuais dos formulários |
frm_user_virtual_column_legend | Legendas de colunas virtuais dos formulários |
| frm_user_control | Controle de recursos especificos |
| Nota |
|---|
Em alguns cenários podem existir formulários específicos que não estejam registrados nessa lista de tabelas. Estes casos são situações de formulários que foram registrados na base de dados Logix antes do desenvolvimento da Customização Metadado. Futuramente serão transferidos para as respectivas tabelas da lista acima, emitindo um alerta para o usuário administrador antes efetivar essa transferência, mas essa melhoria será comunicada nas notas de release de Framework de pacote Logix oficialmente expedidos. |
Exemplo de Customização
...
Anexo está o arquivo log02700_custom.zip que contém arquivo fonte .4gl de customização do formulário padrão log02700 do Logix. A customização consiste na gravação e consulta de dados em uma nova tabela, com 2 novos campos adicionados a tela do formulário padrão conforme sinalizado em vermelho abaixo.
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas