Esta macro tem por objetivo redirecionar o processamento para outra aplicação ou URL.

Caso a aplicação de redirecionamento utilize parâmetros, estes devem ser passados da seguinte forma:

1. Após o nome da aplicação, utilizar o delimitador vírgula (,)
2. Informar o nome do parâmetro, o sinal de igualdade (=) e o valor ou variável a ser atribuida.
3. Havendo mais de um parâmetro, utilizar o delimitador ponto e vírgula (;)
4. Poderá ser informado o target no qual a aplicação será aberta (default=_self), podendo ser: _self, _parent, _blank ou modal.
5. Paramentro opcional para definir se vai redirecionar caso existam mensagens de erro na aplicação. "E" não redireciona caso existam erros e "F" força redirecionamento mesmo se houver erro na aplicação.

Nas aplicações de fomulário, dos eventos que essa macro pode rodar alguns dependem da atualização da base de dados (onAfterInsert, onAfterUpdate, onAfterDelete, onBeforeInsert, onBeforeUpdate or onBeforeDelete) são automaticamente protegidos por um controle de transação desde que a conexão seja a mesma da aplicação.

Contudo, se o usuário deseja fazer um controle de transação, ele precisa iniciar essa macro e finalizar com "sc_commit_trans()" macro para confirmar a atualização ou o "sc_rollback_trans" para cancelar a transação.

Ex. 1: Aplicação sem parâmetros e sem target.
if ([glo_usuario] == "teste")
{
sc_redir(aplx.php);
}


Ex. 2: Aplicação com parâmetros e sem target.sc_redir(Aplicação, Parametro01; Parametro02, Target, Error)
if ([glo_usuario] == "teste")
{
sc_redir(aplx.php, parm1={clienteid}; parm2="xxx");
}


Ex. 3: Aplicação sem parâmetros e com target.
if ([glo_usuario] == "teste")
{
sc_redir(aplx.php, "", "_parent");
}


Ex. 4: Aplicação com parâmetros e com target.
if ([glo_usuario] == "teste")
{
sc_redir(aplx.php, parm1={clienteid}; parm2="xxx", "_blank");
}


Ex. 5: URL.
if ([glo_usuario] == "teste")
{
sc_redir(http://www.minha_pagina.com.br);
}

OBS: Tudo que foi passado como parâmetro pela macro será acessível como variável global na aplicação a qual foi redirecionada.

EX: sc_redir(aplx.php, parm1={clienteid}; parm2="xxx");

Na aplicação aplx.php o parâmentro poderá ser acessado fazendo chamada a variável global [parm1] e [parm2]