Histórico da Página
Índice
Índice | ||||||||
---|---|---|---|---|---|---|---|---|
|
Objetivo
...
O objetivo deste guia é apresentar a estrutura dos formulários, bem como boas práticas de nomenclatura e dicas para o desenvolvimento.
Nomenclatura
Código do Processo
Para convencionar os processos que serão criados, os códigos devem seguir o seguinte padrão: (area) _ (ação)
Bloco de código | ||
---|---|---|
| ||
estoque_picking, controladoria_pedidocompra |
Serviços
O arquivo proxy, quando integrado ao EMS, poderá ter o mesmo nome do serviço, a fim de simplificar ao criar o serviço, por exemplo ems_despesasavulsas.jar.Para convencionar os serviços que serão incluídos, os códigos devem seguir o seguinte padrão: (sistema) _ (processo).
Bloco de código | ||
---|---|---|
| ||
ems_despesasavulsas |
Código do Dataset
Também esses códigos deverão ser usados como nome do Dataset, para facilitar na busca: Para convencionar os datasets que serão criados, os códigos devem seguir o seguinte padrão: (sistema) _ (transação) _ (item/artefato)
Bloco de código | ||
---|---|---|
| ||
ems_consulta_ccusto, fluig_inclui_colleague |
Mecanismo
O arquivo proxy, quando integrado ao EMS, poderá seguir o mesmo modelo no nome do serviço a fim de simplificar na criação: Para convencionar os mecanismos que serão criados, os códigos devem seguir o seguinte padrão: (sistema) _ (processo)
Bloco de código | ||
---|---|---|
| ||
protheus_alcadacompras |
Campos no Formulário e Variáveis
Devemos manter os seguintes prefixos de campos do formulário e para variáveis.
Prefixo | Tipo | Exemplo |
---|---|---|
vl | Valor | vl_total , vl_telefone |
nm | Nome | nm_cliente , nm_fornecedor |
dt | Data | dt_emissao , dt_faturamento |
lb | Booleano | lb_temfrete , lb_emiteboleto |
ds | Textarea | ds_comentarios , ds_observacoes |
cb | Combo box | cb_estado , cb_cidade |
Nota | ||
---|---|---|
| ||
Não é possível alterar o tipo de um campo anteriormente criado no formulário. Esta alteração não será refletida no banco de dados. Como paliativo, é possível alterar o nome do campo de formulário. Desta forma ele será registrado no banco de dados como um novo campo. |
Estrutura
...
Para entendimento do modelo, o formulário é dividido em três partes sendo o Cabeçalho, Conteúdo e Rodapé.
...
É possível agrupar grandes quantidades de informações utilizando agrupadores por localização.
Cabeçalho
O cabeçalho se encontra na parte superior do formulário e dever ser utilizado para apresentar o título explicativo sobre a coleção de dados. Neste local também, alinhado à direita, pode ser inserido a logomarca do cliente. O tamanho sugerido é de 150px x 50px.
Conteúdo
A área de conteúdo se encontra na parte intermediária do formulário, entre o cabeçalho e rodapé, e dever ser utilizado para apresentar a coleção de dados.
Rodapé
O rodapé se encontra na parte inferior do formulário, e dever ser utilizado para apresentar as ações relacionadas e disponíveis para a coleção de dados quando necessário.
Elementos
Conforme a imagem abaixo, podemos verificar os elementos essenciais. O título deve estar alinhado à esquerda e sempre que possível ser correspondente a à coleção de dados. Os dados sempre que possível, de preferência, devem estar agrupados, Labels labels sempre acima dos InputText, e botões com ações localizados no rodapé alinhados à direita.
Dimensões
Os formulários devem ter seu tamanho adaptável a tela, não deve ter tamanho fixo.
Dicas Práticas
...
- Monte a ordem dos campos no formulário respeitando as regras do negócio relacionadas àquele conteúdo.
...