Tempo aproximado para leitura: 00:05:00min

Dúvida
Como identificar a sintaxe de funções de fórmula e aplicabilidade destas?

Ambiente
Cross Segmentos - TOTVS BackOffice Linha RM - TOTVS Gestão de Estoque, Compras e Faturamento - Todas as versões.

Solução
Toda função é composta por um código e quando há parênteses () em sua sintaxe haverá então uma passagem de parâmetros (valores a serem utilizados na função).

Neste exemplo utilizaremos a função TABITMCUSTOMOVRELAC. A função em questão tem o objetivo de buscar no movimento relacionado o valor unitário (custo médio) do item de movimento em questão.

1. No editor de fórmulas ao selecionar a função e dar um duplo clique sobre esta, o sistema irá lhe apresentar um assistente de utilização da função:

2. Ao clicar sobre o primeiro parâmetro esperado o sistema apresentará no campo Descrição qual a informação desejada para este parâmetro, permitindo assim determinar como passar tal parâmetro e entender a lógica que a função segue:

3. Através do campo Valor do Parâmetro é possível verificar o tipo de informação que pode ser utilizada para utilizar a função, sendo assim basta clicar para expandi-lo a fim de ter uma ideia de como passar o dado solicitado pelo parâmetro:

4. No caso deste parâmetro como a função em si não possui uma tabela específica no banco de dados (a TABITMMOV tem a tabela TITMMOV, esta em questão é um select em mais de uma tabela por isso não tem tabela específica), para buscarmos o IDMOV a ser consistido na função deveremos buscar outra função de fórmula que no caso será a TABITMRELACPED (busca dados do movimento relacionado onde passaremos como parâmetro o campo IDMOV com o tipo I de inteiro) diferentemente da função principal esta solicita como passagem de parâmetro o campo propriamente dito e não outra função:

5. Seguindo o mesmo princípio informado nos passos anteriores podemos identificar que o segundo parâmetro esperado é o NSEQITMMOV (numero sequencial) do item de movimento a ser averiguado pela função. Esta informação também será carregada através de outra função de fórmula que também será a TABITMRELACPED:

6. Após preencher todos os parâmetros esperados pela função clique em ok e a função terá sido criada em sua fórmula:

​

Utilize sempre esta lógica e conseguirá identificar como utilizar qualquer função no sistema.

Para auxílio na realização do teste de fórmula, clique aqui.