Ligação de Captura

Criando uma Ligação de Captura.

A ligação de captura é utilizada recuperar um valor de uma Consulta para um campo do Formulário.

Nas opções dos tipos de ligação, iremos escolher a Ligação de Captura. Após selecionar essa opção, devemos também escolher qual o campo que queremos para recuperar o valor.

Lista de Aplicações

Após selecionar essa opção, será exibido a lista de aplicações para qual você deseja criar o link.

Essa tela pode ser visualizada das seguintes formas:

Localizando Aplicações

Para auxiliar na localização da aplicação é possível utilizar os botões de agrupamento ou o campo Procurar.

Campo de pesquisa

A pesquisa é realizada pelo nome da aplicação.

Botões de Agrupamento

Neste agrupamento são três opções de visualização:

Todas

Lista todas as aplicações do projeto em ordem alfabética a-z.

Exemplo das aplicações sem agrupamento

Por Pasta

Lista as aplicações agrupadas por sua pasta, de acordo com a organização das aplicações no Projeto Explorer.

Exemplo das aplicações agrupadas Por Pasta

• Item 1 - Lista de pastas criadas no Projeto Explorer. Selecione a pasta e todas as aplicações da pasta serão exibidas no item 2.
• Item 2 - Lista das aplicações da pasta selecionada no Item 1.

Por Tipo

Lista as aplicações agrupadas por seu respectivo tipo.

Exemplo das aplicações agrupadas Por Tipo

Item 1 - Tipos de aplicações existentes no Scriptcase. Selecione o tipo de aplicação que você deseja listar, as aplicações correspondentes ao tipo selecionado serão listadas no item 2. Item 2 - Lista das aplicações referentes ao tipo selecionado no item 1.

Ao selecionar a aplicação de destino clique em Prosseguir ».

Definição dos Parâmetros

Nesta etapa o desenvolvedor deve informar os valores que serão passados aos parâmetros da aplicação de destino.

Estes parâmetros podem ser:

• Variáveis Globais - Que podem ser definidas nos eventos ou no SQL da aplicação de destino.
• Chave Primária - Para ligações criadas com aplicações dos tipos: Formulário e Calendário.

Para o funcionamento correto da Ligação de Edição é necessário que o campo chave primaria do formulário receba um valor, que pode ser definido por uma variável global, por um campo da consulta ou utilizando a opção Valor Fixo.

Parâmetro

Lista todos os parâmetros definidos na aplicação de destino.

Tipo

Define o tipo de origem do valor que será enviado para o parâmetro definido na aplicação de destino.

A opções são:

• Campos - Utiliza o valor de um campo da aplicação de origem como parâmetro.
• Variável global - Utiliza o valor de uma variável global, definida na aplicação de origem, como parâmetro. Esta opção será listada apenas se uma variável global for definida em um evento na aplicação de origem.
• Valor fixo - Utiliza um valor fixo, definido na coluna valor, como parâmetro. Nesta opção apenas valores alfanuméricos são permitidos.
• Sem Valor - Utilizando esta opção nenhum valor é passado. Ao utilizar esta opção como parâmetro para uma chave primária, a aplicação de destino será exibida em modo de inclusão.

Valor

Define o valor que será enviado como parâmetro. As opções desta coluna são alteradas de acordo com o Tipo selecionado.

• Ao selecionar Campo - A coluna valor irá listar todos os campos da aplicação de origem, que iram enviar o valor.
• Ao selecionar Variável - Serão listadas todas as variáveis globais definidas na aplicação de origem.
• Ao selecionar Valor Fixo - Será exibido um campo para que o valor seja informado. Não é permitida a utilização de variáveis nesta opção e devemos utilizar apenas valores alfanuméricos.
• Ao selecionar Sem Valor - Neste caso nenhum valor será enviado ao parâmetro.

Botão Refresh

Este botão possibilita a recarga ajax da lista dos parâmetros, desta forma é possível alterar ou adicionar um parâmetro na aplicação de destino sem a necessidade de reiniciar a criação da ligação em curso.

Aplicação sem parâmetro

Entretanto, quando a aplicação de destino não possuí parâmetros definidos, é mostrada a seguinte tela:

![Sem parametro][semparametro]

Clicando no botão, você será levado para a aplicação de destino para criar algum parâmetro, então podera utilizar o botão de atualização na definição de parâmetros para recarregá-los

Propriedades da Ligação

Nessa tela iremos configurar o modo de exibição da aplicação que será chamada na ligação.

Nessa ligação há apenas uma opção de exibição:

Modal:

Utilizando essa opção a aplicação de destino será mostrada na mesma tela da nossa aplicação, porém ela será mostrada em uma pequena janela por cima da aplicação atual.

Modal

Utilizando essa opção a aplicação de destino será mostrada na mesma tela da nossa aplicação, porém ela será mostrada em uma pequena janela por cima da aplicação atual..

Quando selecionamos essa opção, podemos configurar as seguintes opções:

Modal:

Nessa opção iremos definir se a próxima aplicação será aberta em um Modal.

Sim: Essa opção irá fazer com que a próxima aplicação seja aberta em um modal.
Não: Essa opção irá fazer com que a próxima aplicação seja aberta em uma nova janela.

Caso seja selecionado Sim na opção anterior, será habilitado as opções de Altura e Largura do Modal.

Altura:

Permite que a altura do Modal seja configurada.

Largura:

Permite que a largura do Modal seja configurada.

Caso seja selecionado Não na opção anterior, somente essas opções estarão disponíveis.

Permite modificar manualmente na atualização:

Quando selecionamos a opção Sim, é criado um botão Novo na consulta para a inserção de novos registros.

Permite modificar manualmente na inclusão:

Indica qual a tecla de atalho para o botão adicionar Novo Registro.

Permite modificar automaticamente na atualização:

URL de saida do formulário chamado. Caso não seja definido nenhum valor, o endereço de retorno (botão voltar) será a própria consulta.

Permite modificar automaticamente na inclusão:

Escolhendo a opção Sim, após realizar a atualização de um registro a janela será fechada.