Neste módulo, são criadas funções que vão gerar cálculos dentro do sistema.
Essas funções são usadas para folha de pagamento, IPTU, cálculos de ISS, entre outras.
No gerador de cálculo, criamos diversas funções que são utilizadas com os eventos para somar, subtrair, dividir, multiplicar, regras de 3 etc. Todos os cálculos matemáticos de que precisamos para obter determinado valor.
Somente o administrador tem permissão para incluir, alterar ou excluir uma função.
Ao clicar em "Biblioteca", "Biblioteca de Origem" e na funcionalidade "Gerar Função de Acesso", onde aparece "Módulo", "Cadastro" e "Biblioteca", só poderão ser visualizadas se o usuário logar como administrador. Porém, para alterar ou excluir, somente o dono da função tem permissão.
Para que administrador do sistema possa executar e ajudar os demais usuários nesse módulo e nas ações, é necessário conhecimento básico em linguagem de programação.
Nesta funcionalidade, temos um formulário para preenchimento com quatro abas, que são: "Assinatura", "Parâmetros", "Variáveis" e "Corpo".
Vamos falar de cada aba e de cada campo para prenchimento.
Assinatura – ao clicar em "Assinatura", aparecerá uma tela para preenchimento. No campo "*Biblioteca", que é obrigatório, selecione a biblioteca onde se deseja colocar a função. No exemplo abaixo, folha específica.
*Nome – obrigatório o preenchimento. Neste campo, escrevemos o nome da função. O padrão de criação do nome da função é: primeira letra maiúscula e juntos. Exemplo: RecuperaSalarioBase. Essa função é usada para calcular o salário dos servidores. Exemplo na tela abaixo:
*Retorno – neste campo, selecionamos uma das opções para o retorno da função, Booleano, data, inteiro, numérico ou texto.
Conforme tela exemplificativa, para essa função, citada como exemplo, selecionamos Booleano.
Comentário – podemos digitar informações sobre a finalidade da função e da data de criação, como no exemplo:
Variáveis – é onde escrevemos os nomes de cada variável, selecionamos o tipo e o valor inicial.
Nome – escrevemos o nome da variável. Veja tela seguinte:
Tipo – selecionamos o tipo que vamos atribuir à variável.
No exemplo acima, selecionamos o tipo Booleano; ao selecioná-lo, um campo para incluir o valor será aberto. Veja abaixo:
Neste exemplo, selecionamos o valor verdadeiro:
Após clicar em adicionar, uma lista será criada, conforme pode ser visto em tela abaixo.
E, assim, até terminar todas as variáveis que vão compor a função.
OBS.: não clicar em "OK". Somente quando terminar todas as abas. Caso contrário, apresentará erro, conforme tela exemplificativa.
Tomando como exemplo a função RecuperaSalarioBase, a tela de variáveis completa será apresentada. Informo que essa função é uma das mais simples.
Parâmetros – os parâmetros são usados para mandar valores à função, com os quais trabalhará para realizar as ações.
São os valores de entrada que recebem uma função.
Por exemplo, uma função que realizasse uma soma de dois números teria como parâmetros esses dois números.
Os dois números são a entrada, e a saída seria o resultado.
Nome – preencher com o nome da variável.
Tipo – selecionar o tipo desejado.
Depois de adicionar, todas as variáveis criadas serão apresentadas na lista de parâmetros. Observar que essa tela é a mesma da aba "Variável".
Corpo – corpo da função possui duas abas "Linguagem Natural" e "Linguagem PLpgSQL"
Linguagem Natural – temos os seguintes comandos: Atribuição, Condição, Laço e Retorno. São comandos que vão auxiliar na construção da função. Veja tela abaixo:
É neste local, também, onde digitamos a função, alteramos ou excluímos. Observe as linhas de comandos conforme ícones apresentados ao lado das linhas.
Para excluir, clicar no ícone 
.
Para alterar, clicar no ícone 
, em seguida, outra tela de Dados para atribuição será aberta. Preencher o campo "Variável" e "Tipo de Atribuição", depois clicar em "OK".
Se a linha for do comando atribuição, a tela apresentada será:
Aparecerá o ícone 
marcado, então, a partir daí, inicia-se a próxima linha de comando. Isso quer dizer que, abaixo dessa linha, será criada a próxima linha de comando. Visualize tela abaixo:
Vamos explicar, agora, cada comando:
Atribuição – quando vamos fazer uma função, a tela inicial está assim:
Depois que forem preenchidas as outras abas, será listado o nome da função criada na aba "Assinatura". Abaixo do "Declara", todas as variáveis criadas na aba "Variáveis" serão mostradas e, se houver parâmetro, vão aparecer logo abaixo.
Para acrescentar uma linha com o comando "Atribuição", clique em "Atribuição" e a seguinte tela será aberta:
Na tela "Dados para Atribuição", há o campo obrigatório "Variáveis". Selecione as variáveis que foram criadas na aba "Variáveis".
Tipo de Atribuição – clicar em uma das opções "Simples", "Função", "Tratamento de Erros".
Condição – quando clicamos em condição, aparecerá a tela abaixo, por meio da qual podemos escolher que condições queremos colocar na função que estamos criando.
Ao se clicar em "Próximo", a seguinte tela será apresentada:
No campo "Valor/Variável", escrevemos a variável a que vamos atribuir algum valor.
No campo "Selecione", vamos selecionar as variáveis que foram criadas para a função, depois adicionar. Abaixo, aparecerão os símbolos que vamos usar para fazer as operações e, no campo "SE", quando é adicionado, cria-se a condição abaixo demonstrada.
Laço – ao clicarmos no "Laço", aparecerá a seguinte tela. Preencher como se pede.
Retorno – ao clicarmos em "Retorno", a seguinte tela será aberta.
O sistema já vai trazer a variável BoRetorno; em seguida, clique em "OK" para incluir a linha na função.
E a aba "Linquagem PLpgSQL" irá mostrar a função no formato de linguagem de programação. Exemplo: a função RecuperaSalarioBase completa. observe tela seguinte:
