sc_link(Coluna, Aplicação, Parâmetros, "Hint", "Target", Altura, Largura)

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 duplasaspas 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');