Manutenção de Ligações
Objetivo | Permitir a adição ou modificação de uma ligação para um objeto dinâmico. |
Programa | SO9000 |
Pré-Requisito | É pré-requisito para a execução dessa função: |
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 Sintaxe | Quando acionado, verifica se a sintaxe da codificação da Ligação está correta. |
Preview | Executa 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 relacionamento | Altera 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 que | Pergunta 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. |
Ou | Insere 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. |
Lista | Abre 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) |
Faixa | Abre 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 Informados | Quando 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 valor | Inclui o valor digitado na lista de possíveis valores. |
Modifica valor | Substitui o valor selecionado pelo valor digitado, conforme registro posicionado no browse. |
Exclui valor | Exclui 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. |
Valor | Exibe 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ção | Exibe 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 |
Confirma | Fecha 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). |
Atributo | Exibe o nome do atributo da tabela de extensão. |
Atributo Relac | Exibe 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.