conformidad de uip pm, desviaciones de uip pm, consulta de uip pm

Sintaxis y opciones para analizar una aplicación de Process Mining (tasa de conformidad, desviaciones aceptadas y consultas de datos ad hoc) con `conformidad de uip pm`, `desviaciones de uip pm` y `consulta de uip pm`.

Parte de la herramienta uip pm . conformance y deviations son capas de comodidad sobre query: resuelven los ID de campo de conformidad interna de la aplicación por ti y responden en términos sencillos. query es la vía de escape de propósito general para cualquier cosa que estos dos no cubran.

Nota:

conformance y deviations solo funcionan en una aplicación basada en modelo (--miner inductive o bpmn en apps create, o un modelo de referencia BPMN cargado a través de conformance upload-model). Una aplicación directly-follows no tiene modelo de referencia ni datos de conformidad: todos los verbos de este grupo fallan con un error explícito al nombrar al minero.

Sinopsis

uip pm conformance rate <app-id> [--process-id <id>] [--stage dev|published]
uip pm conformance activities <app-id> [--process-id <id>] [--stage dev|published]
uip pm conformance transitions <app-id> [--process-id <id>] [--stage dev|published]
uip pm conformance deviations <app-id> [--process-id <id>] [--stage dev|published]
uip pm conformance upload-model <app-id> <bpmn-file> [--process-id <id>]

uip pm deviations list <app-id> [--process-id Process] [--stage dev|published]
uip pm deviations accept <app-id> --type <type> --activities <activities...> [--process-id Process]
uip pm deviations delete <app-id> --type <type> --activities <activities...> [--process-id Process]
uip pm deviations delete-all <app-id> -y [--process-id Process]

uip pm query run <app-id> [--body <file> | --body-json <json> | --group-by <cols> --metric <col:fn[:alias]>...] [--process-graph] [--conformance] [--limit <n>] [--stage dev|published]
uip pm query details <app-id> [--body <file> | --body-json <json>] [--limit <n>] [--stage dev|published]
uip pm query rca <app-id> [--body <file> | --body-json <json>] [--limit <n>] [--stage dev|published]
uip pm query insights <app-id> [--body <file> | --body-json <json>] [--limit <n>] [--stage dev|published]
uip pm query info <app-id> [--stage dev|published]
uip pm query layout <app-id> [--type graph|process-model] [--stage dev|published]
uip pm query percentile <app-id> --field <id> --values <list> [--filters <file> | --filters-json <json>] [--stage dev|published]

tasa de conformidad de uip pm

Porcentaje de casos que siguen el modelo de referencia.

Opciones

Largo	Valor	Descripción
--process-id <id>	String	Proceso sobre el que informar; solo es necesario para una aplicación multiproceso.
--stage <stage>	dev | published	Predeterminado dev.

Ejemplo

uip pm conformance rate 9c46289e

Forma de datos (--json de salida)

{ "Code": "PmConformanceRate", "Data": { "ProcessId": "Process", "Miner": "inductive", "ConformanceRate": 0.666667, "ConformingCases": 2, "TotalCases": 3 } }

actividades de conformidad de uip pm

Estado de conformidad de cada actividad, con los casos subyacentes.

uip pm conformance activities 9c46289e

{ "Code": "PmConformanceActivities", "Data": [{ "Activity": "Approve", "Status": "Conforming", "Cases": 2 }, { "Activity": "Escalate", "Status": "LogOnly", "Cases": 1 }] }

Status es uno de ModelOnly, LogOnly, Conforming, Accepted.

transiciones de conformidad de uip pm

Estado de conformidad de cada transición entre actividades.

uip pm conformance transitions 9c46289e

{ "Code": "PmConformanceTransitions", "Data": [{ "FromNodeId": "Start", "ToNodeId": "Approve", "Status": "Conforming", "Cases": 2 }] }

desviaciones de conformidad de uip pm

Desviaciones que muestran realmente los datos (que no deben confundirse uip pm deviations, que gestiona las desviaciones aceptadas ; lee lo que se está desviando actualmente).

uip pm conformance deviations 9c46289e

{ "Code": "PmConformanceDeviations", "Data": [{ "Deviation": "Activity Approve is skipped", "Type": "Skip", "Cases": 1, "AverageThroughputTime": 2700 }] }

