Telescope (core)

Índice

Itens

ADS.CAD_BLOCK_ITEMS

Descrição

Permite manter os itens de um bloco de interface. Tanto itens unbounds como itens vinculados a atributos (binding) são editados mas somente itens unbounds podem ser criados. Itens bound podem ser execluídos mas não podem ser criados.

Esta interface tem os seguintes objetivos:

A tela de LIST apresenta os campos na mesma ordem que é gerada a documentação e possui algumas características:

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

Behaviors:

Itens de um bloco:

Módulo de Interfaces:

Campos:

Título (label) do item. Caso não informado, as interfaces utilizarão o título definido no atributo. Para omitir um título para o item, basta incluir um espaço (em branco).
Label que será utilizado pelo bloco. Caso o label não tenha sido explicitamente informado para o item, apresenta o do elemento ao qual está ligado (atributo).
Quando o item estiver ligado a um atributo de uma entidade, indica o Label definido para o mesmo. Nos demais tipos de itens (SQL ou UNBOUND), este campo não é apresentado.
Nome físico do item. Deve-se seguir as seguintes regras:
  • Para itens da entidade base, o nome DEVE ser exatamente igual ao nome do atributo.
  • Itens que não pertencem à entidade base NÃO podem usar o nome de algum atributo da entidade base.
  • Todos os demais itens devem ter um nome significativo e contextualizado.
  • Itens LOOKUP devem ter um nome contextualizado. Por exemplo: Um item "NOME_COMPLETO" de uma lookup que aponta para a entidade "PESSOAS" usando um contexto de "CLIENTE", deveria ser chamado de "NOME_COMPLETO_CLIENTE".
  • Evite usar os nomes gerados automaticamente tipo LKP6_NOME_COMPLETO - Isso tira a clareza do código (o que é LKP6?).
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
Descrição do item do bloco. Na lista, a descrição é apresentada juntamento com o label do campo e já é apresentada considerando a herança das informações do respectivo atributo quando necessário.
Na lista, apresenta a descrição adotada para o item (que pode ser tanto a descrição específica como a descrição do respectivo atributo).
Descrição registrada no atributo que está ligado a este item. Utilizado para auxiliar o desenvolvedor na descrição do item.
Quando o item for lookup, apresenta o nome global do atributo que determina a FK desta lookup. Esta informação pode ser utilizada em alguns casos como referência para descrever o item:
[i:NOME-GLOBAL]
Tipo de item - Pode ser ITEM (bind), UNBOUND ou SQLEXPR.
Na lista, agrega a informação do binding (quando for o ITEM). Utiliza a convenção de cores para os bindings e inclui links para a entidade e atributo ao qual o item está ligado. Isso permite que o desenvolvedor:
  • Reconheça a ligação do item com as entidades.
  • Navegue para a respectiva entidade e/ou atributo.
Expressão ou comando para busca e obtenção do dado externo. Pode um comando SQL ou outra forma de busca do dado.
Esta campo somente é apresentado se o tipo de item for SQLEXPR.
O SQL informado deve estar relacionado com os bindings do bloco, ou seja, o ID da entidade base pode ser referenciado por BASE.ID
Este SQL também aceita algumas macros, tais como:
  • [nome-parametro] - Nome simples do parâmetro. Não usar nome global.
  • [SYSDATE], [SYSDATE-1], etc.
  • [nome-global-variavel-de-sessao]
  • [nome-global-preferencia]
Indica o domínio do item. Este campo é apresentado apenas para itens do tipo UNBOUND ou SQLEXPR).
Permite informar uma LOV, domínio ou função para o item:
  • LOV: Interface utilizada para escolher um valor e que opcionalmente possibilita cadastrar um novo valor.
  • Domínio: Domínio a ser utilizado para o campo. Obrigatório para itens SQL ou Unbounds. Para o caso de itens ligados a um atributo da entidade deve ser informado apenas se for desejado usar um domínio diferente do que está definido no atributo da entidade.
  • Função: Utilizado apenas em campos unbounds. Permite informar uma função da entidade-base que retorna o valor a ser apresentado em campos unbound.
Valor default para o item.
Parâmetros de formatação do item. Ver documentação no respectivo domínio.
Define o tamanho máximo do campo
Largura do item em número de caracteres.
Altura do item. Para textos, corresponde ao número de linhas. Para números, corresponde ao número de casas decimais.
Sequencia que determina a ordem com que os items são apresentados para o usuário.
Apresenta as funções onde o item participa.

Operações

Topo

Pesquisar

Ao pesquisar, o usuário poderá informar critérios de filtro para listar apenas os registros desejados. Normalmente depois de informar os filtros desejados, o usuário deverá executar a operação "Listar".
Obtenha maiores detalhes em Como utilizar a tela de pesquisa?.
Topo

Listar

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

Novo

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

Alterar

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

Excluir

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

Alterar

Permite editar os nomes dos itens, labels, descrição e sequencia de todos os itens em uma única tela.
Topo

Pesquisa simples (SEARCH)

Campos utilizados para pesquisa genérica
Topo

Documentar

Operação destinada a editar a documentação dos itens da interface.
Permite alterar todos os labels e descrições em uma única tela.

Dúvidas frequentes

  • Como nomear os itens unbounds de um bloco?
  • Como nomear os itens de um bloco?