Loading
Actifs connectés
Définitions de contexte pour les orchestrations d'événements actionnables pour Actifs connectés

Définitions de contexte pour les orchestrations d'événements actionnables pour Actifs connectés

Lorsqu'un événement est déclenché dans un actif, les détails de l'événement sont envoyés à Gestion des événements actionnables via l'API Événement entrant ou l'événement de plate-forme Événement source d'orchestration actionnable. La charge de travail de la requête de l'événement contient les détails de l'événement. Créez une définition de contexte pour représenter la structure de la charge utile de requête d'un événement. Utilisez ensuite la définition du contexte pour fournir les données d'événement requises à la procédure d'exécution qui exécute les actions de l'événement. Les nœuds et les attributs de la définition du contexte doivent correspondre aux attributs d'événement dans la charge de travail de l'API. Par exemple, si la charge de travail de la requête contient des paramètres d'identifiant d'actif, de puissance de sortie, de score d'intégrité et de statut d'activation pour un événement d'erreur de capteur, créez une définition de contexte avec des nœuds mappés avec ces paramètres.

Éditions requises

Disponible avec : Lightning Experience
Disponible avec : Automotive Cloud, Communications Cloud, Consumer Goods, Energy and Utilities Cloud, Manufacturing Cloud et Media Cloud. Afficher la disponibilité

Les définitions de contexte contiennent une série d'informations requises pour exécuter un processus et faciliter la récupération et l'utilisation efficaces des données entre les applications dans Salesforce. Pour apprendre à créer une définition de contexte, consultez Création de définitions de contexte. Vous pouvez créer plusieurs définitions de contexte selon le type de structure de charge utile de requête attendu pour chaque type et sous-type d'événement. Vous pouvez également créer plusieurs mappages de contexte pour la même définition de contexte.

Vous pouvez ajouter des balises de contexte en tant que variables dans une procédure d'exécution.

Exemple
Exemple

Durkheim Coolers est une entreprise de technologies de transformation alimentaire qui souhaite déclencher des orchestrations pour des problèmes critiques dans ses systèmes de distribution d'air, tels que le faible débit d'air, le niveau élevé de particules et les filtres défaillants. Les événements proviennent du système télématique sont envoyés à la couche d'intégration, puis à Salesforce. Le type de données envoyé depuis le système télématique externe pour de tels événements a des attributs fixes qui décrivent l'événement.

Voici une charge de travail de requête typique.

{
    "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"}

L'administrateur crée une définition de contexte appelée Événements de diagnostic du système de distribution d'air. Examinez la structure des nœuds de la définition du contexte qui correspond aux attributs de données d'événement dans la charge de travail de la requête.

Nom du nœud Niveau du nœud Attributs
Événement Nœud parent
  • correlationId
  • assetUniqueIdentifier
  • assetType
  • eventId
  • id
  • priorité
  • eventProviderId
  • eventTriggeredDate
Défauts Nœud Enfant de l'événement
  • ParentReference
  • faultCode
  • faultType
  • faultDescription
  • faultResolutionType
  • faultCodeSensorValues
  • freezeFrameId
  • code
Données de l'événement Nœud Enfant de l'événement
  • ParentReference
  • priorité
  • airflowRate
  • particlesMatterLevel
  • filterStatus
  • ambientTemperature
  • ventilationPerformances
  • eventTriggeredDate
Signal Nœud Enfant de l'événement
  • ParentReference
  • value
  • unit
  • name
  • horodatage
  • dataType
Attributs d'événement supplémentaires Nœud Enfant de l'événement
  • ParentReference
  • clé
Actions Nœud Enfant de l'événement
  • ParentReference
  • recordAlertSubject
  • recordAlertDescription
  • actionName

L'administrateur peut spécifier les attributs utilisés en entrée et ceux utilisés en sortie dans la procédure d'exécution. Par exemple, l'ID de fournisseur d'événements est une valeur d'entrée utilisée pour identifier le système télématique externe en tant que source de l'événement. Cependant, l'Identificateur unique d'actif est à la fois une entrée et une sortie, car Durkheim Coolers souhaite créer une alerte d'enregistrement pour chaque événement de filtres défaillants déclenché pour un actif spécifique.

Chaque nœud et attribut de la définition du contexte a une balise contextuelle correspondante. Les utilisateurs peuvent aisément identifier les attributs à partir des balises de contexte lorsqu’ils conçoivent les procédures d'exécution.

 
Chargement
Salesforce Help | Article