Conformidad de UIP pm con el modelo de carga

Carga un archivo BPMN como modelo de referencia de la aplicación. Solo etapa de desarrollo; entra en vigor en la siguiente ingestión: la carga por sí sola no vuelve a medir nada.

Argumentos

Nombre	Obligatorio	Propósito
<app-id>	Sí	ID de la aplicación de proceso.
<bpmn-file>	Sí	Archivo .bpmn local, máx. 6 MB.

Opciones

Largo	Valor	Descripción
--process-id <id>	String	Proceso al que pertenece el modelo; solo es necesario para una aplicación multiproceso.

Ejemplo

uip pm conformance upload-model 9c46289e ./order-to-cash.bpmn

Forma de datos (--json de salida)

{ "Code": "PmConformanceUploadModel", "Data": { "AppId": "9c46289e", "File": "./order-to-cash.bpmn", "Status": "Uploaded", "Messages": [] } }

Falla si el archivo supera los 6 MB, o si el servidor valida y rechaza el BPMN (HasError en la respuesta): las razones del rechazo se muestran en el mensaje de error, no se informan silenciosamente como correcto.

desviaciones de uip pm

Gestiona la lista de desviaciones aceptadas con la que se comprueba una aplicación: aceptar una desviación hace que la conformidad deje de contarla. Nada tiene efecto hasta que se vuelven a ejecutar las transformaciones; list informa de esa brecha como un estado por desviación.

--process-id es "Process" de forma predeterminada en cada verbo (solo importa para una aplicación multiproceso).

lista de desviaciones de uip pm

Opción	Valor	Descripción
--process-id <id>	String	Predeterminado Process.
--stage <stage>	dev | published	Predeterminado dev.

{ "Code": "PmDeviationsList", "Data": [{ "Type": "activity_missing", "Activities": ["Approve order"], "ParentProcess": [], "Status": "NotApplied" }] }

Status es Applied (la última ingestión correcta lo tiene), NotApplied (aceptado desde esa ingestión) o AppliedButDeleted (eliminado desde entonces): los dos últimos significan "volver a ejecutar las transformaciones para ponerse al día ."

desviaciones de uip pm aceptar

Largo	Valor	Obligatorio	Descripción
--type <deviation-type>	String	Sí	Tipo de desviación, según lo informado por conformance deviations.
--activities <activities...>	cadenas, separadas por espacios	Sí	Nombres de actividad que cubre la desviación.
--process-id <id>	String	No	Predeterminado Process.

uip pm deviations accept 9c46289e --type activity_missing --activities "Approve order"

{ "Code": "PmDeviationsAccept", "Data": { "AppId": "9c46289e", "Type": "activity_missing", "Activities": ["Approve order"], "Status": "Accepted" } }

Falla si ya se acepta la combinación exacta de tipo/actividades/proceso. Solo alcanza las desviaciones de nivel superior: una anidada en un subproceso (parentProcess no vacío) no puede coincidir con este comando, ya que --activities nunca envía un parentProcess.

eliminación de desviaciones de uip pm

Las mismas opciones que accept. Dejar de aceptar una desviación: el tipo, las actividades y el proceso principal deben coincidir exactamente con una desviación aceptada.

{ "Code": "PmDeviationsDelete", "Data": { "AppId": "9c46289e", "Type": "activity_missing", "Activities": ["Approve order"], "Status": "Deleted" } }

desviaciones de uip pm eliminar todo

Deja de aceptar cada desviación en la aplicación.

Largo	Valor	Descripción
-y, --yes	Marca	Confirme esta operación irreversible. Obligatorio.
--process-id <id>	String	Predeterminado Process.

{ "Code": "PmDeviationsDeleteAll", "Data": { "AppId": "9c46289e", "Status": "Deleted" } }

consulta de uip pm

Consultas de datos de propósito general contra una aplicación minada. Todos los verbos que toman cuerpo (run/details/rca/insights) comparten --body <json-file> / --body-json <json> (mutuamente excluyentes), --stage, y (excepto insights... en realidad todos 4) --limit (el servidor se limita a 1..1000).

ejecución de consulta de uip pm

Consulta agregada (agrupar por + métricas). Admite una sintaxis de Sugar en la parte superior del cuerpo sin formato.

