Loading
Activos conectados
Definiciones de contexto para orquestaciones de eventos con capacidad de acción para Activos conectados

Definiciones de contexto para orquestaciones de eventos con capacidad de acción para Activos conectados

Cuando se desencadena un evento en un activo, los detalles del evento se envían a Gestión de eventos con capacidad de acción a través de la API de eventos entrantes o el evento de plataforma Evento de origen de orquestación con capacidad de acción. La carga de solicitud del evento contiene los detalles del evento. Cree una definición de contexto para representar la estructura de la carga de solicitud de un evento. A continuación, utilice la definición de contexto para proporcionar los datos de eventos requeridos al procedimiento de ejecución que realiza las acciones para el evento. Los nodos y atributos de la definición de contexto deben coincidir con los atributos de evento en la carga de API. Por ejemplo, si la carga de solicitud contiene parámetros para identificador de activo, potencia de salida, puntuación de estado y estado de activación para un evento de error de sensor, cree una definición de contexto con nodos que se asignen a estos parámetros.

Ediciones necesarias

Disponible en: Lightning Experience
Disponible en: Automotive Cloud, Communications Cloud, Consumer Goods, Energy and Utilities Cloud, Manufacturing Cloud y Media Cloud. Ver disponibilidad de edición.

Las definiciones de contexto contienen un conjunto de información necesaria para ejecutar un proceso y ayudan en la recuperación y el uso eficientes de datos entre aplicaciones en Salesforce. Para obtener información acerca de cómo crear una definición de contexto, consulte Crear definiciones de contexto. Puede crear múltiples definiciones de contexto dependiendo del tipo de estructura de carga de solicitud que espera para cada tipo y subtipo de evento. También puede crear múltiples asignaciones de contexto para la misma definición de contexto.

Puede agregar etiquetas de contexto como variables en un procedimiento de ejecución.

Ejemplo
Ejemplo

Durkheim Coolers es una empresa de tecnologías de procesamiento de alimentos que desea desencadenar orquestaciones para problemas críticos en sus sistemas de distribución de aire, como bajo caudal de aire, alto nivel de partículas y filtros defectuosos. Los eventos se originan en el sistema telemático, se envían a la capa de integración y luego se envían a Salesforce. El tipo de datos que se envía desde el sistema telemático externo para dichos eventos tiene atributos fijos que describen el evento.

A continuación se incluye una carga de solicitud habitual.

{
    "eventId" : "123",
    "assetUniqueIdentifier": "FOA1234",
    "eventType": "PerformanceAndDiagnostic",
    "eventSubtype": "MalfunctioningFilters",
    "eventCategory" : "Notification",
    "event data": [{
            "priority": "High",
            "eventProviderId": "P123",
            "airflowRate" : "1001",
            "particulateMatterLevel" : "1001",
            "filterStatus" : "string",
            "ambientTemperature" : "1001",
            "ventilationPerformance" : "1001",
            "eventTriggeredDate": "2023-05-16T15:13:41.236Z"
     }],
    "faults": [{
            "code": "string",
            "type": "string",
            "description": "string",
            "resolutionType": "string",
            "codeSensorValues": "string",
            "freezeFrameId": "string"
     }],
    },
    "signals": [{
            "value": "string",
            "timeStamp": "2023-05-16T15:13:41.236Z",
            "dataType": "string",
            "unit": "string",
            "name": "string"}

El administrador crea una definición de contexto denominada Eventos de diagnóstico del sistema de distribución de aire. Revise la estructura del nodo de la definición de contexto que corresponde a los atributos de datos de eventos en la carga de solicitud.

Nombre de nodo Nivel de nodo Atributos
Evento Nodo principal
  • correlationId
  • assetUniqueIdentifier
  • assetType
  • eventId
  • id
  • prioridad
  • eventProviderId
  • eventTriggeredDate
Fallos Nodo secundario de evento
  • ParentReference
  • faultCode
  • faultType
  • faultDescription
  • faultResolutionType
  • faultCodeSensorValues
  • freezeFrameId
  • código
Datos de eventos Nodo secundario de evento
  • ParentReference
  • prioridad
  • airflowRate
  • particulateMatterLevel
  • filterStatus
  • ambientTemperature
  • ventilaciónRendimiento
  • eventTriggeredDate
Señal Nodo secundario de evento
  • ParentReference
  • value
  • unit
  • name
  • timestamp
  • dataType
Atributos de eventos adicionales Nodo secundario de evento
  • ParentReference
  • clave
Acciones Nodo secundario de evento
  • ParentReference
  • recordAlertSubject
  • recordAlertDescription
  • actionName

El administrador puede especificar qué atributos se utilizan como entrada y qué atributos se utilizan como salida en el procedimiento de ejecución. Por ejemplo, el Id. de proveedor de eventos es un valor de entrada utilizado para identificar el sistema telemático externo como el origen del evento. Pero el Identificador exclusivo de activo es una entrada y una salida porque Durkheim Coolers desea crear una alerta de registro para cada evento de filtros defectuosos desencadenado para un activo específico.

Cada nodo y atributo de la definición de contexto tiene una etiqueta de contexto correspondiente. Al diseñar los procedimientos de ejecución, los usuarios pueden identificar fácilmente los atributos desde las etiquetas de contexto

 
Cargando
Salesforce Help | Article