Introdução
O sistema possui o conceito de customização, que possibilita aos
clientes desenvolver estruturas de dados, processos e relatórios próprios.
Para isso, o cliente deverá criar registros utilizando chaves negativas custom.
Objetivo
Criação registros e scripts customizados no Web Framework e na IDE que se integram à base de código
do sistema.
Estrutura do guia
A estrutura conceitual dos assuntos abordados nesse guia é:
- Fluxo Operacional
- Conceito do produto custom
- Habilitando a base de desenvolvimento para criação de chaves custom
- Criando registros no produto custom
Fluxo Operacional
Conceito do produto custom
Os processos, relatórios e demais funcionalidades do sistema são
divididos em produtos (i.e.: financeiro, frente de loja, etc.). Cada produto
possui uma faixa de chaves negativas. Dessa forma, é possível identificar a qual
produto uma chave pertence, verificando a faixa da qual faz parte.
Para distinguir os códigos, classes e registros custom dos demais produtos do sistema, existe um produto chamado "custom". Esse produto também possui
uma faixa de chaves negativa, o que permite que todo o código e os dados
customizados de um cliente possam ser levados de uma base a outra.
Habilitando a base de desenvolvimento para criação de chaves custom
Para que um usuário possa criar códigos no produto custom de uma base, é
necessário habilitá-lo no processo de customização. Esse processo se localiza em
Menu > Admin > Customização > Configuração. Adicione os usuários que estarão
habilitados a criar códigos ou registros custom na grade
"Usuários que podem criar chaves Custom".
Importante: a customização deve ser habilitada apenas em uma base de dados,
sendo sugerida a base de desenvolvimento. Ao habilitar uma base para
desenvolvimento custom, certifique-se que todas as demais bases estão com a
customização desabilitada. Caso outra base tenha sido empregada para o
desenvolvimento custom, é importante que ocorra um upgrade completo do produto
custom para a nova base que será empregada para o desenvolvimento custom.
O motivo para essa exigência é para evitar que a nova base utilizada no
desenvolvimento custom consuma chaves já utilizadas na base anterior. Caso essa
exigência não seja cumprida, haverá um sério risco de colisão e duplicidade de
chaves custom quando o código e as classes custom forem integrados em uma mesma
base.
Criando registros no produto custom
Para criar registros custom no Web Framework, utilize o processo processo Menu > Admin > Customização > Criação de chaves Custom. Nele é possível ativar ou desativar a
criação de chaves custom dentro do sistema. Caso o usuário não esteja habilitado para
criação de chaves negativas esse processo irá redirecionar o usuário para
a grade de configuração de usuários.
Para criar registros custom na IDE, é necessário ativar a criação por meio da opção no menu "Tools" da IDE.
Para que novos códigos e classes sejam criados no produto custom, o
desenvolvedor deve selecionar esse produto em Tools > License to create keys.
Note que essas configurações valem apenas para a sessão corrente do usuário. Ao reiniciar o sistema ou a IDE, a criação de chaves Custom será automaticamente desativada.