Como utilizar a macro sc_apl_conf

Como utilizar a macro sc_apl_conf

 

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

PropriedadeValorDescricao
startnewForça o formulário a iniciar no modo de inclusão de novo registro.
inserton/offHabilita (on) ou desabilita (off) a inclusão de novos registros
updateon/offHabilita (on) ou desabilita (off) a alteração de registros
deleteon/offHabilita (on) ou desabilita (off) a exclusão de registros
field_display_offcampoDesabilita a exibição de um campo
field_display_oncampoHabilita a exibição de um campo
field_readonlycampoForç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

PropriedadeValorDescricao
startfilterForç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_editon/offHabilita (on) ou desabilita (off) o botão de edição do registro (lapis)

Propriedades para todas as aplicações

PropriedadeValorDescricao
exitapl/urlForç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");      

    • Related Articles

    • Macro sc_date

        O Scriptcase disponibiliza uma macro bastante útil para manipulação de datas, que é uma processo muito trabalhoso, porém com o uso da macro sc_date(Incrementa e Decrementa Datas), fica bem mais simples, exemplo:   sc_date (Data, formato, operador, ...
    • Macro sc_block_display

      Neste exemplo, veremos como usar a macro sc_block_display em um evento Ajax utilizando botão do tipo Radio em um Formulário, essa macro tem como finalidade ocultar ou mostrar um bloco. As etapas neste exemplo: Configurando campo do tipo Radio ...
    • Como alterar dinamicamente o tema de um projeto utilizando a macro sc_set_theme

      O Scriptcase disponibiliza macros, funções criadas pelos desenvolvedores do Scriptcase, que irão auxiliar na customização das aplicações bem como simplificar a edição dos códigos nos eventos. Neste artigo, veremos como utilizar a macro sc_set_theme ...
    • Utilizando a macro sc_confirm

      Neste artigo, veja um exemplo prático de utilização da macro sc_confirm. Esta macro pode ser utiliza apenas em botões PHP criados na barra de ferramentas das aplicações de formulário e controle, com o objetivo é confirmar a excursão de uma ação. Veja ...
    • Usando a macro sc_date_dif_2

      Para calcular a diferença entre duas datas, temos a macro sc_date_dif_2, neste exemplo veremos como ela funciona e como usá-la. 1. O formato com o qual você está mantendo dentro do banco de dados deve ser levado em conta: Formato no Banco de Dados    ...