Mensajes de alerta

En las reglas de inspección, puede configurar mensajes de alerta que se envían a destinatarios externos si se cumplen las condiciones de la regla. Puede utilizar formatos de texto simple o de mensaje estándar, como JSON, e incluir metadatos, como resultados de reglas y puntuaciones de confianza.

Al crear o actualizar una regla de inspección, puede configurar mensajes de alerta que se publican en un tema MQTT. También se puede enviar un mensaje de alerta a un número de teléfono a través del servicio de mensajería Twilio. Si se cumplen las condiciones de la regla al finalizar una inspección, se envía el mensaje de alerta. Puede crear mensajes de alerta utilizando texto simple, como Inspection failed, o formatos más complejos, como JSON, que se utiliza habitualmente en la mensajería MQTT.

Los mensajes de alerta en Maximo® Visual Inspection Edge son plantillas Go, que son archivos de texto que pueden crear contenido simple o complejo. Estas plantillas permiten la inclusión de metadatos de inspección, como el contexto, el resultado o los metadatos de desencadenante, en los mensajes. Se pueden incluir metadatos del servidor Maximo Visual Inspection que permiten a los destinatarios de mensajes de alerta acceder a imágenes en la Maximo Visual Inspection aplicación. Las variables de metadatos que incluya en los mensajes de alerta deben estar entre llaves dobles, por ejemplo {{result}}.

Metadatos de contexto

Se pueden incluir variables de metadatos de contexto, como InspectionName, StationName, DeviceName y ModelUUID, en mensajes de alerta. Utilice la siguiente notación para hacer referencia a estas variables: .context.Metadata.<variable name>

Por ejemplo, para crear un mensaje JSON que muestre el nombre de la inspección actual y un resultado de fallo, introduzca el siguiente texto en el campo Alert message:

{
    "Inspection" : "{{.context.Metadata.InspectionName}}",
    "Result" : "fail"
}

Se pueden utilizar las siguientes variables de metadatos de contexto:

  • .context.Metadata.InspectionUUID
  • .context.Metadata.Inspection
  • .context.Metadata.Station
  • .context.Metadata.DeviceUUID
  • .context.Metadata.Device
  • .context.Metadata.MVIVersion
  • .context.Metadata.ModelUUID
  • .context.Metadata.MVIBaseUrl

Resultados de reglas y metadatos de imagen

También puede incluir variables de metadatos en el resultado de la regla, como Name, Result y ObjectLabel. Utilice la siguiente notación para hacer referencia a estas variables: .result.<variable name>

Por ejemplo, para crear un mensaje JSON que genere el nombre de la inspección actual y el resultado de la regla actual, especifique el siguiente texto del mensaje de alerta:

{
    "Inspection" : "{{.context.Metadata.InspectionName}}",
    "Result" : "{{.result.Result}}"
}

También puede hacer referencia al nombre de la imagen que procesa la regla utilizando la siguiente notación: .image.ID

Por ejemplo, si Maximo Visual Inspection Edge está instalado en el /opt/ibm/vision-edge directorio, puede hacer referencia a la imagen en un mensaje de alerta incluyendo lo siguiente URL :https://<hostname>/opt/ibm/vision-edge/images/{{.context.Metadata.InspectionUUID}}/{{.image.ID}}

Se pueden utilizar las siguientes variables de metadatos de imagen y resultado de regla:

  • .result.Name
  • .result.Result
  • .result.ObjectLabel
  • .result.ObjectCount
  • .result.FilteredResults.Score
  • .result.FilteredResults.Label.Name
  • .result.FilteredResults.Rectangle.Min.X
  • .result.FilteredResults.Rectangle.Min.Y
  • .result.FilteredResults.Rectangle.Max.X
  • .result.FilteredResults.Rectangle.Max.Y
  • .image.ID

Activar metadatos

Si se configura un tema MQTT en el campo Single-shot trigger de la inspección y los mensajes de activación entrantes están en formato JSON con metadatos, las variables de metadatos se pueden utilizar en los mensajes de alerta. Utilice la siguiente notación para hacer referencia a estas variables: .trigger.<variable name>

Por ejemplo, si un mensaje de activador de entrada contiene el siguiente texto:

{
    "object" : "widget",
    "serial_id" : "152637"
}
Puede incluir las variables de metadatos de activador en su mensaje de alerta especificando el siguiente texto del mensaje:
{
    "inspection":"{{.context.Metadata.Inspection}}",
    "rule":"{{.result.Name}}",
    "result":"{{.result.Result}}",
    "object_type" : "{{.trigger.object}}",
    "serial_num" : "{{.trigger.serial_id}}"
}

Utilizando este ejemplo para una inspección que se denomina Comprobación del motor y tiene una única regla que se denomina Regla del widget, podría enviarse el siguiente mensaje de alerta:

{
    "inspection":"Engine check",
    "rule":"Widget rule",
    "result":"Fail",Validate and check for completeness iconc
    "object_type" : "widget",
    "serial_num" : "152637"
}

Metadatos del servidor deMaximo Visual Inspection

Después de enviar las imágenes desde Maximo Visual Inspection Edge a Maximo Visual Inspection, sus ID de imagen y conjunto de datos exclusivos se devuelven a Maximo Visual Inspection Edge en variables de metadatos. Estas variables pueden incluirse en los mensajes de alerta para que el destinatario del mensaje pueda abrir la imagen en la aplicación Maximo Visual Inspection. Utilice la siguiente notación para hacer referencia a estas variables: .mvidata.<variable name>

Por ejemplo, si implementa las aplicaciones Maximo Visual Inspection Maximo Monitor y en IBM® Maximo Application Suite y luego integra Maximo Visual Inspection Edge con Maximo Monitor, puede enviar alertas a Maximo Monitor dispositivos que incluyan enlaces para abrir las imágenes en la Maximo Visual Inspection aplicación. Para obtener más información, consulte Integración con.

Se pueden utilizar las siguientes variables de metadatos del servidor de Maximo Visual Inspection :

  • .mvidata.DatasetID
  • .mvidata.ImageID

Para obtener más información sobre las plantillas de Go, consulte plantilla.

Plantillas de mensajes de alerta

Nota: A partir de Maximo Visual Inspection Edge 9.0, se admite la creación de plantillas de mensajes de alerta.

Los administradores pueden crear plantillas de mensajes de alerta para definir la estructura y el formato de los mensajes de alerta MQTT y Twilio que se envían desde dispositivos periféricos.

Al configurar reglas en una configuración de inspección, puede seleccionar una plantilla de mensaje de alerta al crear un mensaje de tipo Twilio o MQTT.