As Funções predefinidas são usadas em Valor-Padrão e podem ser utilizadas nas colunas Expressão, Critério e Ou. Abaixo consta uma imagem que exemplifica a utilização de uma dessas funções:
Conforme configuração apresentada na primeira imagem, possivelmente será necessário o uso de funções nativas da linguagem SQL de conversão:
A sintaxe da função é :FUNCAO_<chave> - sempre iniciar a função com : (dois pontos), em seguida a palavra FUNCAO_ (em letra maiúscula) e depois a chave (em letra minúscula);
Utilização da função CAST para definição de tipo de dados da função.
Abaixo estão listadas as funções predefinidas que podem ser usadas na tela Assistente SQL:
:FUNCAO_data - retorna data atual (dado originário do computador no qual está sendo executado o Webrun);
:FUNCAO_datahora - retorna data e hora atual (dado originário do computador no qual está sendo executado o Webrun);
:FUNCAO_hora - retorna hora atual (dado originário do computador no qual está sendo executado o Webrun);
:FUNCAO_horasimples - difere da função hora por não apresentar os segundos;
:FUNCAO_dia - retorna o dia, de acordo com a data atual (dado originário do computador no qual está sendo executado o Webrun);
:FUNCAO_mes - retorna o mês, de acordo com a data atual (dado originário do computador no qual está sendo executado o Webrun);
:FUNCAO_ano - retorna o ano, de acordo com a data atual (dado originário do computador no qual está sendo executado o Webrun);
:FUNCAO_guid - retorna a informação contida no campo Identificador da tela Definições do Formulário;
:FUNCAO_login - retorna o nome do usuário da sessão atual;
:FUNCAO_usuario - retorna o código de cadastro do usuário na tabela FR_USUARIO (sessão atual);
:FUNCAO_administrador - retorna o valor-padrão S, caso o usuário da sessão atual seja Administrador-Geral do sistema; caso contrário, a função retorna o valor N. Para recordar como configurar o usuário como Administrador-Geral, consulte o tópico Usuários do Sistema;
:FUNCAO_sistema - retorna as três letras que representam o sistema;
:FUNCAO_sistemanome - retorna o nome do sistema;
:FUNCAO_conexaoid - retorna o ID da conexão ao sistema, gerado pelo Webrun;
:FUNCAO_conexaoguid - retorna o GUID (identificador único) da conexão gerado pelo Webrun;
:FUNCAO_ip - retorna o IP da conexão;
:FUNCAO_host - retorna o IP do host (computador no qual foi instalado o Webrun) da conexão;
:FUNCAO_rand1 - retorna um número aleatório entre 0 e 9;
:FUNCAO_rand2 - retorna um número aleatório entre 0 e 99;
:FUNCAO_rand3 - retorna um número aleatório entre 0 e 999;
:FUNCAO_rand4 - retorna um número aleatório entre 0 e 9999;
:FUNCAO_rand5 - retorna um número aleatório entre 0 e 99999;
:FUNCAO_rand6 - retorna um número aleatório entre 0 e 999999;
:FUNCAO_fluxo_<nome_do_fluxo> - retorna o valor de retorno de um fluxo servidor.
O fluxo de ação utilizado na última função citada, deve possuir um valor de retorno (Parâmetro de Retorno configurado no componente Fim). Além disso, abaixo constam algumas observações sobre a sintaxe correta para a utilização desta função no Assistente SQL:
usar letras em minúsculo. Ex.: :FUNCAO_fluxo_pagamento;
não podem existir espaços;
não pode haver caracteres especiais;
não deve conter "_"(underline) no nome do fluxo.
:FUNCAO_sessao_nome_da_variável - retorna o valor atribuído à variável de sessão definida pelo usuário. Como exemplo: FUNCAO_sessao_departamento. No momento da criação do fluxo que define a variável de sessão (função Definir variável de sessão), o usuário deve atentar para a definição do escopo como do tipo não global (ou seja, declarar falso para o terceiro parâmetro da função).
Observações:
Não é possível utilizar a condição "IN" passando o valor de uma variável de sessão.
não deve conter "_"(underline) no nome da variável de sessão.
:FUNCAO_formulario_[guid_do_formulário]_[nome_do_campo] ou :FUNCAO_formulario_[código_do_formulário]_[nome_do_campo] - se o formulário estiver aberto, a função retornará o valor do campo do registro corrente; se o formulário estiver fechado, a função retornará o valor do campo do primeiro registro. São exemplos de uso da função a expressão :FUNCAO_formulario_B3D98C9A5DDC4C67A5E52DE9BC045BED_pes_cod e a expressão :FUNCAO_formulario_45_pes_cod.
Observações:
O Guid usado em:
:FUNCAO_formulario_B3D98C9A5DDC4C67A5E52DE9BC045BED_pes_cod e não pode conter os caracteres "{", "}" e "-".
A sintaxe: CONSTANTE_<chave> que era utilizada anteriormente continua funcionando, mantendo assim compatibilidade com configurações já feitas:
As funções pré-definidas deverão ser utilizadas somente nas definições do formulário.
____________________________________________________________________________
Caso este tópico não tenha comentário satisfatório, envie e-mail para documentacao@softwell.com.br