Feedback

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.

Criando uma nova subconsulta

Adicionando uma nova subconsulta

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

Adicionando uma nova subconsulta

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

Tela com a lista de aplicações disponíveis para ligação de ediçã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

Campo pesquisa para buscar a aplicação pelo seu nome

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

Botões de Agrupamento

botões para agrupamento das aplicações

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

Exemplo da lista de 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

Exemplo da lista de 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

Exemplo da lista de 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

Tela de 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:

Parâmetro

Coluna parâmetro da configuração dos parâmetros da ligação

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

Tipo

Conluna tipo do parâmetro

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

Coluna valor que lista os valores que devem ser passados como parâmetro

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

Botão Refresh, usado para recarregar a lista de parâmetros

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

Configuração do SQL da Consulta que será usada como subconsulta através de ligação.