Árvore de páginas

Manutenção de Ligações

Objetivo

Permitir a adição ou modificação de uma ligação para um objeto dinâmico.

ProgramaSO9000
Pré-Requisito

É pré-requisito para a execução dessa função:
Função Ligação (SO0708)

Visão Geral

Por intermédio dessa função é possível adicionar ou modificar uma ligação para um objeto dinâmico previamente selecionado.

A ligação deve ser utilizada para permitir ao SOP se referenciar a atributos de outras tabelas de qualquer banco de dados.

A referência a esses atributos é efetuada por intermédio do relacionamento da tabela do programa (chamada de tabela externa) com a(s) tabela(s) selecionada(s) pelo usuário administrador.

Descrição

Janela Criação de Ligações – Atributo Consulta

Essa tela é utilizada para criar e modificar Ligações. Ela é apresentada pela Janela Zoom Ligações (veja a descrição da Função Ligação), quando o objeto para o qual está sendo criada a Ligação for do tipo Atributo Consulta.

Nas tabelas a seguir estão descritos os elementos desta janela:

Nome Botão

Descrição

Salva a Ligação

Quando acionado, salva as alterações e retorna para a janela Zoom Ligações.

Cancela as alterações

Quando acionado, cancela as alterações ou a criação da Ligação e retorna para a janela Zoom Ligações.

Verifica SintaxeQuando acionado, verifica se a sintaxe da codificação da Ligação está correta.
PreviewExecuta uma demonstração da Ligação montada para que se  possa testar sua execução.
Ajuda

Apresenta o Manual On-line do Screen Optimizer.

Adiciona tabela

Adiciona a tabela selecionada (lista da esquerda) na lista de tabelas da Ligação (lista da direita).

Importante 1:

A lista de tabelas da ligação já inicia (obrigatoriamente) com a tabela externa incluída.

Importante 2:

Quando adicionada uma tabela, o SOP verifica se a tabela selecionada possui relacionamento com alguma das tabelas já selecionadas (através dos índices existentes). Caso seja identificado o relacionamento, é criado <Tabela1> OF <Tabela2>. Senão, é criada <Tabela1> WHERE <Tabela2> (nesse último caso, o relacionamento deve ser informado na página “Relacionamento”).

Remove tabela

Remove a tabela selecionada da lista de tabelas da Ligação (lista da direita).

Importante :

A lista de tabelas da ligação já inicia (obrigatoriamente) com a tabela externa incluída.

Altera relacionamentoAltera com qual tabela, a tabela selecionada possui relacionamento.

Campo

Descrição

Ligação

Permite informar o nome desejado para a Ligação, acompanhado de uma breve descrição.

Banco Dados

Permite selecionar o Banco de Dados que contém a tabela a ser relacionada.

Código (parte inferior)

Exibe o código PROGRESS (4GL) da Ligação.


Janela Criação de Ligações – Atributo Consulta – Pasta Relacionamento

Esta pasta permite efetuar a codificação (quando necessária) para criar os relacionamentos entre as tabelas escolhidas para a Ligação na pasta Tabela.

Nas tabelas a seguir estão descritos os elementos desta janela:

Nome Botão

Descrição

Igual

Insere o sinal “=” (igual) no código do relacionamento.

Diferente

Insere o sinal “<>” (diferente) no código do relacionamento.

Menor que

Insere o sinal “<” (menor que) no código do relacionamento.
Maior que
Insere o sinal “>” (maior que) no código do relacionamento.
Menor ou igual

Insere o sinal “<=” (menor ou igual) no código do relacionamento.

Maior ou igual

Insere o sinal “>=” (maior ou igual) no código do relacionamento.

E

Insere a cláusula “AND” (e) no código do relacionamento.
Ou
Insere a cláusula “OR” (ou) no código do relacionamento.

Campo

Descrição

Customiza

Habilita/desabilita a customização do relacionamento. Nos casos em que o SOP identificou automaticamente o relacionamento entre as tabelas (<Tabela1> OF <Tabela2>), é possível eliminar o relacionamento automático para informar um relacionamento manualmente.

