Árvore de páginas

Versões comparadas

Chave

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

Índice

Índice
maxLevel4
outlinetrue
exclude.*ndice
stylenone

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
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. (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: (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: (sistema) _ (processo)

Bloco de código
titleExemplo
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


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, devem estar agrupados, Labels sempre acima dos InputText, 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.

...