Nova Ligação

Para criar uma nova ligação com uma subconsulta clique sobre o item Nova Ligação na pasta Ligações dentro de Subconsultas.

Adicionando uma nova subconsulta

Informe o nome e o label para a ligação que será criada.

• Nome - Define o nome da subconsulta. O campo nome permite apenas números, letras sem acentuação e underscore.
• Label - Define o texto de exibição da coluna da subconsulta.
• Subconsulta Avançada - Define a utilização do iframe para abertura da subconsulta, permitindo utilizar vários recursos da consulta

O atributo Label não possui restrição de caractere e permite a utiliação de lang.

Lista de aplicações

Todas as aplicações do projeto disponíveis para a ligação serão listadas. Nesta etapa o desenvolvedor deve selecionar a aplicação de destino que será utilizada na ligação.

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

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

Para exibir apenas registros que atendam uma condição específica é necessária a definição de parâmetros, para isso, a aplicação de consulta deve ter configurada em seu SQL uma cláusula WHERE com variável global.

Exemplo de defininção do WHERE na Grid