Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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
titleExemplo
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
titleExemplo
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
titleExemplo
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
titleExemplo
protheus_alcadacompras

...

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
titleAtenção!

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é.

...

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.

...

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.

...