Relac

Permite selecionar o relacionamento a ser modificado.

Lista de Campos (Direita)

À direita estão os atributos da tabela do relacionamento selecionado. Para informar um atributo no código da ligação, basta efetuar duplo clique com o mouse sobre o atributo desejado. Dessa forma, o atributo é adicionado na codificação do relacionamento, logo abaixo da página.

Lista de Campos (Esquerda)

À esquerda estão os atributos da tabela do relacionamento selecionado (tabela 2). Para informar um atributo no código da ligação, basta efetuar duplo clique com o mouse sobre o atributo desejado. Dessa forma, o atributo é adicionado na codificação do relacionamento, logo abaixo da página.

Ligação (parte inferior)

Exibe o código PROGRESS (4GL) do relacionamento. O editor que visualiza a ligação é configurável. Dessa forma, é possível alterar a codificação manualmente ou por intermédio da seleção dos atributos que compõem o relacionamento.

Janela Criação de Ligações – Atributo Consulta – Pasta Filtro

Esta pasta permite efetuar a codificação para criar filtros de registros para as tabelas retornadas pela ligação, ou seja, as tabelas que foram escolhidas na Pasta Tabela.

Campo

Descrição

Tabela

Permite que o usuário escolha a tabela onde se deseja filtrar seus atributos. Não é permitido selecionar a tabela externa para efetuar uma filtragem.

Atributos

Exibe os campos (atributos) que podem ser selecionados para criar um filtro. O atributo deve ser selecionado e após isso, o botão, conforme a necessidade (=, <>, >, <, <=, >=, AND, OR, etc.)

Filtro

Exibe o código PROGRESS (4GL) do filtro de todos os atributos da tabela selecionada. O editor é configurável, permitindo que a filtragem seja feita manualmente.

Nome Botão

Descrição

Igual

Pergunta o valor constante ao qual o campo deve ser igual.

Diferente

Pergunta o valor constante ao qual o campo deve ser diferente.

Menor que

Pergunta o valor constante ao qual o campo deve ser menor.
Maior quePergunta o valor constante ao qual o campo deve ser maior.
Menor ou igual

Pergunta o valor constante ao qual o campo deve ser menor ou igual.

Maior ou igual

Pergunta o valor constante ao qual o campo deve ser maior ou igual.

E

Insere a cláusula “AND” (e) no código do filtro.
OuInsere a cláusula “OR” (ou) no código do filtro.
Inicia com...

Pergunta o valor com o qual o campo deve começar.


Importante :

Essa funcionalidade se aplica apenas a campos do tipo caracter.


Contém...

Pergunta o valor que o campo deve conter.


Importante :

Essa funcionalidade se aplica apenas a campos do tipo caracter.


ListaAbre a janela Lista Valor Constante onde é possível informar os possíveis valores para determinado campo (ou seja, serão criadas várias ocorrências com a cláusula OR)
FaixaAbre a janela Faixa Constante onde é possível informar uma faixa de valores possíveis para determinado campo.


Janela Criação de Ligações – Atributo Consulta – Janela Valor Constante

Esta tela tem a finalidade de solicitar o valor constante de uma condição que deve ser satisfeita pelo atributo.

A janela é executada pelos botões “Igual”, “Diferente”,”Menor que”,”Maior que”, “Menor ou igual”, “Maior ou igual” , “Inicia com...” e “Contém...” da página Filtro.


Nas tabelas a seguir estão descritos os elementos desta janela:

Nome Botão

Descrição

Confirma o valor informado

Confirma o valor digitado.

Cancela

Cancela a criação do filtro.

Campo

Descrição

Informe o valor

Neste campo deve ser marcadoum dos valores constante para o filtro que está sendo criado, que pode ser SIM (Verdadeiro) ou Não (Falso).


Janela Criação de Ligações – Atributo Consulta – Janela Faixa Constante

Esta tela é chamada pelo botão “Faixa” da pasta “Filtro” e tem a finalidade de solicitar uma faixa constante que deve ser satisfeita pelo atributo.

