Ligação de Edição
View video
View video
Criando uma Ligação de Aplicação.
Esse tipo de ligação permite que seja criado um link a partir de uma Consulta para um Formulário, com o intuito de editar os registros da linha da consulta.
Nas opções dos tipos de ligação, iremos escolher a Ligação de Edição. Escolhendo essa opção será possível editar um registro na Consulta.
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 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.
Propriedades da Ligação
Nessa tela iremos configurar o modo de exibição da aplicação que será chamada na ligação.
Há cinco opções de exibição, são elas:
Abrir na mesma janela:
Utilizando essa opção a aplicação de destino será mostrada na mesma janela da nossa aplicação, e na aplicação de destino haverá um botão voltar para que possamos retornar a aplicação anterior.
Abrir em outra janela:
Utilizando essa opção a aplicação de destino será mostrada em outra janela do navegador, e na aplicação de destino haverá um botão sair para que possamos fechar essa janela.
Abrir em um iframe:
Utilizando essa opção a aplicação de destino será mostrada na mesma tela da nossa aplicação, porém ela será mostrada em um iframe em uma das quatro opções disponíveis na configuração do iframe.
Abrir no parent:
Utilizando essa opção a aplicação de destino será mostrada na mesma janela da nossa aplicação, e na aplicação de destino haverá um botão voltar para que possamos retornar a aplicação anterior.
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.
Abrir na mesma janela.
Utilizando essa opção a aplicação de destino será mostrada na mesma tela da nossa aplicação, e na aplicação de destino haverá um botão voltar para que possamos retornar a aplicação anterior.
Quando selecionamos essa opção, podemos configurar as seguintes opções:
URL de saída da aplicação chamada:
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.
Exibir o Botão Novo na Consulta :
Quando selecionamos a opção Sim, é criado um botão Novo na consulta para a inserção de novos registros.
Também ao selecionar a opção Sim, é mostrado duas novas opções Lable para o botão Novo e Hint para o botão Novo:
Label para o botão Novo:
Nessa opção iremos informar um nome para o botão que será mostrado na Consulta.
Hint para o botão Novo:
Nessa opção iremos informar uma mensagem que será mostrada quando o cursor do mouse estiver sobre o botão Novo.
Tecla de Atalho para o Botão Novo:
Indica qual a tecla de atalho para o botão adicionar Novo Registro.
Abrir em outra janela.
Utilizando essa opção a aplicação de destino será mostrada em outra janela do navegador.
Quando selecionamos essa opção, podemos configurar as seguintes opções:
URL de saída da aplicação chamada:
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.
Fecha o formulário após uma atualização:
Escolhendo a opção Sim, após realizar a atualização de um registro a janela será fechada.
Fecha o formulário após inserção:
Escolhendo a opção Sim, após realizar a inserção de um registro a janela será fechada.
Abrir a aplicação em aba dentro do menu:
Escolhendo a opção Sim, a aplicação será aberta em uma aba do menu quando executada apartir de um ao invés de ser aberto em outra janela do navegador.
Exibir o Botão Novo na Consulta :
Quando selecionamos a opção Sim, é criado um botão Novo na consulta para a inserção de novos registros.
Tecla de Atalho para o Botão Novo:
Indica qual a tecla de atalho para o botão adicionar Novo Registro. Também ao selecionar a opção Sim, em Exibir o Botão Novo na Consulta é mostrado duas novas opções:
Label para o botão Novo:
Nessa opção iremos informar um nome para o botão que será mostrado na Consulta.
Hint para o botão Novo:
Nessa opção iremos informar uma mensagem que será mostrada quando o cursor do mouse estiver sobre o botão Novo.
Abrir em um iframe.
Utilizando essa opção a aplicação de destino será mostrada na mesma tela da nossa aplicação, e na aplicação de destino haverá um botão voltar para que possamos retornar a aplicação anterior.
Quando selecionamos essa opção, podemos configurar as seguintes opções:
Tecla de Atalho para o Botão Novo:
Indica qual a tecla de atalho para o botão adicionar Novo Registro.
URL de saída da aplicação chamada:
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.
Propriedades do Iframe
Nesse conjunto de configurações, podemos definir algums detalhes do iframe que irá mostrar a aplicação de destino.
Exibir o cabeçalho da aplicação chamada:
Escolhendo a opção Sim, o cabeçalho da aplicação de destino também será mostrada no iframe.
Posição do iframe em relação à aplicação principal:
Nessa opção, iremos definir em que posição em relação a nossa aplicação o iframe será exibido, há quatro opções:
Abaixo: O iframe será exibido abaixo da aplicação principal.
Acima: O iframe será exibido acima da aplicação principal.
Direita: O iframe será exibido ao lado direito da aplicação principal.
Esquerda: O iframe será exibido ao lado esquerdo da aplicação principal.
Ação após um insert:
Nessa opção, iremos definir o que ocorrerá após a inserção de um registro, há duas opções:
Recarregar a grid: A página atual será recarregada após a inserção.
Mover para o final da consulta: Após a inserção será mostrado a última página da consulta com o último registro inserido.
Altura do iframe:
Permite que a altura do iframe seja configurada.
Largura do iframe:
Permite que a largura do iframe seja configurada.
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:
Altura:
Permite que a altura do Modal seja configurada.
Largura:
Permite que a largura do Modal seja configurada.
URL de saída da aplicação chamada:
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.
Fecha o formulário após uma atualização:
Escolhendo a opção Sim, após realizar a atualização de um registro a janela será fechada.
Fecha o formulário após inserção:
Escolhendo a opção Sim, após realizar a inserção de um registro a janela será fechada.
Exibir o Botão Novo na Consulta :
Quando selecionamos a opção Sim, é criado um botão Novo na consulta para a inserção de novos registros.
Tecla de Atalho para o Botão Novo:
Indica qual a tecla de atalho para o botão adicionar Novo Registro.
Também ao selecionar a opção Sim, em Exibir o Botão Novo na Consulta é mostrado duas novas opções:
Label para o botão Novo:
Nessa opção iremos informar um nome para o botão que será mostrado na Consulta.
Hint para o botão Novo:
Nessa opção iremos informar uma mensagem que será mostrada quando o cursor do mouse estiver sobre o botão Novo.
Propriedades do Formulário
Nesse conjunto de configurações, podemos definir quais os botões estarão disponíveis na aplicação de formulário de destino. Possuímos inicialmente cinco opções, que são elas:
Habilitar botão de Insert:
Nessa opção podemos definir se o botão de Inserir estará disponível na aplicação de destino.
Habilitar botão de Update:
Nessa opção podemos definir se o botão de Atualizar estará disponível na aplicação de destino.
Habilitar botão de Delete:
Nessa opção podemos definir se o boão de Excluir estará disponível na aplicação de destino.
Habilitar botões de Navegação:
Nessa opção podemos definir se o botão de primeiro, anterior, próximo e último estarão disponível na aplicação de destino.
Habilitar botão para edição do registro na consulta:
Nessa opção podemos definir se o botão de edição de registros que é o lápis na consulta estará disponível.
Propriedades do Formulário
Nesse conjunto de configurações, podemos definir quais os botões estarão disponíveis na aplicação de formulário de destino. Possuímos inicialmente cinco opções, que são elas:
Redirecionar após inclusão:
Nessa opção podemos definir o que ocorrerá com a aplicação após a inclusão do registro.
Redirecionar após atualização:
Nessa opção podemos definir o que ocorrerá com a aplicação após a atualização do registro.