Ligação de Botões

View video

Este tipo de ligação cria um link entre um botão criado na aplicação de origem e qualquer aplicação do projeto(aplicação de destino). Esta ligação é ativada ao clicar no botão configurado na ligação.

Na consulta é possível criar uma ligação de botão com os seguintes tipos:

• Botões PHP
• Botões de Ligação
• Botões Run

Aplicação de origem é utilizado para identificar a aplicação onde será criada a ligação. A aplicação de origem terá a chamada para a Aplicação de destino, que de refere a aplicação que será chamada após a ativação da ligação.

Exemplo de uma consulta com Ligação de Campo.

Criando uma Ligação de Campo

A criação de uma ligação é iniciada na lista das ligações, ao clicar no botão Criar nova ligação.

Na tela seguinte serão listadas os tipos de ligações disponíveis na aplicação.

Tipo da Ligação

Nesta etapa serão exibidos os tipos de ligações disponíveis na aplicação. A consulta possui quatro tipos exibidas de acordo com a disponibilidade na aplicação, selecione a opção: Ligação de Botão.

Para criação desta ligação devemos selecionar um botão criado previamente pelo desenvolvedor na aplicação de origem.

Caso nenhum botão tenha sido criado na aplicação este tipo de ligação não será listada. Clique aqui e veja como criar um botão na aplicação.

Após selecionar o campo para a ligação, clique em Prosseguir ».d

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.

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:

• 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 como parâmetro. Ao utilizar esta opção como parâmetro para uma chave primária, a aplicação de destino será 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.

• Coluna Tipo = Variável Global - Serão listadas apenas as variáveis globais definidas na aplicação de origem.
• Coluna Tipo = Valor Fixo - Será exibido um campo onde deve ser informado o valor que deve ser passado. Não é permitida a utilização de variáveis nesta opção, que aceita apenas valores alfanuméricos.
• Coluna Tipo = Sem valor - Nenhuma valor será enviado para a aplicação de destino, desta forma esta coluna não terá opções para serem selecionadas.

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

Estas propriedades definem o comportamento das ligações, como por exemplo, o local de abertura e URL de Retorno.

Modo de operação do link

Define o modo que a aplicação de destino será exibida na ligação. Este atributo também é responsável por definir as configurações disponíveis de acordo com o modo de operação do link selecionado. Confira a Tabela abaixo.

Abrir na mesma Janela

A aplicação de destino será exibida na mesma tela da aplicação de origem. Com esta opção de exibição, o botão sair da aplicação de destino deve ter o comportamento de retornar para a aplicação anterior.

Abrir em outra Janela

A aplicação de destino será aberta em uma nova janela do navegador. Com esta opção de exibição, o botão sair da aplicação de destino deve fechar a janela aberta.

Abrir em outra Aba

A aplicação de destino será aberta em uma aba do navegador. Com esta opção de exibição, o botão sair da aplicação de destino deve fechar a aba aberta.

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

A aplicação de destino será exibida em um modal. Com esta opção de exibição, o botão sair da aplicação de destino deve fechar a aba aberta.

Atributos das Propriedades da ligação disponíveis de acordo com o Modo de Operação do link selecionado

Atributos x Modos de operação do link	Abrir na mesma Janela	Abrir em outra Janela	Abrir em outra Aba	Modal
URL de saída da aplicação chamada
Fecha o formulário após uma atualização
Fecha formulário após inserção
Hint do link da ligação
Abrir a aplicação em aba dentro do menu
Título para Aba
Hint da Aba
Ícone Aba ativa
Ícone Aba Inativa
Largura
Altura

URL de saída da aplicação chamada

Este atributo define para qual página ou outra aplicação do projeto a aplicação destino da ligação irá retornar. Este retorno pode ser acionado através do botão voltar ou através de alguma configuração de comportamento realizada na ligação, por exemplo, a opção de Fecha o formulário após uma atualização (Este atributo é exclusivo para ligações com formulários).

É possível definir uma URL externa, por exemplo https://scriptcase.com.br, ou uma aplicação do projeto onde será necessário informar apenas o nome da aplicação.

Caso nenhum valor seja informado o retorno será para a própria aplicação de origem. Esta opção está disponível apenas quando o Modo de operação do link estiver como: Abrir na mesma Janela ou Abrir no parent

Fecha o formulário após uma atualização

Este atributo define o comportamento do formulário ao realizar uma atualização no registro a partir de uma ligação.

Ao marcar sim, o formulário aberto na ligação será fechado automaticamente ao realizar a atualização do registro. Já se o atributo estiver marcado como não, a aplicação de destino permanecerá aberta após a atualização, permitindo realizar novas alterações do registro.

Este atributo está disponível apenas quando a aplicação de destino for um formulário.

Fecha formulário após inserção

Este atributo define o comportamento do formulário ao realizar inclusão de registro a partir de uma ligação.

Ao marcar sim, o formulário aberto na ligação será fechado automaticamente ao inserir um registro. Já se o atributo estiver marcado como não, a aplicação de destino permanecerá aberta após a inserção de registros, permitindo desta forma que novos registros sejam inseridos.

Este atributo está disponível apenas quando a aplicação de destino for um formulário.

Abrir a aplicação em aba dentro do menu

Este atributo define o comportamento da ligação quando a aplicação de origem é acessada a partir de uma aplicação de menu, que por sua vez, deve estar configurada com a abertura dos itens em abas. Veja como habilitar este recurso nas aplicações de menu e menu arvore.

O atributo está disponível ao utilizar o Modo de operação do link definido como: Abrir em outra janela ou Abrir em outra aba.

Quando ativada a aplicação de destino será aberta em uma aba dentro da aplicação menu. Ao marcar não a aplicação de destino será aberta em uma nova janela ou uma nova aba do navegador, de acordo com o Modo de operação do link selecionado.

Título para Aba

Permite que o desenvolvedor defina um título da aba do menu onde a aplicação de destino será exibida. Caso nenhum valor seja informado a aba herdará o nome da aplicação chamada.

Esta configuração está disponível caso o atributo Abrir a aplicação em aba dentro do menu esteja configurado como Sim

Este atributo pode ser definido utilizando langs para sistemas multi-idiomas, que são gerenciadas no menu Traduzir aplicações, ou definindo o texto diretamente no campo, de acordo com a necessidade do sistema.

Hint da Aba

Permite ao desenvolvedor definir um texto para orientar o usuário final na utilização do sistema. O texto de ajuda será exibido ao posicionar o mouse sobre a aba do menu.

Esta configuração está disponível caso o atributo Abrir a aplicação em aba dentro do menu esteja configurado como Sim

Este atributo pode ser definido utilizando langs para sistemas multi-idiomas, que são gerenciadas no menu Traduzir aplicações, ou definindo o texto diretamente no campo, de acordo com a necessidade do sistema.

Exemplo do Hind na aba do menu com aplicação de destino

Ícone Aba ativa

Define a imagem que será exibida na ava do menu quando estiver ativada. Caso nenhuma imagem seja informada a aba herdará a imagem padrão, definida nos ícones do menu.

Esta configuração está disponível caso o atributo Abrir a aplicação em aba dentro do menu esteja configurado como Sim

Exemplo do ícone da aba ativa

Ícone Aba Inativa

Define a imagem que será exibida na aba do menu quando estiver ativada. Caso nenhuma imagem seja informada a aba herdará a imagem padrão, definida nos ícones do menu.

Esta configuração está disponível caso o atributo Abrir a aplicação em aba dentro do menu esteja configurado como Sim

Exemplo do ícone da aba inativa

Largura

Este atributo fica disponível para configuração apenas ao utilizar o Modo de operação do link como Modal.

Define a largura do modal onde o formulário será aberto. Esta largura refere-se ao espaço horizontal disponível para exibição da aplicação.

Este atributo utiliza obrigatoriamente pixels como unidade de medida, desta forma, apenas números devem ser informados para definição da largura. A largura da aplicação exibida no modal respeita a definição do atributo Largura da Tabela.

Exemplo da aplicação aberta no modal

Altura

Este atributo fica disponível para configuração apenas ao utilizar o Modo de operação do link como Modal.

Define a altura do modal onde o formulário será exibido. Esta altura refere-se ao espaço vertical disponível para exibição da aplicação.

Este atributo utiliza obrigatoriamente pixels como unidade de medida, desta forma, apenas números devem ser informados para definição da largura. A altura da aplicação é calculada automaticamente e respeita a quantidade de campos selecionados para a aplicação.

Exemplo da aplicação aberto no modal

Propriedades do Formulário