Nas tabelas a seguir estão descritos os elementos desta janela:

Nome Botão

Descrição

Confirma a faixa informado

Confirma a faixa informada.

Cancela

Cancela a criação do filtro.

Campo

Descrição

Informe Faixa

Na parte superior deverá ser informado o valor inicial da faixa e na parte inferior o valor final da faixa.
Considera Valores InformadosQuando marcado, faz com que os valores informados sejam considerados como valores dentro da faixa. Quando desmarcado os valores informados nesta janela são atribuídos como limite inicial e final da faixa e não pertencem a ela.


Janela Criação de Ligações – Atributo Consulta – Janela Lista Valor Constante

Esta tela é chamada pelo botão “Lista” da página “Filtro” e tem a utilidade de perguntar a lista de valores que deve ser satisfeita pelo atributo.


Nas tabelas a seguir estão descritos os elementos desta janela:

Nome Botão

Descrição

Confirma a lista informada

Confirma a lista informada.

Cancela

Cancela a criação da lista.

Inclui valorInclui o valor digitado na lista de possíveis valores.
Modifica valorSubstitui o valor selecionado pelo valor digitado, conforme registro posicionado no browse.
Exclui valorExclui o valor selecionado da lista de valores.

Campo

Descrição

Tipo

Determina se o valor do atributo deverá ser igual (=) ou diferente (<>) do valor informado na lista de valores.

Informe o valor

Campo utilizado para informar um valor possível para a lista de possíveis valores.
ValorExibe a lista de valores possíveis para determinado atributo, permitindo que sejam selecionados valores para a modificação ou exclusão.


Janela Criação de Ligações – Atributo Consulta – Pasta Opções

Esta pasta permite alterações na estrutura da Ligação.

Nas tabelas a seguir estão descritos os elementos desta janela:

Nome Botão

Descrição

Confirma

Confirma as alterações na estrutura da Ligação.

Cancela

Cancela as alterações na estrutura da Ligação.

Campo

Descrição

Tabela

Exibe as tabelas que fazem parte da Ligação.

Acesso

Exibe a forma de acesso utilizada pela tabela na Ligação.
Lista
Exibe a forma de busca dos registros.
LigaçãoExibe a forma de ligação empregada.
Retorno

Demonstra quais atributos serão retornados pela ligação.

Relac

Exibe o relacionamento da tabela selecionada no browse.

Tipo Acesso

Define a forma de travamento de registros da tabela selecionada no browse. Pode ser:

NO-LOCK

SHARED-LOCK

EXCLUSIVE-LOCK

No caso de atributos de consulta, só é permitida a opção NO-LOCK (sem travamento)

Lista

(parte inferior)

Permite alterar a forma de busca dos registros. A busca pode ser:

FIRST – primeiro registro retornado da ligação

EACH – todos os registros da ligação

LAST – último registro retornado da ligação

Ligação

(parte inferior)

Permite selecionar a forma  de ligação empregada. A forma de ligação  pode ser: INNER JOIN - retornará apenas os registros onde há relacionamento

OUTER JOIN - retornara todos os registros, mesmo não havendo relacionamento

Exemplo: Ligação dos pedidos do cliente. Se a ligação for do tipo INNER JOIN, só retornará os clientes que possuem pedidos, inclusive os pedidos. Em uma ligação OUTER JOIN, retornará inclusive os clientes que não possuem nenhum pedido.

Retorna Campos

Define para a tabela selecionada quais os atributos que irão retornar na ligação. Pode ser:

Todos os Atributos – retornará todos os atributos das tabelas selecionadas

Apenas os informados – retornará apenas os atributos informados na página “atributos”.


Janela Criação de Ligações – Atributo Consulta – Pasta Atributo

Esta pasta permite selecionar e reorganizar os atributos das tabelas da Ligação que serão utilizados.


Nas tabelas a seguir estão descritos os elementos desta janela:

Nome Botão

Descrição

Novo

