Para alterar as propriedades de execução das aplicações, mudando sua forma de execução em relação ao inicialmente previsto, o Scriptcase dispõe de uma macro chamada sc_apl_conf. A macro deve ser utilizada da seguinte maneira:
sc_apl_conf(Aplicação, Propriedade, valor);
Desta forma, podemos forçar que um formulário inicie no modo de inclusão, ou uma consulta inicie pelo filtro, etc.
A macro pode ser utilizada, por uma aplicação, para modificar as propriedades de uma outra aplicação. Por exemplo, em um cadastro de pedido, um vendedor pode cadastrar um novo pedido, mas não pode alterá-lo, neste caso usariamos, em um botão do tipo "PHP", o seguinte trecho de código para cadastrar pedidos:
if([usu]=="vendedor")
{
sc_apl_conf("apl_cadastra_pedido","update","off");
sc_redir(apl_cadastra_pedido.php);
}else
{
sc_redir(apl_cadastra_pedido.php);
}
Abaixo uma tabela com as propriedades e valores, da macro:
Propriedades para aplicações de Formulário
Propriedade | Valor | Descricao |
start | new | Força o formulário a iniciar no modo de inclusão de novo registro. |
insert | on/off | Habilita (on) ou desabilita (off) a inclusão de novos registros |
update | on/off | Habilita (on) ou desabilita (off) a alteração de registros |
delete | on/off | Habilita (on) ou desabilita (off) a exclusão de registros |
field_display_off | campo | Desabilita a exibição de um campo |
field_display_on | campo | Habilita a exibição de um campo |
field_readonly | campo | Força um campo para ser exibido como "readonly" |
rows | Força a quantidade de linhas por página (apenas para formulários de múltiplas linhas) | |
rows_ins | Força a quantidade de linhas de inclusão (apenas para formulários de múltiplas linhas) |
Propriedades para aplicações de Consulta
Propriedade | Valor | Descricao |
start | filter | Força a consulta a iniciar pelo filtro. |
cols | Força a quantidade de colunas (consultas tipo vertical e slide) | |
rows | Força a quantidade de linhas por página | |
lig_edit | on/off | Habilita (on) ou desabilita (off) o botão de edição do registro (lapis) |
Propriedades para todas as aplicações
Propriedade | Valor | Descricao |
exit | apl/url | Força a saida da aplicação para a "aplicação" ou "url" informada. |
Abaixo alguns exemplos:
Ex1: Forçar a aplicação "meu_formulario" a iniciar no modo de inclusão.
sc_apl_conf("meu_formulario", "start", "new");
Ex2: Não permite que a aplicação "meu_formulario" faça inclusão de novos registros.
sc_apl_conf("meu_formulario", "insert", "off");
Ex3: Exibe "meu_campo", da aplicação "meu_formulario", dinamicamente.
sc_apl_conf("meu_formulario", "field_display_off", "meu_campo");
Ex4: Forçar a aplicação "minha_consulta" a iniciar pelo filtro.
sc_apl_conf("minha_consulta", "start", "filter");
Ex5: Forçar a aplicação "minha_consulta" a exibir 20 linhas.
sc_apl_conf("minha_consulta", "rows", "20");
Ex6: Forçar a saida da aplicação "minha_consulta" para a aplicação "outra_consulta".
sc_apl_conf("minha_consulta", "exit", "outra_consulta");