Search the Community

Os sistemas TOTVS RM tem um recurso de Fórmulas muito importante, o qual utiliza funções para buscar dados no próprio sistema, em tabelas, relacionadas a cálculos, e diversas formas de tratar as informações para relatórios, para calcular eventos, impostos, etc. Segue neste tópico todas as funções apresentadas nos sistemas, com exemplos, e juntando todas as diversas páginas em uma única. Cadastro de Fórmulas O Cadastro de Fórmulas nos aplicativos RM terá, basicamente, três principais objetivos, dentre eles: Seleção (restrição da aplicabilidade de alguma operação). Definição da forma de cálculo de eventos específicos, inclusive do tipo "base de cálculo", que servem de referência para outros cálculos. Relacionamento de valores entre os eventos. O editor de fórmulas possui um campo de texto para que você monte as estruturas das fórmulas. Usando o editor de fórmulas, as funções e comandos desejados para a criação da fórmula serão movidos para o campo de texto, bastando clicar duas vezes sobre as opções função, comando ou parâmetro. Observação Funções podem ser escritas com letras maiúsculas e/ou minúsculas. Na fórmula só poderão ser incluídas até 50 constantes. O parâmetro crítica global permite que uma fórmula possa ser usada em uma crítica global dos sistemas, a fim de fazer a validação ou cálculo necessário para o processo que a usar. Exemplo No sistema de Folha de Pagamento esta opção é marcada para indicar que a fórmula deverá ser processada para todos os funcionários selecionados durante o processo de Crítica da Folha (Rotinas | Crítica da Folha). Fórmulas de crítica servem para verificar se determinado evento foi ou não calculado para um funcionário ou grupo de funcionários. O parâmetro Fórmula de Seleção deverá ser marcada para distinguir todas as fórmulas que são usadas como seleção. Exemplo Nos módulos dos relatórios internos do módulo Automação de Ponto, como relatório do Espelho de Cartão de Ponto, pode-se utilizar uma fórmula para selecionar alguns funcionários. No campo de Fórmula de seleção só serão listadas as fórmulas que estiverem com o parâmetro "Fórmula de seleção" marcado. Para testar as fórmulas, é preciso definir um “Contexto”, ou seja, Clique no ícone para selecionar o contexto da execução da fórmula, isto é, para qual ou quem a fórmula será executada. Exemplo: Para qual produto (Gestão de Estoque) ou para que funcionário (Folha de Pagamento) a fórmula será executada. A caixa de diálogo Seleção de Contexto será apresentada. Clique no ícone para testar a fórmula. Caso o contexto ainda não tenha sido selecionado, a caixa de diálogo Seleção de Contexto será apresentada automaticamente. Gerar LOG para fórmulas No módulo Serviços Globais é possível gerar arquivos de LOG de fórmulas, que tem como finalidade registrar em um arquivo informações sobre a execução da fórmula. Para gerar um arquivo de LOG de fórmula é necessário clicar duas vezes sobre um registro de fórmula na tela de visão das fórmulas. O parâmetro ‘Acompanhar execução e salvar no arquivo:’ permite exibir o arquivo com os dados da LOG após o término do Resultado da fórmula. Abaixo deste campo o sistema apresenta o campo de texto onde é apresentado o nome e extensão do arquivo onde os dados do LOG serão gravados. Ao acionar o botão Resultado, o sistema executa o cálculo da fórmula e apresenta seu valor. Para testar Fórmula Automaticamente ao Salvar, Marque esta opção para que o sistema automaticamente teste a fórmula quando esta for salva. O resultado da fórmula será apresentado no campo resultado. No cadastro de fórmulas também são exibidas a data e hora da última alteração realizada na fórmula, bem como o Usuário responsável, que exibe o usuário que realizou a última alteração na fórmula. Observação A fórmula não precisa ser gravada para que o teste seja executado. O resultado de uma fórmula será apresentado com N casas decimais, conforme o produto que o usuário estiver utilizando. Exemplo Caso o usuário esteja utilizando o módulo Folha de Pagamento, o resultado será exibido com 4 (quatro) casas decimais. Aplicação das fórmulas Uma aplicação para as fórmulas são os campos complementares, onde têm a função de validar um determinado valor, como por exemplo, a utilização de fórmula para validação de pré-requisito de disciplinas, cálculo de insumos. Para validar o campo complementar basta associar a fórmula desejada ao campo complementar, para que esta valide o conteúdo do campo complementar quando você incluir um valor para ele. Outra finalidade é o seu uso em consultas SQL e relatórios do sistema. Pelos relatórios você inclui as fórmulas deslocando o componente de fórmulas e associando-o a uma fórmula cadastrada no sistema. Já nas Consultas SQL as fórmulas devem ser incluídas passando um comando específico para informar que você está utilizando uma fórmula do sistema. Exemplo SELECT CHAPA, SALARIO FROM PFUNC WHERE CHAPA = :FRM_CHAPA; Fórmulas em VB.NET No módulo Globais é possível criar e executar fórmulas em VB.Net. Esta funcionalidade tem como objetivo permitir que usuários também utilizem da linguagem VB.net para elaborar e executar fórmulas no RM.exe, além das Fórmulas RM. Na aba administração, selecione a action Fórmulas. Após definir e executar um filtro, selecione agora um Sistema e logo após a opção Novo, para que o a janela para inserção de uma nova Fórmula seja exibida. Preencha os campos Código e Título. No campo Linguagem, selecione a opção VB. NET. Insira no campo destinado a elaboração das fórmulas, uma fórmula válida elaborada na linguagem VB.NET . Acione o botão Contexto, informe um contexto para execução e execute-o. Ao acionar o botão Resultado, o sistema irá exibir o resultado da fórmula inserida na linguagem VB.NET. Selecione a opção Salvar e o sistema registrará a fórmula em VB.NET, exibindo a mesma na listagem de fórmulas do sistema. Fórmulas Globais As fórmulas globais são aquelas apresentadas para todos os módulos do sistema, e são passíveis de uso em qualquer um deles. Conheça as fórmulas globais: EXECSQL Executa uma consulta SQL. Caso a execução tenha pelo menos uma linha de resultado, está variável retorna VERDADE. Sua sintaxe é: EXECSQL(‘código da consulta SQL’). Exemplo: EXECSQL('Codigo_Consulta_SQL') PROXREGSQL Avança um registro na Consulta SQL executada. Sua sintaxe é: PROXREGSQL('código da consulta sql') Exemplo: PROXREGSQL('Codigo_Consulta_SQL') RESULTSQL Esta função lê uma linha do resultado da execução da SQL. Sua sintaxe é: RESULTSQL('código da consulta sql', 'nome do campo') Exemplo: RESULTSQL('Codigo_Consulta_SQL', 'SALARIO') Fórmulas específicas para o RM Labore - Gestão de Folha de Pagamento A utilização de fórmulas no RMLabore se faz necessário, por exemplo, em situações em que o código de cálculo nos eventos do Labore, em sua forma nativa, não possuem o comportamento desejado perante as regras de negocio da empresa. Fórmulas / Funções - A Função A = Retorna valor de um acumulador Sintaxe = A (‘CÓD. DO ACUMULADOR) Tipo de Retorno = Valor Exemplo: Código da fórmula: AC01 = Retorna valor do acumulador de código 01 (Comissão). Texto da fórmula: A(‘01’) Observação: O código do acumulador deve ser informado entre aspas. Os acumuladores são incluídos ou editados no cadastro de tabelas dinâmicas. No cadastro de eventos, você define se valores deste serão guardados em determinado acumulador. Atenção: As variáveis de fórmula que são relativas à movimentação do funcionário, como a A, não devem ser utilizados para fórmula de seleção. Porque no momento da seleção, o sistema ainda não executou a movimentação do funcionário. Desta forma, estas funções/variáveis irão retornar sempre "zero". Função ABS = Valor Absoluto Sintaxe = ABS (VALOR) Tipo de Retorno = Valor Função ACUMFF = Acumulador de ficha financeira Sintaxe = ACUMFF(MÊS, ANO, 'CÓD. DO ACUMULADOR') Tipo de Retorno = Valor Observação: Este acumulador deverá ser criado em TABELAS DINÂMICAS - INT34 Função ADIANT = Retorna percentual de adiantamento Sintaxe = ADIANT Tipo de Retorno = Valor Exemplo: ADIANT Supondo que o funcionário Antônio tem um percentual de adiantamento de 40%, o retorno da fórmula, para esse funcionário, seria 40. Função ADMDEM = Retorna admitido ou demitido no mês Sintaxe = ADMDEM Tipo de Retorno = Valor Exemplo: ADMDEM Supondo que o funcionário Itamar foi admitido ou demitido no mês de competência, o retorno será 1. Se houvesse sido admitido ou demitido em outros meses, retornará 0. Função ALTEROUCADASTRO = Retorna 1 se houver alteração no cadastro do funcionário e 0 se não houver alteração. Sintaxe = ALTEROUCADASTRO(‘string’) Tipo de Retorno = Valor Observação: Na sintaxe, o campo string deverá ser informado com qual campo do cadastro será validado. Exemplo: ALTEROUCADASTRO ('FUNCAO') ALTEROUCADASTRO ('SECAO') Esta função está contemplando se houve alteração no cadastro dos campos: FUNCAO e SECAO. Dica: Esta função poderá ser utilizada no campo Fórmula para Criticar o Cadastro de Funcionários no parametrizador em Folha de Pagamento | Funcionário | Restrições Cadastrais. Função ANO = Retorna ano de competência. Sintaxe = ANO Tipo de Retorno = Valor Função ANOCX = Retorna ano-caixa. Sintaxe = ANOCX Tipo de Retorno = Valor Função ANODT = Retorna ano de uma data. Sintaxe = ANODT (‘DATA’) Tipo de Retorno = Valor Exemplo: ANODT(‘23/01/1997’) Retorna: 1997 ANODT (DNASCIM) Supondo que a data de nascimento de um funcionário seja 10/09/1961, retorna 1961. Dica: No parâmetro DATA da sintaxe pode ser uma função que retorna data no lugar da data específica. Função ARRED = Arredonda um valor sem casas decimais. Sintaxe = ARRED (VALOR) Tipo de Retorno = Valor Função ARREDONDA = Arredonda um valor com casas decimais. Sintaxe = ARREDONDA (VALOR, VALOR) Tipo de Retorno = Valor Exemplo: Quando há várias casas decimais e o arredondamento será apenas para duas casas decimais: ARREDONDA(777.7784,2) = 777,78 Função ARREDVALOR = Arredonda um valor com casas decimais. Sintaxe = ARRED (VALOR, VALOR) Tipo de Retorno = Valor Função ASCII = Retorna o código ASCII de um caractere. Sintaxe = ASCII (‘STRING’) Tipo de Retorno = Valor Função ATRIBUI = Atribui valor a uma memória. Sintaxe = ATRIBUI(NÚMERO DA MEMÓRIA, INDEFINIDO) Tipo de Retorno = De acordo com o que for atribuído à memória Exemplo: ATRIBUI (1, RC) Memória de nº 1 guardará valor do salário nominal.

Prezados estou seguindo um exemplo da TDN para criar uma fórmula visual. Sò que aparece quando clico em destinatário a mensagem seguinte aparece: 'O objeto de tipo 'System.String' não pode ser convertido no tipo 'System.String[]'.' EStou na figura 12 do link http://tdn.totvs.com/pages/releaseview.action?pageId=75269761