Estas propriedades estão disponíveis apenas em ligações onde a aplicação de destino for um formulário, esse bloco de configuração define a exibição ou não dos botões de Atualização (Inserir, Atualizar e Excluir) e Navegação (primeiro, anterior, próximo e último) do formulário de destino, de acordo com as configurações da barra de ferramentas da aplicação chamada.

É importante destacar que os atributos no bloco de Propriedades do Formulário não sobrepõem as configurações da barra de ferramentas do formulário chamado, eles apenas determinam se os botões lá configurados serão ou não exibidos na ligação.

Este atributo não está disponível caso o atributo Modo de operação do link esteja configurado como Abrir em um iframe. Nesta configuração, os botões do formulário serão exibidos na barra de ferramentas da aplicação de origem da ligação. Clique aqui para mais detalhes sobre a barra de ferramentas da consulta.

Habilitar Botão de Insert

Define a exibição ou não do botão Inserir no formulário de destino. Para isso, é necessário que o botão incluir esteja selecionado para ser exibido nas configurações da Barra de ferramentas da aplicação.

Habilitar Botão de Update

Define a exibição ou não do botão Atualizar no formulário de destino. Para isso, é necessário que o botão alterar esteja selecionado para ser exibido nas configurações da Barra de ferramentas da aplicação.

Habilitar Botão de Delete

Define a exibição ou não do botão Excluir no formulário de destino. Para isso, é necessário que o botão Excluir esteja selecionado para ser exibido nas configurações da Barra de ferramentas da aplicação.

Habilitar Botões de Navegação

Determina a exibição ou não dos Botões de Navegação (Primeiro, Retornar, Navegação por Página, Avançar, Último) configurados na Barra de ferramentas do formulário de destino.

Mantenha a cláusula WHERE na aplicação de destino

Este atributo fica disponível apenas ao habilitar os botões de navegação.

Este atributo possibilita que a cláusula WHERE da aplicação de origem (Consulta) seja mantida na aplicação de destino. Isso quer dizer que os filtros realizados na consulta serão herdados pelo formulário de destino, possibilitando uma melhor qualidade nos registros exibidos para a edição.

Propriedades da Consulta

As propriedades da consulta permitem alterar o comportamento da aplicação de destino, sem a necessidade de alterar a aplicação.

É importante destacar que estas configurações não forçam as configurações na aplicação de destino elas apenas alteram as configurações realizadas previamente. Por exemplo, se a aplicação de destino estiver com o módulo de filtro desabilitado utilizar o Módulo Inicial como filtro na ligação não surtirão efeito algum.

Estas propriedades estão disponíveis apenas em ligações onde a aplicação de destino for uma consulta.

Veja abaixo mais detalhes sobre os atributos.

Módulo Inicial

Define o módulo de abertura da aplicação de destino que pode ser Consulta ou filtro. Para que este recurso funcione é necessário que a aplicação de destino esteja com os módulos habilitados.

Linhas por Página:

Define a quantidade de linhas que serão exibidas na aplicação de destino. Caso nenhum valor seja informado será respeitada a configuração da aplicação chamada.

Quantidade de Colunas

Limita a quantidade de colunas exibidas na aplicação de destino.

O valor informado deve ser menor que a quantidade de colunas exibidas na aplicação de destino.

Paginação

Este atributo define o tipo de paginação utilizado na aplicação que pode ser Parcial onde o desenvolvedor define o número de linhas por página ou total que exibe todos os registros na mesma página.

Parcial

Exibe a aplicação de destino com uma quantidade limitada de registros por página. A quantidade de registro por página pode ser definida no atributo Quantidade de Linhas, caso nenhum valor seja informado herdará a configuração da aplicação de destino.

Este atributo não força a paginação parcial na aplicação de destino, apenas os botões de navegação configurados na barra de ferramentas.

Exemplo da barra de ferramentas com paginação parcial

Total

Força a exibição da aplicação de destino sem paginação, exibindo todos os registros em uma única página. Neste caso os botões de navegação são removidos.

Exemplo da barra de ferramentas com paginação total

Habilitar Cabeçalho

Define se o cabeçalho da consulta de destino será exibido. Para que o recurso funcione corretamente, aplicação e destino precisam estar com as opções de cabeçalho configuradas.

Habilitar Botões de Navegação

Determina a exibição ou não dos Botões de Navegação (Primeiro, Retornar, Navegação por Página, Avançar, Último) configurados na Barra de ferramentas da aplicação de destino.