Largo	Valor	Descripción
--group-by <cols>	separados por comas	Columnas de campo (nombres o ID, de query info) por las que agrupar. Azúcar; mutuamente excluyentes con --body/--body-json.
--metric <col:fn[:alias]>	Repetible	Agregar un campo. fn es uno de any, average, count, distinct_count, forall, forany, max, median, min, percentage, sum ( distingue entre mayúsculas y minúsculas, -/_ intercambiables). El alias predeterminado es <fn>_<column>.
--process-graph	Marca	Responde sobre el gráfico de proceso (actividades/transiciones) en lugar de sobre el modelo de datos simple. Solo Sugar: un cuerpo sin procesar lleva isProcessGraph a sí mismo.
--conformance	Marca	Responda sobre el lado solo del modelo (pasos que el modelo de referencia esperaba que se omitiera un caso) en lugar de lo que hizo el registro. Solo Sugar.

Otras funciones de agregación (COUNT_ROWS, EXISTS, APPROX_DISTINCT_COUNT, PERCENTILE, CASE_AVERAGE) no están disponibles a través de --metric — créelas con --body/--body-json (use query percentile para percentiles específicamente).

Ejemplos

uip pm query run 9c46289e --group-by Open_year --metric Event_count:average

uip pm query run 9c46289e --body-json '{"groupBy":["F__Cases__Priority__..."],"aggregates":[{"id":"n","argument":"Case_ID","aggregation":"COUNT"}]}'

uip pm query run 9c46289e --metric Case_conforming:percentage

# Skipped steps: activities the reference model expected that a case didn't take
uip pm query run 9c46289e --group-by Node_id,Node_label --metric Case_ID:distinct_count --process-graph --conformance

Forma de datos (--json de salida)

{ "Code": "PmQueryRun", "Data": [{ "Open_year": 2014, "average_Event_count": 9.16 }] }

Con la sintaxis Sugar, la respuesta en columnas del motor se reforma en objetos de fila tecleados por nombres/alias de columna humanos; una llamada --body/--body-json sin procesar devuelve la respuesta del motor tal cual.

detalles de la consulta de uip pm

Filas de tabla sin formato.

{ "Code": "PmQueryDetails", "Data": {} }

uip pm consulta rca

Análisis de causa raíz. El cuerpo necesita un selectedSet no vacío.

uip pm query rca 9c46289e --body-json '{"argument":"Case_ID","exploreAttributes":["Case_type"],"selectedSet":[[{"kind":"values","dimension":"Case_status","type":"string","values":["Open"],"invert":false,"displayType":"list"}]]}'

{ "Code": "PmQueryRca", "Data": { "Data": {}, "Warnings": null } }

información de consulta de uip pm

Información del proceso. El cuerpo necesita processId y 1-10 metrics.

{ "Code": "PmQueryInsights", "Data": {} }

información de consulta de uip pm

Descubre los campos, métricas y procesos disponibles para los cuerpos de consulta.

uip pm query info 9c46289e

{ "Code": "PmQueryInfo", "Data": { "fields": [], "processes": [] } }

diseño de consulta de uip pm

Obtener el diseño gráfico global persistente de una aplicación de proceso.

Largo	Valor	Predeterminado	Descripción
--type <type>	graph | process-model	graph	Qué diseño leer.

{ "Code": "PmQueryLayout", "Data": {} }

percentil de consulta de uip pm

Calcular los percentiles de un campo numérico.

Largo	Valor	Obligatorio	Descripción
--field <field-id>	String	Sí	ID de campo (query info).
--values <list>	separados por comas, 0..1	Sí	Puntos de percentil, por ejemplo 0.5,0.9,0.95.
--filters <json-file> / --filters-json <json>	JSON	No	Especificación de filtro (matriz de grupos de filtros AND). Mutuamente excluyentes.

uip pm query percentile 9c46289e --field PF__throughput_time --values 0.5,0.9,0.95

{ "Code": "PmQueryPercentile", "Data": { "values": [3600, 86400, 172800] } }

Relacionado

• uip pm : descripción general y apps CRUD.
• apps model : definiciones de campo/métrica a las que hacen referencia estas consultas.
• ingestions y transformations : una consulta necesita una ingestión completa en la etapa a la que se dirige.

Ver también

• Opciones globales
• Códigos de salida