Inclui ou modificar atributos na lista de atributos utilizados (que poderão ser usados em objetos dinâmicos).

Excluir

Exclui determinado atributo da lista de atributos utilizados.

Mover para cima

Move o atributo selecionado uma posição acima na lista.

Mover para baixo

Move o atributo selecionado uma posição para baixo na lista.

Campo

Descrição

Atributo

Exibe os atributos utilizados no formato banco.tabela.atributo.


Janela Criação de Ligações – Atributo Consulta – Atributos Query

Esta tela permite selecionar os atributos das tabelas da Ligação que serão utilizados. É possível visualizar separadamente todas as tabelas da Ligação e seus atributos.

Nas tabelas a seguir estão descritos os elementos desta janela:

Nome Botão

Descrição

Confirma

Confirma a escolha da lista de atributos utilizados.

Cancela

Cancela a escolha da lista de atributos utilizados.

Incluir

Inclui o atributo selecionado  na lista de atributos utilizados (que poderão ser usados em objetos dinâmicos).

Excluir

Exclui determinado atributo da lista de atributos utilizados.

Mover para cima

Move o atributo selecionado uma posição acima na lista.

Mover para baixo

Move o atributo selecionado uma posição para baixo na lista.

Campo

Descrição

Tabela

Permite selecionar a tabela da Ligação para a qual se deseja incluir atributos na lista de atributos utilizados.

Atributos Disponíveis

Exibe a lista de atributos disponíveis para serem utilizados.

Atributos Selecionados

Exibe a lista de atributos que foram escolhidos para serem utilizados pela Ligação.

Rótulo

Exibe o rótulo do atributo selecionado na lista da direita.

Tipo Dado

Exibe o tipo de dado do atributo selecionado na lista da direita.

Formato

Exibe o formato do atributo selecionado na lista da direita.

Largura

Exibe a largura do atributo selecionado na lista da direita

Ajuda

Exibe a ajuda do atributo selecionado na lista da direita.


Janela Criação de Ligações – Atributo Consulta – Preview

Esta tela monta dinamicamente um browse com os atributos da Ligação para que se possa testar o funcionamento da mesma.


Na tabela a seguir estão descritos os elementos desta janela:

Nome Botão

Descrição

ConfirmaFecha a janela de Preview.


Janela Criação de Ligações – Tabela Extensão – Relacionamento

Quando é criada ou editada uma Ligação para tabela de extensão,  a pasta de relacionamento funciona de uma forma diferente, permitindo trabalhar apenas com igualdade de campos.

Nas tabelas a seguir estão descritos os elementos desta janela:

Nome Botão

Descrição

Salva a Ligação

Cria a relação de igualdade dos atributos de tabelas diferentes selecionados na lista da esquerda e da direita.

Cancela as alterações

Exclui a relação selecionada no browse da parte inferior da página.

Campo

Descrição

Relac

Permite escolher qual relacionamento (entre as tabelas da Ligação) que se deseja criar ou modificar relações de igualdade dos atributos.

Lista Atributos (Esquerda)

Exibe a lista de atributos da tabela do relacionamento selecionado.

Lista Atributos  (Direita)

Exibe a lista de atributos da tabela do relacionamento selecionado (tabela 2).
AtributoExibe o nome do atributo da tabela de extensão.
Atributo RelacExibe o nome do atributo da tabela principal (externa).

Importante 1:

O funcionamento da janela de criação de Ligações é semelhante tanto para Ligações do tipo Consulta Atributo como para Ligações do tipo Tabela Extensão. No último caso, a pasta de Filtro fica desabilitada e a pasta de Relacionamento é alterada para que o relacionamento seja armazenado campo a campo.

Importante 2:

Para ligações do tipo Tabela Extensão o relacionamento entre a tabela externa e a tabela selecionada deve ser obrigatoriamente de um para um. Além disso, para ligações desse tipo só poderá ser selecionada uma única tabela, além da tabela externa que já vem previamente selecionada. Esses passos são necessários para garantir o sincronismo de inclusão e modificação de registros na tabela específica no ambiente de aplicação.