Criar funções
 |
 |
 |
 |
Pré-requisitos
- Acesso ao menu Cadastro > Formulário (FO005).
- Formulário responsivo previamente cadastrado e modelado.
Apresentação
As funções são utilizadas para fazer a manipulação e busca de valores no formulário. Elas podem ser associadas às regras e expressões aplicadas aos campos do formulário, além de poderem serem associadas a outras funções.
As funções permitem arredondar valores de um campo decimal, mudar o texto incluído em um campo de minúsculo para maiúsculo, adicionar dias em campos de data etc.
Como o estudo de caso está sendo feito a partir de um formulário de solicitação de viagem, para exemplificar o uso das funções, será criada e aplicada uma função para que o nome do solicitante seja preenchido automaticamente com o nome do usuário logado no sistema.
Veja como criar e aplicar a função:
Como criar uma função
• Para mais detalhes sobre a criação das regras, consulte o artigo Configurar regras no formulário responsivo.
• Para mais informações sobre a associação e preenchimento do formulário nas atividades de processo, consulte os artigos Associar formulário à atividade de processo e Preencher formulário durante a execução da atividade.
Opções disponíveis para a Origem do valor
Campo do formulário
Permite utilizar o valor de um determinado campo do formulário na condição.
É possível verificar se o campo está preenchido ou comparar o valor do campo com outro valor, que pode ser um valor fixo ou o valor de outro campo do formulário.
Após selecionar a opção, preencha os campos:
- Valor: selecione o campo do formulário que será utilizado na condição. Estarão disponíveis para a seleção todos os campos do formulário que podem ser preenchidos.
- Operação: caso seja necessário refinar ou extrair uma parte do valor do campo do formulário para utilizar na condição, selecione uma operação. As opções de operação variam conforme o tipo de valor do campo de formulário.
Variável
Permite utilizar uma variável da tabela na condição.
Após selecionar a opção, preencha os campos:
- Valor: selecione a variável que será utilizada na condição. Estarão disponíveis para a seleção todas as variáveis cadastradas na tabela.
- Operação: as opções de operação variam conforme o tipo de valor da variável da tabela do formulário.
Expressão
Permite utilizar uma expressão do formulário na condição.
Após selecionar a opção, preencha os campos:
- Valor: selecione a expressão que será utilizada na condição. Estarão disponíveis para a seleção todas as expressões cadastradas no formulário.
- Operação: as opções de operação variam conforme o tipo de valor da expressão do formulário.
Função
Permite utilizar uma função do formulário na condição.
Após selecionar a opção, preencha os campos:
- Valor: selecione a função que será utilizada na condição. Estarão disponíveis para a seleção todas as funções cadastradas no formulário.
- Operação: as opções de operação variam conforme o tipo de valor da função do formulário.
Dados do usuário
Permite utilizar os dados do usuário para a condição. Os dados do usuário são provenientes do workflow onde o formulário será preenchido.
Após selecionar a opção, preencha os campos:
- Valor: selecione qual dado do usuário será utilizado na condição. Os dados disponíveis para seleção são: matrícula, nome, área ou função do usuário.
- Operação: estão disponíveis operações que permitem manipular o valor do tipo Texto proveniente dos dados do usuário.
Dados da instância do processo
Permite utilizar os dados da instância para a condição. Os dados da instância são provenientes do workflow onde o formulário será preenchido.
Após selecionar a opção, preencha os campos:
- Valor: selecione qual dado da instância será utilizado na condição. Os dados disponíveis para seleção são: identificador, título, descrição, situação, prioridade, dados da atividade, dados do solicitante ou do iniciador da atividade.
- Operação: estão disponíveis operações que permitem manipular o valor do tipo Texto proveniente dos dados da instância.
Dados da tabela relacionada
Permite utilizar os dados da tabela relacionada para a condição.
Após selecionar a opção, preencha os campos:
- Tabela: selecione em qual tabela será buscada a informação.
- Campo da tabela: selecionada em qual campo da tabela será buscada a informação.
- Operação: estão disponíveis operações que permitem manipular os valores provenientes do campo da tabela.
Data
Permite utilizar a data atual (hoje) na condição.
Após selecionar a opção, preencha os campos:
- Valor: a condição poderá utilizar a data de hoje (dd/mm/aaaa).
- Operação: estão disponíveis operações que permitem extrair um determinado valor da data (dd/mm/aaaa). É possível extrair o dia (dd), o mês (mm) ou o ano (aaaa) da data, obter o dia da semana da data (com relação ao ano) ou obter o dia da semana que corresponde à data. Note que todos os valores obtidos com as operações serão valores do tipo Inteiro.
Hora
Permite utilizar a hora atual na condição.
Após selecionar a opção, preencha os campos:
- Valor: a condição poderá utilizar a hora atual (hh:mm).
- Operação: estão disponíveis operações que permitem extrair um determinado valor da hora (hh:mm). É possível extrair as horas (hh) ou os minutos (mm) da hora, converter a hora em minutos ou converter a hora em segundos. Note que todos os valores obtidos com as operações serão valores do tipo Inteiro.
Data e hora
Permite utilizar a data e a hora atual em formato de texto na condição.
Após selecionar a opção, preencha os campos:
- Valor: a condição poderá utilizar a data (dd/mm/aaaa) e a hora atual (hh:mm).
Geolocalização
Permite utilizar os dados de geolocalização na condição.
Após selecionar a opção, preencha os campos:
- Valor: a condição poderá utilizar a longitude (graus) ou a latitude (graus).
- Operação: estão disponíveis operações que permitem armazenar os valores referentes à latitude e longitude. Esses valores poderão ser armazenados em campos do formulário e utilizadas nas integrações com APIs de mapas.
Risco
Permite utilizar os dados do risco na condição.
Após selecionar a opção, preencha os campos:
- Valor: a condição poderá utilizar dados provenientes do plano de risco, do risco, do controle, da oportunidade e da avaliação de risco.
- Operação: estão disponíveis operações que permitem manipular o valor do tipo Texto, Inteiro ou Decimal proveniente dos dados do risco.
Operações
Operações disponíveis para seleção
| Operação | Descrição | Campos |
| Maiúsculo | Selecione esta opção para utilizar o texto do campo em maiúsculo na condição. | Texto, Parágrafo, Grupo de opções e Lista simples. |
| Minúsculo | Selecione esta opção para utilizar o texto do campo em minúsculo na condição. | Texto, Parágrafo, Grupo de opções e Lista simples. |
| Remover espaços | Selecione esta opção para utilizar o texto do campo sem os espaços entre as palavras na condição, quando houver. | Texto, Parágrafo, Grupo de opções e Lista simples. |
| Ano | Selecione esta opção para utilizar na condição apenas o ano (aaaa) da data (dd/mm/aaaa) informada no campo. Por exemplo, se o valor preenchido for 31/12/2023, a condição irá utilizar o valor 2023. | Data |
| Mês | Selecione esta opção para utilizar na condição apenas o mês (mm) da data (dd/mm/aaaa) informada no campo. Por exemplo, se o valor preenchido for 31/12/2023, a condição irá utilizar o valor 12. | Data |
| Dia | Selecione esta opção para utilizar na condição apenas o dia (dd) da data (dd/mm/aaaa) informada no campo. Por exemplo, se o valor preenchido for 31/12/2023, a condição irá utilizar o valor 31. | Data |
| Dia da semana | Selecione esta opção para utilizar na condição o dia da semana da data informada no campo. Os dias da semana serão retornados como números para a condição, começando a contagem pela segunda-feira, ou seja, segunda-feira é 1, terça-feira é 2, quarta-feira é 3, quinta-feira é 4, sexta-feira é 5, sábado é 6 e domingo é 7. | Data |
| Número de semana | Selecione esta opção para utilizar o número da semana com relação ao ano na condição. Por exemplo, 40 indica que a data está na 40ª semana do ano. A contagem de semanas é iniciada na segunda-feira, ou seja, para o sistema uma semana é de segunda a domingo. | Data |
| Negar | Selecione esta opção caso seja necessário negar o valor para utilizá-lo na condição. Por exemplo, se o valor estiver marcado (verdadeiro), a condição irá utilizar o valor desmarcado (falso). | Checkbox |
| Módulo | Selecione esta opção para utilizar na condição o módulo do número informado no campo. Por exemplo, se o valor preenchido for -10, a condição irá utilizar o valor 10, ou seja, |-10| = 10. | Decimal e Inteiro |
| Raiz quadrada | Selecione esta opção para utilizar na condição a raiz quadrada do número informado no campo. Por exemplo, se o valor preenchido for 25, a condição irá utilizar o valor 5, ou seja, √25 = 5. | Decimal e Inteiro |
| Fatorial | Selecione esta opção para utilizar na condição o fatorial do número informado no campo. Por exemplo, se o valor preenchido for 5, a condição irá utilizar o valor 120, ou seja, 5! = 5 * 4 * 3 * 2 * 1 = 120. | Decimal e Inteiro |
| Arredondar para cima | Selecione esta opção para utilizar na condição o valor inteiro arredondado para cima do número informado no campo. Por exemplo, se o valor preenchido for 7,1, a condição irá utilizar o valor 8. | Decimal |
| Arredondar para baixo | Selecione esta opção para utilizar na condição o valor inteiro arredondado para baixo do número informado no campo. Por exemplo, se o valor preenchido for 7,9, a condição irá utilizar o valor 7. | Decimal |
| Arredondar | Selecione esta opção para utilizar na condição o valor arredondado do número informado no campo. Por exemplo, se o valor preenchido for 7,4, a condição irá utilizar o valor 7; porém, se o valor preenchido for 7,6, a condição irá utilizar o valor 8. | Decimal |
| Truncar | Selecione esta opção para utilizar na condição apenas a parte inteira do número informado no campo. Por exemplo, se o valor preenchido for 42,22, a condição irá utilizar o valor 42. | Decimal |
| Horas | Selecione esta opção para utilizar na condição apenas as horas (hh) do horário (hh:mm) informado no campo. Por exemplo, se o valor preenchido for 15:26, a condição irá utilizar o valor 15. | Hora |
| Minutos | Selecione esta opção para utilizar na condição apenas os minutos (mm) da hora (hh:mm) informada no campo. Por exemplo, se o valor preenchido for 15:26, a condição irá utilizar o valor 26. | Hora |
| Converter para minutos | Selecione esta opção para utilizar o valor da hora informada no campo convertido para minutos na condição. | Hora |
| Converter para segundos | Selecione esta opção para utilizar o valor da hora informada no campo convertido para segundos na condição. | Hora |
| Tradução automática | Selecione esta opção para traduzir o texto inserido no campo. | Texto, Parágrafo, Grupo de opções e Lista simples. |
Conclusão
Pronto! Agora você já sabe como criar funções no formulário. Veja como configurar expressões e regras no formulário responsivo.