Editor de expresiones

El Editor de expresiones es la herramienta integrada de ProcessMind para escribir expresiones. Se abre allí donde se utilizan expresiones, como en los atributos de conjuntos de datos, los filtros de conjuntos de datos y las definiciones de métricas, y siempre funciona de la misma manera: escriba, valide y previsualice antes de guardar.

Dónde puede abrirlo

Abrir desde	Qué está editando
Dataset → Atributos → celda Asignación / expresión	un atributo calculado
Dataset → General → Filtro global del conjunto de datos → Añadir expresión de filtro…	un filtro de filas aplicado antes del Process Mining
Configuración del gráfico → Expresión de métrica → Usar expresión de métrica…	una expresión de métrica evaluada por fila
Configuración del gráfico → Métricas secundarias → Expresión…	una expresión de métrica secundaria
Configuración del gráfico → Texto / Html	texto del gráfico: texto literal y HTML con `${ ... }` expresiones
Configuración del gráfico → Configuración de normas → ƒ → Inicio / Fin	un límite de norma obtenido de las constantes de Configuración del proceso

El título del cuadro de diálogo refleja lo que está editando, por ejemplo, Edit Expression: {attribute name} o Expresión de filtro de filas.

Escribir una expresión

La entrada resalta la sintaxis a medida que escribe: las funciones, los atributos, las constantes, las propiedades del caso y las referencias a filas tienen cada uno su propio color, y los errores de análisis aparecen subrayados en rojo.
Pulse Ctrl/Cmd+Space para abrir las sugerencias, que no se abren automáticamente. Enter o Pestaña aplica el elemento seleccionado; Esc cierra la lista.
Coloque el cursor sobre cualquier elemento para consultar la documentación: las funciones muestran su firma, descripción y un ejemplo; los atributos muestran su tipo.
Dentro de una llamada de función, la ayuda de firma muestra el parámetro que está completando.
Los botones Deshacer y Rehacer se encuentran en el encabezado; Ctrl/Cmd+Z, Shift+Ctrl/Cmd+Z y Ctrl/Cmd+Y son sus atajos.

El panel de referencia

El panel Seleccione elementos para crear su expresión muestra todo lo que puede utilizar, agrupado en secciones:

Atributos: los atributos de su conjunto de datos. Haga clic en uno para insertarlo.
Constantes: constantes de todo el proceso definidas en Configuración del proceso.
Funciones: agrupadas por categoría; cada una incluye una descripción emergente con su firma, descripción y ejemplo. Al hacer clic, se inserta el nombre de la función con paréntesis.
Propiedades del caso y referencias a filas: haga clic en una referencia a fila para insertar previous. y comenzar a crear una comparación con la fila anterior.

El cuadro de búsqueda encuentra nombres, firmas, descripciones y ejemplos, y entiende la intención: al escribir “days between” o “sum with condition” se muestran las funciones correspondientes. El icono de ayuda del encabezado abre la documentación del lenguaje de expresiones.

Vista previa

Para los atributos y las métricas, el editor muestra una vista previa en tiempo real de Valores principales por ocurrencia que se actualiza mientras escribe: los resultados más frecuentes con sus recuentos, además de los intervalos null y other (hasta 20 valores). Mientras se ejecuta la vista previa, aparece Ejecutando la vista previa de la expresión…; si hay errores, aparece Corrija la expresión para ver una vista previa. Los filtros de filas no admiten vista previa; el editor lo indica.

Plantillas de texto del gráfico

El texto del gráfico (gráficos de texto, KPI, indicadores y marcos HTML) es una plantilla: el texto literal se mantiene tal como está escrito y cada segmento ${ ... } se evalúa. El editor valida cada segmento y lo resalta mientras escribe. Texto, Html, las expresiones de métrica y las expresiones de normas solo se aplican cuando cierra el editor con Guardar; Cancelar descarta el borrador. El texto simple del gráfico y el HTML no pueden evaluarse por fila, por lo que el editor muestra La vista previa no está disponible para el texto del gráfico en lugar de la vista previa del valor.

Las expresiones de normas se resuelven con las constantes de Configuración del proceso, por ejemplo slaTargetDays * 86400000, por lo que el editor ofrece constantes y funciones, pero no atributos del conjunto de datos.

Validación y guardado

La validación se ejecuta continuamente mientras edita. La línea de estado situada en la parte inferior del cuadro de diálogo muestra una marca verde de La expresión es válida o un error en rojo, como Error en la posición 12: se esperaba ‘)’ pero se obtuvo …. Entre los errores habituales se incluyen funciones o variables desconocidas, un número incorrecto de argumentos, cadenas sin cerrar y tipos incompatibles.

Guardar permanece desactivado mientras la expresión no sea válida o se apliquen restricciones de los filtros de filas; al borrar el campo y guardar, se elimina la expresión. Pulse Ctrl/Cmd+Enter para guardar con el teclado o Cancelar para cerrar sin guardar.

Abrir expresiones relacionadas en pestañas

Las expresiones pueden hacer referencia a otros atributos calculados. Para consultar uno mientras edita, haga Ctrl/Cmd+clic en la referencia al atributo de su expresión; se abrirá en su propia pestaña de solo lectura. La barra de pestañas aparece en cuanto existe una segunda pestaña, y la vista previa sigue la pestaña que está consultando.

Filtros de filas: permitidos y bloqueados

Un filtro de filas se ejecuta en cada fila de evento sin procesar cuando se cargan los datos, antes del Process Mining. Solo se conservan las filas cuya expresión es verdadera; los resultados falsos, vacíos y nulos se eliminan. Este contexto limita lo que puede utilizar:

Permitido: los valores de la propia fila: los atributos del conjunto de datos y los alias de columna integrados (caseid, time, activity, cost, user, start_time y co2).
Bloqueado: todo lo que necesite contexto del caso o de varias filas: propiedades del caso, agregaciones del caso y funciones de ventana, referencias a filas (previous.), búsquedas de actividades como first() y expresiones followedBy.

Si utiliza un elemento bloqueado, Guardar se desactiva y aparece el mensaje: “Los filtros de filas solo pueden utilizar datos sin procesar de la fila. Elimine las propiedades del caso, las agregaciones del caso, las referencias a filas, las búsquedas de actividades o las expresiones de seguimiento.”

Temas relacionados

Lenguaje de expresiones: referencia completa de las funciones.
Introducción a las expresiones: conceptos básicos de sintaxis y ejemplos.
Atributos calculados: atributos creados a partir de expresiones.
Uso de filtros: filtrado de Dashboards y del grafo de procesos.
Gráficos de procesos: dónde se configuran las expresiones de métricas.

Editor de expresiones