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órmulas
As funções do editor de fórmula variam conforme o componente no qual é utilizado. As funções lógicas e matemáticas são usadas em todos os componentes do sistema. Veja as funções disponíveis no editor de fórmulas:
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
O SoftExpert Formulário não possui estas funções.
|
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
O SoftExpert Formulário não possui estas funções estatísticas.
|
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
As funções a seguir estão disponíveis apenas no editor de fórmulas do SoftExpert Processo.
| Fluxograma |
IDENTIFICADOR SE SUITE: função que retorna o identificador da instância do processo. 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. 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. 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. QUANTIDADE DE EXECUTORES: função que retorna a quantidade de executores de uma mesma atividade com múltiplos executores. 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. 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. 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. 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. ÁREA DO INICIADOR: função que retorna o identificador da área do iniciador do processo. VALOR DO CAMPO DE TABELA: função que retorna o valor do campo de uma tabela. VALOR DA LISTA DE TABELA: função que retorna o valor da lista de uma tabela. AÇÃO EXECUTADA: função que retorna o nome da ação executada na atividade. ÁREA DO EXECUTOR: função que retorna o identificador da área do executor da atividade. PRIORIDADE: função que retorna a prioridade. PENCENTUAL 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. 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. 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. |
| 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. 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 "|". DEFINE CAMPO DA TABELA: função que define o valor de um atributo de uma tabela de formulário do processo. DEFINE RELACIONAMENTO DA TABELA: função que define o valor de um relacionamento de uma tabela de formulário do processo. ALTERAR TÍTULO DO PROCESSO: função utilizada para definir um novo título para o processo. 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
As funções a seguir estão disponíveis apenas no editor de fórmulas do SoftExpert Formulário.
| Buscar valor |
VALOR DA LISTA DE TABELA: função que retorna o valor do campo de uma tabela. VALOR DO CAMPO DE TABELA: função que retorna o valor do campo de uma tabela. VALOR DO CAMPO COM FILTRO: função que retorna o valor da tabela. 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 NO GRUPO: função que aplica ações para um grupo de itens dentro de um fieldset. AÇÃO EM ITEM GRÁFICO: função que aplica ações para um elemento gráfico. DESABILITAR AÇÃO DA GRID: função que desabilita determinados botões da grid do formulário. HABILITAR AÇÃO DA GRID: função que habilita determinados botões da grid do formulário. EXECUTAR SCRIPT: função que executa um evento no elemento escolhido. ALTERAR LIMITE: função que altera o limite do campo de 4000 caracteres para menos. ABRIR FORMULÁRIO: função que abre o formulário em modo execução. IMPORTAR PLANILHA PARA GRID: função que atualiza uma grid com o conteúdo de uma planilha. OPERAÇÃO DO CAMPO COM FILTRO: função que retorna a operação do campo “filtro”. ALTERAR CAMPO DO COMBOBOX: função que altera o campo de um combobox. GEOLOCALIZAÇÃO: função que retorna a longitude ou latitude atual, sendo 1 para retornar a longitude e EXECUTAR QUERY: função que executa a query e atualiza os campos com o resultado da execuçã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. ABRIR ZOOM A PARTIR DA QUERY PARA ATUALIZAR GRID: função que abre uma tela e exibe o resultado |
| Mensagem |
ALERT: função que retorna um alerta na tela. CONFIRM: função que retorna uma caixa de diálogo. |
| Auxiliar |
FILTRO DE TABELA: função que retorna um objeto de filtro. 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). 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). 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). 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). 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. IDENTIFICADOR DO SE SUITE: função que retorna o identificador do processo ou do projeto ao qual o formulário foi associado. DESCRIÇÃO DO PROCESSO: função que retorna a descrição do processo. SITUAÇÃO: função que retorna a situação de automação da instância do processo. PRIORIDADE: função que retorna a prioridade. ATIVIDADE: função que retorna a atividade na qual o formulário é exibido. 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. ÁREA DO INICIADOR: função que retorna o identificador da área do iniciador do processo. FUNÇÃO DO INICIADOR: função que retorna o identificador da função do iniciador do processo. 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. EXECUTAR AÇÃO DE ATIVIDADE: função que executa a ação de mesmo nome que esteja relacionada à atividade que carregou o formulário. ALTERAR SITUAÇÃO: função que altera a situação da instância. ALTERAR PRIORIDADE: função que altera a prioridade. 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 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”. 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. CALENDÁRIO DO PROCESSO: função que retorna o identificador do calendário do processo. 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 IGUAL: função que compara duas datas e retorna VERDADEIRO caso a <Data 1> seja igual à <Data 2>. DEPOIS: função que retorna se o calendário considera a data como útil. |
| 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”. 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". 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 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/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/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". 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/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>. MÊS: função que extrai o mês da <Data>. DIA: função que extrai o dia da <Data>. DIA DA SEMANA: função que extrai o dia da semana da <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. 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. ADICIONAR HORAS: função que retorna nova data/hora, no formato “dd/mm/aaaa HH:mm:ss”, após a adição de horas. |
SoftExpert Desempenho
As funções a seguir estão disponíveis apenas no editor de fórmulas do 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. NÃO APLICÁVEL: função que define o valor da medição como não aplicável para o período do indicador. MÉDIA DOS SUBINDICADORES: função que retorna a média dos subindicadores associados ao indicador no período atual. MÉDIA PONDERADA SUBINDICADORES: função que retorna a média ponderada pelos pesos dos subindicadores associados ao indicador no período atual. SOMA DOS SUBINDICADORES: função que retorna a soma dos subindicadores associados ao indicador no período atual. 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. 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. INSTÂNCIAS CANCELADAS: função que retorna a quantidade de instâncias canceladas. 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. 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. ATIVIDADES EXECUTADAS: função que retorna a quantidade de execuções da atividade. TEMPO MÉDIO DECORRIDO DAS ATIVIDADES: função que retorna o tempo médio decorrido em minutos na execução de uma atividade. 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.