Editar fórmulas
Pré-requisito
- Acesso aos menus que possuem o editor de fórmulas nos componentes.
Apresentação
O editor de fórmulas pode ser utilizado em diversos componentes. Ainda assim, a configuração deste recurso permanece idêntica nas diferentes soluções da SoftExpert Suite.
Funções lógicas e matemáticas estão disponíveis em todos os componentes que utilizam o recurso, enquanto as textuais e temporais são exibidas em contextos específicos. Combinando diferentes funções, é possível criar fórmulas complexas que atendem a diferentes cenários.
Veja como editar fórmulas a seguir:
Editar fórmulas
Assista ao vídeo abaixo para aprender a editar fórmulas no sistema corretamente:
Funções do editor de fórmula
O editor de fórmulas possui funções que variam conforme o componente no qual é utilizado.
As funções lógicas e matemáticas são usadas em todos os componentes com editor de fórmulas.
A seguir, veja as funções disponíveis:
Lógicas
SE | função que verifica se uma condição foi satisfeita e retorna um valor se for VERDADEIRO. |
SENÃO | função que verifica se uma condição foi satisfeita e retorna um valor se for VERDADEIRO; se o valor for FALSO, retorna outro valor. |
E | função que verifica se os argumentos são VERDADEIROS e retorna VERDADEIRO. Retorna FALSO se ao menos um dos argumentos for FALSO. |
OU | função que verifica se algum argumento é VERDADEIRO e retorna VERDADEIRO ou FALSO. Retorna FALSO somente se todos os argumentos forem FALSOS. |
NÃO | função que inverte o valor lógico do argumento, ou seja, inverte FALSO para VERDADEIRO, ou VERDADEIRO para FALSO. |
FALSO | função que retorna o valor lógico FALSO. |
VERDADEIRO | função que retorna o valor lógico VERDADEIRO. |
NULO | função que retorna o valor lógico NULO. |
RETORNO | função que especifica o valor a ser retornado para a fórmula. |
ENÚM | função que verifica o valor especificado e retorna VERDADEIRO ou FALSO, a depender do resultado. Ela retornará o valor lógico VERDADEIRO se o argumento de valor for uma referência a um número. Caso contrário, ele retornará FALSO. |
Matemáticas
ALEATÓRIO | função que retorna um número aleatório maior ou igual a 0 e menor que 1. |
ALEATÓRIO ENTRE | função que retorna um número aleatório decimal entre os números especificados. |
ARREDONDAR | função que arredonda um número para o valor inteiro mais próximo. |
FATORIAL | função que retorna o fatorial de um número. |
MÓDULO | função que retorna o valor absoluto de um número. |
MULTIPLICAÇÃO | função que multiplica todos os números dados. Não há um número fixo de parâmetros. |
POTÊNCIA | função que eleva o valor à potência. |
QUOCIENTE | função que retorna a parte inteira da divisão de <Numerador> por <Denominador>. |
RAIZ QUADRADA | função que retorna a raiz quadrada de um número. |
RESTO | função que retorna o resto inteiro da divisão de <Numerador> por <Denominador>. |
SOMA | função que soma os valores. Não há um número fixo de parâmetros. |
SUBTRAÇÃO | função que subtrai os valores. Não há um número fixo de parâmetros. |
TRUNCAR | função que arredonda um número para baixo. |
MAIOR | função que retorna o maior número entre todos os números dados. Não há um número fixo de parâmetros. |
MENOR | função que retorna o menor número entre todos os números dados. Não há um número fixo de parâmetros. |
Data e hora
ANO | função que extrai o ano da <Data>. |
ANTES | função que compara duas datas e retorna VERDADEIRO caso a <Data 1> seja anterior à <Data 2>. |
DATA | função que cria uma data usando os valores de dia, mês e ano. |
DATA IGUAL | função que compara duas datas e retorna VERDADEIRO caso a <Data 1> seja igual à <Data 2>. |
DEPOIS | função que compara duas datas e retorna VERDADEIRO caso a <Data 1> seja posterior à <Data 2>. |
DIA | função que extrai o dia da <Data>. |
DIA DA SEMANA | função que extrai o dia da semana da <Data>. |
DIAS ENTRE | função que retorna o número de dias entre as datas <Data 1> e <Data 2>. |
HOJE | função que exibe a data do dia. |
MÊS | função que extrai o mês da <Data>. |
NÚMERO DA SEMANA | função que extrai o número da semana da <Data>. |
ADICIONAR DIAS | função que retorna a data de um dia útil após somar ou diminuir os dias da data inicial, conforme o calendário informado. |
ADICIONAR HORAS | função que retorna a data de um dia útil após somar ou diminuir os minutos da data inicial, conforme o calendário informado. |
SEPARAR DATA | função que retorna apenas a data no formato aaaa-mm-dd, a partir do valor de data e hora. |
SEPARAR HORA | função que retorna apenas a hora no formato hh:mm, a partir do valor de data e hora. |
Texto
ARRUMAR | função que remove os espaços do início e do final de uma sequência de caracteres, com exceção dos espaços simples entre palavras. |
EXATO | função que compara os textos de <Texto 1> e <Texto 2> e retorna VERDADEIRO caso sejam exatamente iguais, ou FALSO se forem diferentes. Esta função diferencia maiúsculas de minúsculas. |
LOCALIZAR | função que localiza a posição exata de <Texto procurado> dentro de <Texto original>. Caso o texto não seja encontrado, a posição é considerada -1. |
TRECHO | função que retorna do texto um trecho iniciando na posição <Início> e terminando na posição <Término> - as posições devem ser valores numéricos inteiros. |
MAIÚSCULA | função que altera todos os caracteres de texto para maiúsculas. |
MINÚSCULA | função que altera todos os caracteres de texto para minúsculas. |
SUBSTITUIR | função que substitui todas as ocorrências de <Texto a ser substituído> por <Novo texto> dentro do texto contido em <Texto fonte>. |
CONCATENAR | função que une textos em sequência. Não há um número fixo de parâmetros. |
Estatística
MÉDIA | função que retorna a média dos valores. Não há um número fixo de parâmetros. |
DESVIO PADRÃO | função que retorna o desvio padrão dos valores. Não há um número fixo de parâmetros. |
SoftExpert Processo
Fluxograma > IDENTIFICADOR SE SUITE | função que retorna o identificador da instância do processo. |
Fluxograma > VALOR DO ATRIBUTO | função que retorna o valor do atributo. Caso seja um atributo multivalorado, os valores selecionados serão separados por vírgula. |
Fluxograma > INICIADOR | função que retorna o usuário iniciador do processo. O <retorno> pode ser o login, a matrícula ou o nome do usuário. |
Fluxograma > SOLICITANTE | função que retorna o usuário solicitante do processo. O <retorno> pode ser o login, a matrícula ou o nome do usuário. |
Fluxograma > QUANTIDADE DE EXECUTORES | função que retorna a quantidade de executores de uma mesma atividade com múltiplos executores. |
Fluxograma > EXECUTOR |
função que retorna o usuário executor da atividade. O <retorno> pode ser o login, a matrícula ou o nome do usuário.
|
Fluxograma > DURAÇÃO REAL DA ATIVIDADE |
função que retorna a duração real da atividade em tempo corrido (desde a data de habilitação até a data de execução). O retorno pode ser em dias, horas ou minutos.
|
Fluxograma > TEMPO DECORRIDO DO PROCESSO | função que retorna o tempo decorrido do processo (desde a data de início até a data atual). O <retorno> pode ser em dias, horas ou minutos. |
Fluxograma > QUANTIDADE DE AÇÃO EXECUTADA | função que retorna a quantidade de vezes que uma ação foi tomada em uma mesma atividade executada por múltiplos executores. |
Fluxograma > ÁREA DO INICIADOR | função que retorna o identificador da área do iniciador do processo. |
Fluxograma > VALOR DO CAMPO DE TABELA | função que retorna o valor do campo de uma tabela. |
Fluxograma > VALOR DA LISTA DE TABELA | função que retorna o valor da lista de uma tabela. |
Fluxograma > AÇÃO EXECUTADA | função que retorna o nome da ação executada na atividade. |
Fluxograma > ÁREA DO EXECUTOR | função que retorna o identificador da área do executor da atividade. |
Fluxograma > PRIORIDADE | função que retorna a prioridade. |
Fluxograma > PERCENTUAL SITUAÇÃO SUBPROCESSO | função que retorna o percentual de instâncias do subprocesso encerradas com determinada situação. |
Data e hora > ADICIONAR DIAS | função que retorna a data de um dia útil após somar os dias da data inicial, conforme o calendário informado. |
Data e hora > ADICIONAR HORAS | função que retorna a hora de um dia útil após somar os minutos da data inicial, conforme o calendário informado. |
Data e hora > SEPARAR DATA | função que retorna apenas a data no formato aaaa-mm-dd a partir do valor de data e hora. |
Data e hora > SEPARAR HORA | função que retorna apenas a hora no formato hh:mm a partir do valor de data e hora. |
Duração dinâmica da atividade > DEFINE DURAÇÃO DA ATIVIDADE | função utilizada no retorno da fórmula para definir a duração da atividade, quando esta considerar duração dinâmica baseada em fórmula. |
Duração dinâmica da atividade > DEFINE DURAÇÃO DO PROCESSO | função utilizada para definir uma nova duração para o processo. O parâmetro data deve ser no formato aaaa-mm-dd. Obs.: Essa função só será executada quando o processo não possuir SLA. |
Considerar executor dinâmico para a atividade > DEFINE EXECUTOR | função utilizada no retorno da fórmula para definir o executor da atividade, quando esta considerar executor dinâmico baseado em fórmula. |
Definir dinamicamente o gestor da instância > DEFINE GESTOR INSTÂNCIA | função utilizada no retorno da fórmula para definir o gestor da instância, quando esta considerar o tipo de gestor dinâmico baseado em fórmula. |
Dados do fluxo de saída do gateway > DEFINE ATRIBUTO DO PROCESSO | função que define o valor de um atributo do processo; caso o atributo seja multivalorado, os valores devem ser separados por "|". |
Dados do fluxo de saída do gateway > DEFINE CAMPO DA TABELA | função que define o valor de um atributo de uma tabela de formulário do processo. |
Dados do fluxo de saída do gateway > DEFINE RELACIONAMENTO DA TABELA | função que define o valor de um relacionamento de uma tabela de formulário do processo. |
Dados do fluxo de saída do gateway > ALTERAR TÍTULO DO PROCESSO | função utilizada para definir um novo título para o processo. |
Dados do fluxo de saída do gateway > DEFINE DURAÇÃO DO PROCESSO | função utilizada para definir uma nova duração para o processo. O parâmetro data deve ser passado no formato aaaa-mm-dd. Obs.: Essa função só será executada quando o processo não possuir SLA. |
SoftExpert Formulário
Buscar valor > VALOR DA LISTA DE TABELA | função que retorna o valor do campo de uma tabela. |
Buscar valor > VALOR DO CAMPO DE TABELA | função que retorna o valor do campo de uma tabela. |
Buscar valor > VALOR DO CAMPO COM FILTRO | função que retorna o valor da tabela. |
Buscar valor > TOTAL DA GRID | função que retorna o valor total. |
Ação > AÇÃO | função que executa ações em itens do formulário. A quantidade de parâmetros é variável, pois depende da quantidade de variáveis para a realização do cálculo. |
Ação > AÇÃO NO GRUPO | função que aplica ações para um grupo de itens dentro de um fieldset. |
Ação > AÇÃO EM ITEM GRÁFICO | função que aplica ações para um elemento gráfico. |
Ação > DESABILITAR AÇÃO DA GRID | função que desabilita determinados botões da grid do formulário. |
Ação > HABILITAR AÇÃO DA GRID | função que habilita determinados botões da grid do formulário. |
Ação > EXECUTAR SCRIPT | função que executa um evento no elemento escolhido. |
Ação > ALTERAR LIMITE | função que altera o limite do campo de 4000 caracteres para menos. |
Ação > ABRIR FORMULÁRIO | função que abre o formulário em modo execução. |
Ação > IMPORTAR PLANILHA PARA GRID | função que atualiza uma grid com o conteúdo de uma planilha. |
Ação > OPERAÇÃO DO CAMPO COM FILTRO | função que retorna a operação do campo “filtro”. |
Ação > ALTERAR CAMPO DO COMBOBOX | função que altera o campo de um combobox. |
Ação > GEOLOCALIZAÇÃO | função que retorna a longitude ou latitude atual, sendo 1 para retornar a longitude e 2 para a latitude. |
Ação > EXECUTAR QUERY | função que executa a query e atualiza os campos com o resultado da execução. |
Ação > ABRIR ZOOM A PARTIR DA QUERY | função que abre uma tela e exibe o resultado da execução da query. Um registro pode ser selecionado para atualizar os campos do formulário. |
Ação > ABRIR ZOOM A PARTIR DA QUERY PARA ATUALIZAR GRID | função que abre uma tela e exibe o resultado da execução da query. Múltiplos registros podem ser selecionados para serem inseridos na grid do formulário. |
Mensagem > ALERT | função que retorna um alerta na tela. |
Mensagem > CONFIRM | função que retorna uma caixa de diálogo. |
Auxiliar > FILTRO DE TABELA | função que retorna um objeto de filtro. |
Auxiliar > DATA PARA NÚMERO | função que converte o parâmetro <Data> para um número Timestamp Unix. Se a <Data> estiver com formatação diferente do padrão do sistema, pode-se informar o formato no parâmetro <Formato>. Por padrão, pode-se informar ' ' (vazio). |
Auxiliar > NÚMERO PARA DATA | função que converte um <Número> Timestamp Unix para uma data no <Formato>, por exemplo, NUMEROPARADATA(1411603200; 'dd/mm/yyyy'). O parâmetro <Formato> é opcional, ou seja, pode-se passar ' ' (vazio). |
Auxiliar > HORA PARA NÚMERO | função que converte o parâmetro <Hora> para número de segundos. Se a <Hora> estiver com formatação diferente do padrão do sistema, pode-se informar o formato no parâmetro <Formato>. Por padrão, pode-se informar ' ' (vazio). |
Auxiliar > NÚMERO PARA HORA | função que converte um <Número> de segundos para uma hora no <Formato>, por exemplo, NUMEROPARAHORA(7200; 'HH:mm:ss'). O parâmetro <Formato> é opcional, ou seja, pode-se passar ' ' (vazio). |
Auxiliar > TEXTO PARA NÚMERO | função que converte o parâmetro <Texto> para um número. |
Processo > Dados do processo > TÍTULO DO PROCESSO | função que retorna o título do processo. |
Processo > Dados do processo > IDENTIFICADOR DO SE SUITE | função que retorna o identificador do processo ou do projeto ao qual o formulário foi associado. |
Processo > Dados do processo > DESCRIÇÃO DO PROCESSO | função que retorna a descrição do processo. |
Processo > Dados do processo > SITUAÇÃO | função que retorna a situação de automação da instância do processo. |
Processo > Dados do processo > PRIORIDADE | função que retorna a prioridade. |
Processo > Dados do processo > ATIVIDADE | função que retorna a atividade na qual o formulário é exibido. |
Processo > Dados do processo > FIGURA SOLICITANTE | função que retorna a informação do solicitante. Para um cliente, pode ser o nome da empresa e o nome ou o e-mail do contato. Para um usuário, pode ser o login, a matrícula, o nome de usuário, o e-mail e a área ou a função. |
Processo > Dados do usuário > INICIADOR | função que retorna o usuário iniciador do processo. O <retorno> pode ser o login, a matrícula ou o nome do usuário. |
Processo > Dados do usuário > ÁREA DO INICIADOR | função que retorna o identificador da área do iniciador do processo. |
Processo > Dados do usuário > FUNÇÃO DO INICIADOR | função que retorna o identificador da função do iniciador do processo. |
Processo > Dados do usuário > USUÁRIO LOGADO | função que retorna o usuário logado no sistema. O <retorno> pode ser o código, o login, a matrícula ou o nome do usuário. |
Processo > Ação no processo > SALVAR COMENTÁRIO | função que salva o comentário no histórico da instância do workflow, incidente ou problema. |
Processo > Ação no processo > EXECUTAR AÇÃO DE ATIVIDADE | função que executa a ação de mesmo nome que esteja relacionada à atividade que carregou o formulário. |
Processo > Ação no processo > ALTERAR SITUAÇÃO | função que altera a situação da instância. |
Processo > Ação no processo > ALTERAR PRIORIDADE | função que altera a prioridade. |
Processo > Ação no processo > CRIAR CAUSA | função que cria uma causa na instância de problema. |
Data e hora > Buscar data > HOJE | função que cria uma data que representa a data de hoje. |
Data e hora > Buscar data > DATA DO SERVIDOR | função que retorna a data do servidor. |
Data e hora > Buscar hora > TEMPO CORRENTE | função que retorna a hora atual no formato “hh:mm:ss”. |
Data e hora > Buscar hora > HORA DO SERVIDOR | função que retorna o horário do servidor. |
Data e hora > Calendário > CALENDÁRIO | função que retorna o identificador do calendário. |
Data e hora > Calendário > CALENDÁRIO DO PROCESSO | função que retorna o identificador do calendário do processo. |
Data e hora > Calendário > DATA ÚTIL | função que retorna se o calendário considera a data como útil. |
Data e hora > Criar a data/hora > DATA/HORA | função que retorna data/hora no formato “dd/mm/aaaa hh:mm>ss”. |
Data e hora > Comparar data > ANTES | função que compara duas datas e retorna VERDADEIRO caso a <Data 1> seja anterior à <Data 2>. |
Data e hora > Comparar data > DATA IGUAL | função que compara duas datas e retorna VERDADEIRO caso a <Data 1> seja igual à <Data 2>. |
Data e hora > Comparar data > DEPOIS | função que retorna se o calendário considera a data como útil. |
Data e hora > Comparar data > DIAS ENTRE | função que retorna o número de dias entre as datas <Data 1> e <Data 2>. |
Data e hora > Comparar hora > HORAS ENTRE | função que retorna o número de horas entre as horas. Os parâmetros <Hora 1> e <Hora 2> devem estar no formato “HH:mm:ss”. |
Data e hora > Comparar hora > HORAS ANTES | função que compara duas horas e retorna VERDADEIRO caso a <Hora 1> seja anterior à <Hora 2>. Os parâmetros <Hora 1> e <Hora 2> devem estar no formato "HH:mm:ss". |
Data e hora > Comparar hora > HORAS DEPOIS | função que compara duas horas e retorna VERDADEIRO caso a <Hora 1> seja posterior à <Hora 2>. Os parâmetros <Hora 1> e <Hora 2> devem estar no formato "HH:mm:ss" |
Data e hora > Comparar hora > HORA IGUAL | função que compara duas datas e retorna VERDADEIRO caso a <Data 1> seja igual à <Data 2>. Os parâmetros <Data 1> e <Data 2> devem estar no formato "HH:mm:ss". |
Data e hora > Comparar data/hora > DATA/HORA ANTES | função que compara duas datas e retorna VERDADEIRO caso a <Data 1> seja anterior à <Data 2>. Os parâmetros <Data 1> e <Data 2> devem estar no formato "dd/mm/aaaa HH:mm:ss". |
Data e hora > Comparar data/hora > DATA/HORA DEPOIS | função que compara duas datas e retorna VERDADEIRO caso a <Data 1> seja posterior à <Data 2>. Os parâmetros <Data 1> e <Data 2> devem estar no formato "dd/mm/aaaa HH:mm:ss". |
Data e hora > Comparar data/hora > DATA/HORA IGUAL | função que compara duas datas e retorna VERDADEIRO caso a <Data 1> seja igual à <Data 2>. Os parâmetros <Data 1> e <Data 2> devem estar no formato "dd/mm/aaaa HH:mm:ss". |
Data e hora > Separar data/hora > SEPARAR DATA DE DATA/HORA | função que retorna a data de <data/hora> no formato “dd/mm/aaaa”. O parâmetro deve estar no formato "dd/mm/aaaa HH:mm:ss". |
Data e hora > Separar data/hora > SEPARAR HORA DE DATA/HORA | função que retorna a hora de <data/hora> no formato “dd/mm/aaaa”. O parâmetro deve estar no formato "dd/mm/aaaa HH:mm:ss". |
Data e hora > Separar data/hora > DATA/HORA IGUAL | função que compara duas datas e retorna VERDADEIRO caso a <Data 1> seja igual à <Data 2>. Os parâmetros <Data 1> e <Data 2> devem estar no formato "dd/mm/aaaa HH:mm:ss". |
Data e hora > Separar data > ANO | função que extrai o ano da <Data>. |
Data e hora > Separar data > MÊS | função que extrai o mês da <Data>. |
Data e hora > Separar data > DIA | função que extrai o dia da <Data>. |
Data e hora > Separar data > DIA DA SEMANA | função que extrai o dia da semana da <Data>. |
Data e hora > Separar data > NÚMERO DA SEMANA | função que extrai o número da semana (dentro do ano) da <Data>. |
Data e hora > Separar hora > HORA | função que retorna o número de horas. |
Data e hora > Separar hora > MÊS | função que retorna os minutos. |
Data e hora > Acrescentar hora/dia > ADICIONAR NÚMERO DE HORAS | função que retorna nova data/hora, no formato “dd/mm/aaaa HH:mm:ss”, após a adição do número de horas. |
Data e hora > Acrescentar hora/dia > ADICIONAR HORAS | função que retorna nova data/hora, no formato “dd/mm/aaaa HH:mm:ss”, após a adição de horas. |
Data e hora > Acrescentar hora/dia > ADICIONAR DIAS | função que retorna nova data/hora, no formato “dd/mm/aaaa HH:mm:ss”, após a adição do número de dias. |
SoftExpert Desempenho
Lógica > ENÚM | função que verifica o valor especificado e retorna VERDADEIRO ou FALSO, a depender do resultado. Ela retornará o valor lógico VERDADEIRO se o argumento de valor for uma referência a um número. Caso contrário, ele retornará FALSO. |
Desempenho > ACUMULAÇÃO DINÂMICA | função que retorna o valor acumulado de um indicador com base nos parâmetros de acumulação (Vertical ou Horizontal), campos (Meta ou Realizado), operação (Soma ou Média) e períodos selecionados. |
Desempenho > NÃO APLICÁVEL | função que define o valor da medição como não aplicável para o período do indicador. |
Desempenho > INDICADOR | função que retorna o campo do indicador selecionado (Meta, Medição, Meta acumulada, Medição acumulada) no período atual. |
Desempenho > MÉDIA DOS SUBINDICADORES | função que retorna a média dos subindicadores associados ao indicador no período atual. |
Desempenho > MÉDIA PONDERADA SUBINDICADORES | função que retorna a média ponderada pelos pesos dos subindicadores associados ao indicador no período atual. |
Desempenho > SOMA DOS SUBINDICADORES | função que retorna a soma dos subindicadores associados ao indicador no período atual. |
Desempenho > DATA DE INÍCIO DO PERÍODO | função que retorna a data de início do período que está sendo calculado, com base na frequência do indicador. |
Desempenho > DATA DE FIM DO PERÍODO | função que retorna a data final do período que está sendo calculado, com base na frequência do indicador. |
Analytics > NÚMERO | função que retorna o valor de uma visão do tipo número de um painel de análises do componente Analytics. O valor será distribuído pelos períodos do indicador de acordo com a sua frequência e com o campo de referência. |
Processo > INSTÂNCIAS INICIADAS | função que retorna a quantidade de instâncias iniciadas. |
Processo > INSTÂNCIAS FINALIZADAS | função que retorna a quantidade de instâncias finalizadas. |
Processo > INSTÂNCIAS CANCELADAS | função que retorna a quantidade de instâncias canceladas. |
Processo > TEMPO MÉDIO CORRIDO DAS INSTÂNCIAS | função que retorna o tempo médio corrido em minutos entre o início e o término das instâncias. |
Processo > TEMPO MÉDIO EM HORA ÚTIL DAS INSTÂNCIAS | função que retorna o tempo médio corrido em minutos baseado em horas úteis, entre o início e o término das instâncias. |
Processo > ATIVIDADES EXECUTADAS | função que retorna a quantidade de execuções da atividade. |
Processo > TEMPO MÉDIO DECORRIDO DAS ATIVIDADES | função que retorna o tempo médio decorrido em minutos na execução de uma atividade. |
Processo > TEMPO MÉDIO ÚTIL DAS ATIVIDADES | função que retorna o tempo médio útil em minutos gasto da execução de uma atividade. |
Conclusão
Desta maneira, uma fórmula pode ser editada e criada para realizar ações no sistema.