|
Estas fórmulas são apresentadas quando o editor de fórmulas estiver sendo acessado no componente SE Formulário. No SE Formulário estas funções serão apresentadas ao editar uma fórmula para algum campo de formulário ou para um formulário associado em algum processo.
Formulário
Funções que retornam valores da tabela:
▪VALOR DA LISTA DE TABELA: Retorna o valor do campo de uma tabela.
Sintaxe:
|
VALORLISTA('<identificador da tabela>';'<identificador do relacionamento>';'<identificador do campo>')
|
▪VALOR DO CAMPO DE TABELA: Retorna o valor do campo de uma tabela.
Sintaxe:
|
VALORCAMPO('<identificador da tabela>';'<identificador do campo>')
|
▪VALOR DO CAMPO COM FILTRO: Retorna o valor da tabela.
Sintaxe:
|
VALORCAMPOFILTRO('<identificador da tabela>';'<identificador do campo>';'<filtro>')
|
▪TOTAL DA GRID: Retorna o valor total.
Sintaxe:
|
TOTALGRID('<identificador do relacionamento>';'<identificador da tabela>';'<identificador do campo>';'<operação>')
|
|
Funções que executam alguma ação em itens do formulário:
▪AÇÃO: A quantidade de parâmetros é variável, pois depende da quantidade de variáveis para a realização do cálculo.
Sintaxe:
|
ACAO('<lista de identificadores do campo>';'<lista de identificadores do campo>';'<lista de identificadores do campo>';'<lista de identificadores do campo>';'<lista de identificadores do campo>'; ... ;'<quantidade de parâmetros variável>')
|
▪AÇÃO NO GRUPO: Aplica ações (habilitar, desabilitar, etc.) para um grupo de itens dentro de um fieldset.
Sintaxe:
|
ACAOGRUPO('<identificador do campo>';'<operação>';'<valor>')
|
▪AÇÃO EM ITEM GRÁFICO: Aplica ações (habilitar, desabilitar, etc.) para um elemento gráfico. Exemplo: Fieldset, imagem, etc.
Sintaxe:
|
ACAOITEMGRAFICO ('<identificador do campo>';'<operação>';'<valor>')
|
▪DESABILITAR AÇÃO DA GRID: Desabilita determinados botões da grid do formulário.
Sintaxe:
|
DESABILITARACAOGRID('<identificador da grid>';'<botões da grid que serão desabilitados (Ex:Incluir,Alterar,Excluir)>')
|
▪HABILITAR AÇÃO DA GRID: Habilita determinados botões da grid do formulário.
Sintaxe:
|
HABILITARACAOGRID('<identificador da grid>';'<botões da grid que serão habilitados (Ex:Incluir,Alterar,Excluir)>')
|
▪EXECUTAR SCRIPT: Executa um evento no elemento escolhido
Sintaxe:
|
EXECUTESCRIPT('<Identificador>';'<Evento>')
|
|
▪ALTERAR LIMITE: Altera o limite do campo (textarea/memo) de 4000 caracteres para menos.
Sintaxe:
|
ALTERARLIMITE ('<identificador do campo>';'<valor>')
|
▪ABRIR FORMULÁRIO: Abre o formulário em modo execução.
Sintaxe:
|
ABRIRFORMULARIO('<Identificador do formulário>')
|
|
▪IMPORTAR PLANILHA PARA GRID: Atualiza uma grid com o conteúdo de uma planilha.
Sintaxe:
|
IMPORTARPLANILHAPARAGRID('<Identificador do relacionamento da grid>';'<Lista da relação entre os atributos da tabela e as colunas da planilha (Ex: ATR01=A,ATR02=D, ATR03=E)>';'<Limpar a grid antes da importação? (Ex: VERDADEIRO|FALSO)>';'<Linha inicial da planilha>';'<Linha final da planilha>';'<Nome da planilha>')
|
▪OPERAÇÃO DO CAMPO COM FILTRO: Retorna a operação do campo filtro.
Sintaxe:
|
OPERACAOCAMPOFILTRO('<identificador da tabela>';'<identificador do campo>';'<operação>';'<filtro>')
|
▪ALTERAR CAMPO DO COMBOBOX: Altera o campo de um combobox.
Sintaxe:
|
ALTERARCAMPOCOMBOBOX('<Identificador do combobox>';'<Identificador do atributo da tabela>')
|
▪GEOLOCALIZAÇÃO: Retorna a longitude ou latitude atual, sendo 1 para retornar a longitude e 2 para a latitude.
Sintaxe:
|
GEOLOCALIZACAO('<1 ou 2>';'<Identificador do campo>')
|
▪EXECUTAR QUERY: Executa a query e atualiza os campos com o resultado da execução.
Sintaxe:
|
QUERYEXECUTE(<Identificador da query previamente cadastrada: ex: listausuario>;<Persistir valores: ex: FORMFIELD1=CODE, FORMFIELD2=NAME>)
|
▪ABRIR ZOOM A PARTIR DA QUERY: Abre uma tela e exibe o resultado da execução da query. Um registro pode ser selecionado para atualizar os campos do formulário.
Sintaxe:
|
QUERYZOOM(<Identificador da query previamente cadastrada: ex: listausuario>;<Persistir valores: ex: FORMFIELD1=CODE, FORMFIELD2=NAME>;<Colunas: ex: CODE, NAME>)
|
▪ABRIR ZOOM A PARTIR DA QUERY PARA ATUALIZAR GRID: Abre uma tela e exibe o resultado da execução da query. Múltiplos registros podem ser selecionados para inserir na grid do formulário.
Sintaxe:
|
QUERYZOOMTOGRID(<Identificador da query previamente cadastrada: ex: listausuario>;<Identificador do relacionamento da grid: ex: Rel01>;<De/Para campos do zoom que serão inclusos nas colunas da grid: ex: FORMFIELD1=CODE, FORMFIELD2=NAME>;<Limpar a grid antes da atualização? ex: VERDADEIRO | FALSO>;<Colunas: ex: CODE, NAME>)
|
|
Funções que exibem mensagens no formulário:
▪ALERT: Retorna um alerta na tela.
Sintaxe:
|
ALERT('<valor>')
|
▪CONFIRM: Retorna uma caixa de diálogo.
Sintaxe:
|
CONFIRM('<parâmetro>')
|
|
Funções que fazem conversões de informações no formulário:
▪FILTRO DE TABELA: Retorna um objeto de filtro
Sintaxe:
|
FILTROTABELA('<identificador da tabela>';'<identificador do campo>';'<valor>')
|
▪DATA PARA NÚMERO: 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).
Sintaxe:
|
DATAPARANUMERO('<Data>';'<Formato>')
|
▪NÚMERO PARA DATA: Converte um <Número> Timestamp Unix para uma data no <Formato>, por exemplo, NUMEROPARADATA(1411603200; 'dd/mm/yyyy'). Parâmetro <Formato> é opcional, ou seja, pode-se passar ' ' (vazio).
Sintaxe:
|
NUMEROPARADATA('<Número>';'<Formato>')
|
▪HORA PARA NÚMERO: 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).
Sintaxe:
|
HORAPARANUMERO('<Hora>';'<Formato>')
|
▪NÚMERO PARA HORA: Converte um <Número> de segundos para uma hora no <Formato>, por exemplo, NUMEROPARAHORA(7200; 'HH:mm:ss'). Parâmetro <Formato> é opcional, ou seja, pode-se passar ' ' (vazio).
Sintaxe:
|
NUMEROPARAHORA('<Número>';'<Formato>')
|
▪TEXTO PARA NÚMERO: Converte o parâmetro <Texto> para um número.
Sintaxe:
|
TEXTOPARANUMERO('<Texto>')
|
|
Processo
Funções que retornam informações sobre a instância do processo (Workflow, Incidente ou Problema):
▪TÍTULO DO PROCESSO: Retorna o título do processo.
Sintaxe:
|
TITULOPROCESSO()
|
▪IDENTIFICADOR SE SUITE: Retorna o identificador do processo (Workflow, Incidente, Problema) ou do projeto (SE Projeto) onde o formulário foi associado.
Sintaxe:
|
IDENTIFICADORSESUITE()
|
▪DESCRIÇÃO DO PROCESSO: Retorna a descrição do processo.
Sintaxe:
|
DESCRICAOPROCESSO()
|
▪SITUAÇÃO: Retorna a situação de automação da instância do processo. O <retorno> pode ser "Identificador" ou "Nome".
Sintaxe:
|
SITUACAO('<retorno>')
|
▪PRIORIDADE: Retorna a prioridade. O <retorno> pode ser "Nome", "Ordem" ou "Valor".
Sintaxe:
|
PRIORIDADE('<retorno>')
|
▪ATIVIDADE: Retorna a atividade onde formulário é mostrado. O <retorno> pode ser "Identificador" ou "Nome da atividade".
Sintaxe:
|
ATIVIDADE('<retorno>')
|
▪FIGURA SOLICITANTE: Retorna a informação do solicitante. Para cliente pode ser o nome da empresa, nome do contato ou e-mail do contato. Para usuário pode ser login, matrícula, nome de usuário, e-mail, área ou função.
Sintaxe:
|
FIGURASOLICITANTE('<Figura>';'<Retorno>')
|
▪DEFINE ATRIBUTO DO PROCESSO: Define o valor de um atributo do processo, caso o atributo seja multivalorado, os valores devem ser separados por "|". Exemplo: valor1|valor2|valor3.
Sintaxe:
|
DEFINEATRIBUTOPROCESSO(<identificador do atributo>; <valor do atributo>)
|
|
▪INICIADOR: Retorna o usuário iniciador do processo. O <retorno> pode ser o "login", "matrícula" ou "nome do usuário".
Sintaxe:
|
INICIADOR('<retorno>')
|
▪ÁREA DO INICIADOR: Retorna o identificador da área do iniciador do processo.
▪FUNÇÃO DO INICIADOR: Retorna o identificador da função do iniciador do processo.
Sintaxe:
|
FUNCAOINICIADOR()
|
▪USUÁRIO LOGADO: Retorna o usuário logado no sistema. O <retorno> pode ser "código", "login", "matrícula" ou "nome do usuário".
Sintaxe:
|
USUARIOLOGADO('<retorno>')
|
▪ATRIBUTO DO USUÁRIO LOGADO: Retorna o valor de um atributo associado ao usuário logado no sistema.
Sintaxe:
|
ATRIBUTODOUSUARIOLOGADO('retorno')
|
|
▪SALVAR COMENTÁRIO: Salva o <comentário> no histórico da instância do workflow, incidente ou problema.
Sintaxe:
|
SALVARCOMENTARIO('<comentário>')
|
▪EXECUTAR AÇÃO DE ATIVIDADE: Executa a ação com o mesmo nome e que esteja relacionada a atividade que carregou o formulário.
Sintaxe:
|
EXECUTEACAOATIVIDADE('<Nome da ação>')
|
▪ALTERAR SITUAÇÃO: Altera a situação da instância.
Sintaxe:
|
ALTERARSITUACAO('<identificador da situação>')
|
|
▪ALTERAR PRIORIDADE: Seta o <valor da prioridade> na instância
Sintaxe:
|
ALTERARPRIORIDADE('<método de avaliação>';'<identificação da prioridade>';'<valor da prioridade>')
|
▪CRIAR CAUSA: Cria uma causa na instância de problema.
Sintaxe:
|
CRIARCAUSA('<identificador da causa>';'<nome da causa>';'<tipo da causa>')
|
|
DATA/HORA
▪HOJE: Cria uma data representada a data de hoje.
▪DATA DO SERVIDOR: Retorna a data do servidor.
|
▪TEMPO CORRENTE: Retorna a hora atual no formato 'HH:mm:ss'.
▪HORA DO SERVIDOR: Retorna o horário do servidor.
|
▪CALENDÁRIO: Retorna o identificador do calendário.
▪CALENDÁRIO DO PROCESSO: Retorna o identificador do calendário do processo.
Sintaxe:
|
CALENDARIOPROCESSO()
|
▪DATA ÚTIL: Retorna se o calendário considera a data como útil
Sintaxe:
|
DATAUTIL('<data>';'<código do calendário>')
|
|
▪DATA/HORA: Retorna data/hora no formato 'dd/mm/yyyy HH:mm:ss'.
Sintaxe:
|
DATAHORA('<data>';'<hora>')
|
|
▪ANTES: Compara duas datas e retorna VERDADEIRO caso a <Data 1> seja anterior à <Data 2>; caso contrário retorna FALSO.
Sintaxe:
|
ANTES('<Data 1>';'<Data 2>')
|
▪DATA IGUAL: Compara duas datas e retorna VERDADEIRO caso <Data 1> seja igual à <Data 2>, caso contrário, retorna FALSO.
Sintaxe:
|
DATAIGUAL('<Data 1>';'<Data 2>')
|
▪DEPOIS: Compara duas datas e retorna VERDADEIRO caso <Data 1> seja posterior à <Data 2>, caso contrário, retorna FALSO.
Sintaxe:
|
DEPOIS('<Data 1>';'<Data 2>')
|
▪DIAS ENTRE: Retorna o número de dias entre as datas <Data 1> e <Data 2>.
Sintaxe:
|
DIASENTRE('<Data 1>';'<Data 2>')
|
|
▪HORAS ENTRE: Retorna o número de horas entre as horas <Hora 1> e <Hora 2>. Os parâmetros <Hora 1> e <Hora 2> devem estar no formato "HH:mm:ss".
Sintaxe:
|
HORASENTRE('<Hora 1>';'<Hora 2>')
|
▪HORAS ANTES: Compara duas horas e retorna VERDADEIRO caso <Hora 1> seja anterior à <Hora 2>, caso contrário, retorna FALSO. Os parâmetros <Hora 1> e <Hora 2> devem estar no formato "HH:mm:ss".
Sintaxe:
|
HORA_ANTES('<Hora 1>';'<Hora 2>')
|
▪HORAS DEPOIS: Compara duas horas e retorna VERDADEIRO caso <Hora 1> seja posterior à <Hora 2>, caso contrário, retorna FALSO. Os parâmetros <Hora 1> e <Hora 2> devem estar no formato "HH:mm:ss".
Sintaxe:
|
HORA_DEPOIS('<Hora 1>';'<Hora 2>')
|
▪HORA IGUAL: Compara duas datas e retorna VERDADEIRO caso <Data 1> seja igual à <Data 2>, caso contrário, retorna FALSO. Os parâmetros <Data 1> e <Data 2> devem estar no formato "HH:mm:ss".
Sintaxe:
|
DATAHORA_IGUAL('<Hora 1>';'<Hora 2>')
|
|
▪DATA/HORA ANTES: Compara duas datas e retorna VERDADEIRO caso <Data 1> seja anterior à <Data 2>, caso contrário, retorna FALSO. Os parâmetros <Data 1> e <Data 2> devem estar no formato "dd/mm/yyyy HH:mm:ss".
Sintaxe:
|
DATAHORA_ANTES('<Data 1>';'<Data 2>')
|
▪DATA/HORA DEPOIS: Compara duas datas e retorna VERDADEIRO caso <Data 1> seja posterior à <Data 2>, caso contrário, retorna FALSO. Os parâmetros <Data 1> e <Data 2> devem estar no formato "dd/mm/yyyy HH:mm:ss".
Sintaxe:
|
DATAHORA_DEPOIS('<Data 1>';'<Data 2>')
|
▪DATA/HORA IGUAL: Compara duas datas e retorna VERDADEIRO caso <Data 1> seja igual à <Data 2>, caso contrário, retorna FALSO. Os parâmetros <Data 1> e <Data 2> devem estar no formato "dd/mm/yyyy HH:mm:ss".
Sintaxe:
|
DATAHORA_IGUAL('<Data 1>';'<Data 2>')
|
|
▪SEPARAR DATA DE DATA/HORA: Retorna a data de <data/hora> no formato "dd/mm/yyyy". O parâmetro <data/hora> deve estar no formato "dd/mm/yyyy HH:mm:ss".
Sintaxe:
|
DATAHORA_DATA('<data/hora>')
|
▪SEPARAR HORA DE DATA/HORA: Retorna a hora de <data/hora> no formato "HH:mm:ss". O parâmetro <data/hora> deve estar no formato "dd/mm/yyyy HH:mm:ss".
Sintaxe:
|
DATAHORA_HORA('<data/hora>')
|
|
▪ANO: Extrai o ano da <Data>.
▪MÊS: Extrai o mês da <Data>.
▪DIA: Extrai o dia da <Data>.
▪DIA DA SEMANA: Extrai o dia da semana da <Data>.
Sintaxe:
|
DIADASEMANA('<Data>')
|
▪NÚMERO DA SEMANA: Extrai o número da semana (dentro do ano) da <Data>.
Sintaxe:
|
NUMSEMANA('<Data>')
|
|
▪HORA: Retorna o número de horas.
▪MINUTO: Retorna os minutos.
Sintaxe:
|
MINUTO('<hora>')
|
|
▪ADICIONAR NÚMERO DE HORAS: Retorna nova data/hora, no formato "dd/mm/yyyy HH:mm:ss", após adição de número de horas. O parâmetro <data/hora> deve estar no formato "dd/mm/yyyy HH:mm:ss".
Sintaxe:
|
ADICIONANRHORAS('<data/hora>';'<número>';'<calendário>')
|
▪ADICIONAR HORAS: Retorna nova data/hora, no formato "dd/mm/yyyy HH:mm:ss", após adição de horas. O parâmetro <data/hora> deve estar no formato "dd/mm/yyyy HH:mm:ss".
Sintaxe:
|
ADICIONARHORAS('<data/hora>';'<horas>';'<calendário do processo>')
|
▪ADICIONAR DIAS: Retorna nova data/hora, no formato "dd/mm/yyyy HH:mm:ss", após adição de número de dias. O parâmetro <data/hora> deve estar no formato "dd/mm/yyyy HH:mm:ss".
Sintaxe:
|
ADICIONARDIAS('<data/hora>';'<dias>';'<calendário do processo>')
|
|
|
