Nesta página
> recursos > documentação > expressões > Expression Editor

Expression Editor

Expression Editor

O Expression Editor é a ferramenta integrada do ProcessMind para escrever expressões. Ele é aberto onde quer que expressões sejam usadas, como em atributos de conjuntos de dados, filtros de conjuntos de dados e definições de métricas, e funciona sempre da mesma forma: escreva, valide e visualize antes de salvar.

Expression Editor no ProcessMind

Onde você pode abri-lo

Aberto em O que você está editando
Dataset → Atributos → célula Mapeamento / expressão um atributo calculado
Dataset → Geral → Filtro global do dataset → Adicionar expressão de filtro… um filtro de linha aplicado antes da mineração
Configurações do gráfico → Expressão da métrica → Usar expressão da métrica… uma expressão de métrica avaliada por linha
Configurações do gráfico → Métricas secundárias → Expressão… uma expressão de métrica secundária
Configurações do gráfico → Texto / chip Html texto do gráfico: texto literal e HTML com ${ ... } expressões
Configurações do gráfico → Configurações da norma → ƒ → expressão de Início / Fim um limite de norma resolvido a partir das constantes de Configurações do processo

O título da caixa de diálogo indica o que você está editando, por exemplo, Edit Expression: {attribute name} ou Expressão de filtro de linhas.

Escrevendo uma expressão

  • O campo de entrada destaca a sintaxe enquanto você digita: funções, atributos, constantes, propriedades do caso e referências de linhas recebem cores próprias, e os erros de análise são sublinhados em vermelho.
  • Pressione Ctrl/Cmd+Space para abrir as sugestões, que não são abertas automaticamente. Enter ou Aba aplica o item selecionado; Esc fecha a lista.
  • Passe o mouse sobre qualquer token para ver a documentação: as funções mostram a assinatura, a descrição e um exemplo; os atributos mostram o tipo.
  • Dentro de uma chamada de função, a ajuda da assinatura mostra o parâmetro que você está preenchendo.
  • Os botões Desfazer e Refazer ficam no cabeçalho, com Ctrl/Cmd+Z, Shift+Ctrl/Cmd+Z e Ctrl/Cmd+Y como atalhos.

Painel de referência

O painel Selecione elementos para criar sua expressão lista tudo o que você pode usar, agrupado em seções:

  • Atributos: os atributos do seu conjunto de dados. Clique em um deles para inseri-lo.
  • Constantes: constantes de todo o processo definidas em Configurações do processo.
  • Funções: agrupadas por categoria, cada uma com uma dica de ferramenta que mostra sua assinatura, descrição e exemplo. Clicar insere o nome da função com parênteses.
  • Propriedades do caso e Referências de linhas: clique em uma referência de linha para inserir previous. e começar a criar uma comparação com a linha anterior.

A caixa de pesquisa encontra nomes, assinaturas, descrições e exemplos, além de entender a intenção: digitar “dias entre” ou “soma com condição” exibe as funções correspondentes. O ícone de ajuda no cabeçalho abre a documentação da linguagem de expressões.

Prévia

Para atributos e métricas, o editor mostra uma prévia em tempo real de Principais valores por ocorrência, que é atualizada enquanto você digita: os resultados mais frequentes com suas contagens, além dos intervalos null e other, com até 20 valores. Enquanto a prévia é executada, você vê Executando a prévia da expressão…; em caso de erro, aparece Corrija a expressão para ver uma prévia. Filtros de linhas não são compatíveis com prévia. Nesse caso, o editor informa isso.

Templates de texto do gráfico

O texto do gráfico (gráficos de texto, KPIs, medidores e frames HTML) é um Template: o texto literal permanece como foi escrito, e cada segmento ${ ... } é avaliado. O editor valida cada segmento e o destaca enquanto você escreve. Texto, Html, expressões de métrica e expressões de norma só são aplicados quando você fecha o editor com Salvar; Cancelar descarta o rascunho. O texto simples do gráfico e o HTML não podem ser avaliados por linha, por isso o editor mostra A visualização não está disponível para o texto do gráfico em vez da visualização do valor.

As expressões de norma são resolvidas com base nas constantes de Configurações do processo (por exemplo, slaTargetDays * 86400000), por isso o editor oferece constantes e funções, mas não atributos do conjunto de dados nesse contexto.

Validação e salvamento

A validação é executada continuamente enquanto você edita. A linha de status na parte inferior da caixa de diálogo mostra uma confirmação verde de A expressão é válida ou um erro em vermelho, como Erro na posição 12: esperava ‘)’ mas encontrou …. Os erros mais comuns incluem funções ou variáveis desconhecidas, quantidade incorreta de argumentos, strings não fechadas e incompatibilidade de tipos.

Salvar permanece desativado enquanto a expressão for inválida ou houver restrições de filtro de linhas. Limpar o campo e salvar remove a expressão. Pressione Ctrl/Cmd+Enter para salvar pelo teclado ou Cancelar para fechar sem salvar.

Abrindo expressões relacionadas em abas

As expressões podem fazer referência a outros atributos calculados. Para inspecionar um deles enquanto edita, use Ctrl/Cmd+clique na referência do atributo em sua expressão. Ela será aberta em uma aba própria, somente para leitura. A barra de abas aparece assim que existe uma segunda aba, e a prévia acompanha a aba que você está visualizando.

Filtros de linhas: permitidos e bloqueados

Um filtro de linhas é executado em cada linha de evento bruta quando os dados são carregados, antes da mineração. Somente as linhas em que a expressão é verdadeira são mantidas; resultados falsos, vazios e nulos são removidos. Esse contexto limita o que você pode usar:

  • Permitido: os próprios valores da linha, ou seja, os atributos do conjunto de dados e os aliases de colunas integrados (caseid, time, activity, cost, user, start_time e co2).
  • Bloqueado: tudo o que exige contexto do caso ou de outras linhas, como propriedades do caso, agregações do caso e funções de janela, referências de linhas (previous.), consultas de atividades como first() e expressões followedBy.

Se você usar um elemento bloqueado, Salvar ficará desativado e a mensagem será exibida: “Os filtros de linhas só podem usar dados brutos da linha. Remova propriedades do caso, agregações do caso, referências de linhas, consultas de atividades ou expressões de sequência posterior.”

Tópicos relacionados