Ligação de Campo
Criando uma Ligação de Campo
Permite criar uma ligação a partir de um campo imagem HTML para qualquer aplicação existente no projeto.
Essa ligação é ativada apenas quando existe um campo Imagem HTML selecionada nos campos.
Com o campo imagem HTML criado, será exibida a opção de criação de uma ligação de campo.
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:
- 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.
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.
Abrir na mesma Janela
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
Hint do link da ligação
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 o campo com a ligação.
Exemplo do Hind no campo da ligação
Abrir em outra Janela
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.
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.
Hint do link da ligação
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 o campo com a ligação.
Exemplo do Hind no campo da ligação
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.
Í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
Í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
Font Awesome da aba
Define o font Awesome que será exibida na aba do menu quando a aplicação de destino for aberta.
Esta opção sobrepoe as imagens definidas nos atributos: Ícone Aba ativa e Ícone Aba Inativa
Esta configuração está disponível caso o atributo Abrir a aplicação em aba dentro do menu esteja configurado como Sim
Abrir em outra Aba
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.
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.
Hint do link da ligação
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 o campo com a ligação.
Exemplo do Hind no campo da ligação
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.
Í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
Í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
Font Awesome da aba
Define o font Awesome que será exibida na aba do menu quando a aplicação de destino for aberta.
Esta opção sobrepoe as imagens definidas nos atributos: Ícone Aba ativa e Ícone Aba Inativa
Esta configuração está disponível caso o atributo Abrir a aplicação em aba dentro do menu esteja configurado como Sim
Abrir no parent
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
Hint do link da ligação
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 o campo com a ligação.
Exemplo do Hind no campo da ligação
Modal
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
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.
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.
Hint do link da ligação
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 o campo com a ligação.
Exemplo do Hind no campo da ligação
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.