|
Permite criar uma ligação de campo entre duas aplicações de forma dinâmica.
Esta macro está disponível apenas na Consulta.
Abaixo seguem a lista de parâmetros da macro, que devem ser informados separados por vírgula.
| Parâmetro |
Valor |
Descrição |
coluna |
Este parâmetro pode ser informando com aspas duplas ou aspas simples.
Por exemplo:
sc_link("customerid", form_customer, custom={customerid}, "Dados do Cliente", "_self");
Formas aceitas de passagem do parâmetro:
- 'customerid'
- "customerid"
|
Este parâmetro obrigatório.
Nele devemos informar o nome do campo(coluna) onde a ligação será criada, transformando o valor do campo em um link.
Obs: Caso o campo informado já possua uma ligação de campo, a ligação definida na macro irá sobrescrever a ligação da interface.
|
aplicação |
Este parâmetro pode ser informando com aspas duplas, aspas simples ou variáveis.
Por exemplo:
$var_customer = 'form_customer';
sc_link(customerid,$var_customer,custom={customerid},"Dados do Cliente","_self");
Formas aceitas de passagem do parâmetro:
- 'form_customer'
- "form_customer"
- $var_customer
- [glob_customer]
|
Este parâmetro obrigatório.
Devemos informar o nome da aplicação de destino da ligação.
Neste parâmetro é possível utilizar variáveis permitindo a alteração da aplicação de destino de acordo com sua regra de negócio.
|
parametros |
Este parâmetro deve ser informado sem a proteção de aspas. Veja os exemplos abaixo de como devemos utilizar o parâmetro
Exemplo com um valor
sc_link(customerid, form_customer, glb_custom={customerid}, "Dados do Cliente", "_self");
Exemplo com múltiplos valores
sc_link(customerid, form_customer, glb_orderid=10250;glb_custom={customerid}, "Dados do Cliente", "_self");
Formas de passagem do parâmetro:
- custom = {customerid}
- custom = 'ALFKI'
- custom = $var_customer
- custom - [glob_customer]
|
Este parâmetro não obrigatório.
Nele definimos os valores que serão passados para a aplicação de destino como uma variável global. É definir mais um uma variável global no parâmetro, basta separá-los por ponto e vírgula (;).
Exemplo:
glb_orderid=10250;custom={customerid}
Na aplicação de destino, demoves recuperar o valor como uma variável global. Por exemplo, ao criarmos uma ligação com um formulário customer, no SQL deste form podemos adicionar:
WHERE customerid = [glb_customer]
Para mais informações sobre a passagem de parâmetros veja nossa documentação sobre variáveis globais
|
hint |
Este parâmetro pode ser informando com aspas duplas, aspas simples ou variáveis.
Por exemplo:
sc_link(customerid, form_customer, custom={customerid}, "Dados do Cliente", "_self");
Formas aceitas de passagem do parâmetro:
- "Texto de ajuda\, com virgula"
- 'Dados do Cliente'
- {lang_texto}
- [glob_txt]
- $var_txt
|
Este parâmetro não é obrigatório.
Recebe um texto do hint de ajuda da ligação, exibido ao posicionar o mouse sobre o link criado.
É possível a utilização de langs para a definição das mensagens, permitindo a tradução do seu sistema.
Obs: Para utilização de virgulas e apóstrofos no texto é necessário proteger com o scape "\"
|
target |
Este parâmetro pode ser informando com aspas duplas ou aspas simples. Os valores disponíveis abaixo.
Por exemplo:
sc_link(customerid, form_customer, custom={customerid}, "Dados do Cliente", "modal", 850, 600);
Formas aceitas de passagem do parâmetro:
- "_self"
- "_blank"
- "iframeT"
- "iframeL"
- "iframeR"
- "iframeB"
- "modal"
|
Define a forma de abertura da aplicação de destino.
- _self - Executa a aplicação de destino na mesma página, sobrepondo a aplicação de consulta;
- _blank - Executa a aplicação de destino em outra página (pop-up);
- iframeT - A aplicação de destino será exibida em um iframe acima da consulta (Top);
- iframeL - A aplicação de destino será exibida em um iframe a esquerda da consulta (Left)
- iframeR - A aplicação de destino será exibida em um iframe a direita da consulta (Right);
- iframeB - A aplicação de destino será exibida em um iframe abaixo da consulta (Bot);
- modal - Abre uma nova janela e bloqueia qualquer interação na janela principal;
Obs: Se omitido, será atribuído o valor "_self".
Neste parâmetro podemos definir a abertura do link no iframe ou modal, nestes casos devemos definir uma altura e largura nos dois parâmetros adicionais abaixo.
|
altura |
Este parâmetro aceita apenas valores numéricos e sua unidade de medida é pixel.
Por exemplo:
sc_link(customerid, form_customer, custom={customerid}, "Dados do Cliente", "modal", 850, 600);
|
Parâmetro não obrigatório, disponível apenas ao utilizar as opções Iframe e modal no parâmetro Target
Define a altura do iframe ou modal onde a aplicação de destino será exibida.
Obs: Caso seja omitido o valor padrão será 440
|
largura |
Este parâmetro aceita apenas valores numéricos e sua unidade de medida é pixel.
Por exemplo:
sc_link(customerid, form_customer, custom={customerid}, "Dados do Cliente", "iframeB", 850, 600);
|
Parâmetro não obrigatório, disponível apenas ao utilizar as opções Iframe e modal no parâmetro Target
Define a largura do iframe ou modal onde a aplicação de destino será exibida.
Obs: Caso seja omitido o valor padrão será 630
|
Exemplos
Ex. 1: Criando um link para a aplicação dados_cli.php, no campo cpf, passando a variável global [glo_emp] como empresa e o campo (variável local) {cpf} para a aplicação dados_cli.php:
sc_link(cpf,dados_cli.php,empresa=[glo_emp];cpf={cpf},"Dados individuais do Cliente ", "_blank");
Ex. 2: Criando um link dinâmico para uma ou outra aplicação dependendo do valor no campo {tp_cli} e abrindo uma janela modal:
if ( {tp_cli} == "F" ) { sc_link(tpcli, fisica.php, empresa=[glo_emp]; cpf={cpf}," Pessoa Física ", "modal", 500, 700); } else { sc_link(tpcli, juridica.php, empresa=[glo_emp]; cnpj={cnpj}," Pessoa Jurídica ", "iframeR"); }
Ex. 3: - Criando um link para uma URL. Será executado um redirecionamento para a URL informada.
sc_link(minha_coluna, http://www.scriptcase.com.br, ,"hint do link", '_blank');
|