ADS Core

Índice

Cadastro de Entidades

ADS_CORE.CAD_ENT

Descrição

Interface utilizada para consultar e alterar as propriedades de uma entidade.
A interface é dividida pela parte de definição central da mesma composta por:

Diagrama

Na tela de consulta, o Telescope apresenta um pequeno diagrama que resume a estrutura da entidade e seu relacionamento
com outras entidades.
[[image:ads/CadEnt-01.png]]
Neste diagrama, os links a direita são entidades que esta entidade referencia.
Os links para cima, indicam um relacionamentos de agregação onde a entidade sendo consultada é um elemento agregado ao
de cima.
Os links da esquerda são entidades que referenciam a que está sendo consultada e as de baixo são entidades agregadas a
esta.

Convencão do diagrama


Ações especiais


[[icon:db.gif]] Gerar DDL de criação da tabela

Esta opção permite gerar o script de criação da tabela.

[[icon:gerar.gif]] Gerar códigos o build ativo

Ao clicar nesta opção o sistema irá gerar/atualizar todos os códigos desta arquitetura e que estão relacionados com esta
entidade.

[[icon:wizard.gif]] Criar interface CRUD

Ao executar esta ação, o Telescope irá criar uma interface CRUD com base nesta entidade.

Atributos

Os atributos são apresentados na tela de consulta da entidade:
[[image:ads/CadEnt-02.png]]

Na edição dos atributos, é possível normalizar a coluna usando o ícone [[icon:normalizar.gif]].

Detalhes

Depois, os seguintes detalhes poderão ser acrescentados:

(este texto foi editado usando [[ads.cad_documentation]])
[[pessoas.cad_pessoas]]

Esta interface é usada em diferentes guias do sistema. Clique nos links de navegação abaixo para obter maiores informações.

Módulo de Entidades:

Campos:

Indica o nome global do componente. Se o componente for raiz (não tem pai), então o nome global será igual ao nome do componente. Se o componente não for raiz (tem pai), então o nome global é formado pelo nome global do componente pai + "." + nome do componente. Ex: ADS, ADS.COMPONENTES, ADS.COMPONENTES.NOME_GLOBAL
Como uma instância desta entidade deve ser chamada.
Nome lógico da entidade no plural.
Nome dado para a entidade. Ex: PEDIDOS, PRODUTOS, ROTAS_ALTERNATIVAS, etc.
Alias sugerido para a entidade. Use um nome curto e único para o sistema. Ex: PEDI, ROTALT, etc.
Indica o nome global do componente. Se o componente for raiz (não tem pai), então o nome global será igual ao nome do componente. Se o componente não for raiz (tem pai), então o nome global é formado pelo nome global do componente pai + "." + nome do componente. Ex: ADS, ADS.COMPONENTES, ADS.COMPONENTES.NOME_GLOBAL
Texto com a descrição da entidade como deve aparecer na lista.
Tipo de entidade. Persistent (tabela), View ou Behavior (apenas um comportamento a ser anexado a outra entidade)
  • Behavior - A entidade representa a penas um comportamento comum implementado em outras entidades
  • Persistent - A entidade será persistida em uma tabela.
  • View - A entidade é resultado de uma visão na base de dados.
Este campo é um container para a apresentação de pendências e erros da entidade.
Descrição resumida do que a entidade representa.
Número de registros estimados. Número utilizado para algumas tomadas de decisão. Ex: 10, 500, 1000000, etc.
Domínio genérico para tratamento de atributos contendo textos longos e com quebras de linha. A entrada de dados é feita através de um campo multi-linhas com largura e altura variáveis (padrão de 100 caracteres por linha e 6 linhas).
Na apresentação, este domínio desconsidera quaisquer tags HTML que estiverem nele, ou seja, mostra as tags e não formata de acordo com elas.

Propriedades (format)

pop-editor

Define se a forma de edição será em um dropbox
Padrão: no

pop-editor-width

Define a largura para o campo de edição do valor, o valor passado é no formato css
Padrão: 60em

pop-editor-height

Define a altura para o campo de edição do valor, o valor passado é no formato css
Padrão: 6em
Campo para apresentar o comportamento da entidade.
Recebe o valor "S" ou "N". Na interface é representado por um check-box que quando selecionado representa o valor "S".
Nas telas de query, a interface utiliza uma pop-list com as opções "Sim", "Não" e em branco (nulo).

Nas opções de formato, aceita;
  • label-suffix: Quando informado "labe-suffix:true", o label aparece no lugar do sufixo, ou seja, após o check-box. Por padrão, o label aparece sempre à esquerda do check-box.

Operações

Topo

Pesquisa

Permite restringir o conjunto de registros a serem listados informando filtros para determinados campos.
Obtenha maiores detalhes em Como utilizar a tela de pesquisa?.
Topo

Listagem

Apresenta uma lista com os registros que atendem os filtros informados. Clique no registro para selecioná-lo. Caso o registro desejado seja o primeiro (ou único), é possível selecioná-lo pressionando a tecla ENTER.
Behavior
Persistent
View
Behavior
Topo

Consulta (VIEW)

Tela que apresenta os dados de um registro específico apenas para consulta.
Behavior
Topo

Alteração

Tela que permite a alteração de um registro.
Topo

Inclusão

Permite criar novos registros no sistema. Informe os campos e pressione em Salvar.
Topo

Exclusão

A exclusão do registro pode ser disparada a partir da tela de consulta e/ou de manutenção do mesmo.
O registro somente será excluído se todas as condições necessárias forem encontradas, gerando um erro, caso alguma destas condições não estiver sendo atendida.
Topo

Pesquisa simples (SEARCH)

Campos utilizados para pesquisa genérica
Topo

Relatórios de entidades

Saída resultante normalmente como um arquivo PDF contendo a lista dos registros selecionados através da tela de query.
Behavior

Dúvidas frequentes

  • Criação automática de interfaces não gera quando já existe interface
  • Como criar atributos de forma "rápida" durante a criação de uma entidade?
  • Como nomear as entidades?
  • Como criar uma entidade que é uma VIEW no banco de dados?

    • Veja também