Loading
Asset connessi
Definizioni contesto per le orchestrazioni di eventi fruibili per Asset connessi

Ti trovi qui:

  1. Guida di Salesforce
  2. Documenti
  3. Asset connessi

Definizioni contesto per le orchestrazioni di eventi fruibili per Asset connessi

Quando un evento viene attivato in un asset, i dettagli dell'evento vengono inviati a Gestione eventi fruibile tramite l'API evento in entrata o l'evento piattaforma Evento di origine orchestrazione fruibile. Il payload della richiesta dell'evento contiene i dettagli dell'evento. Creare una definizione contesto per rappresentare la struttura del payload della richiesta di un evento. Quindi, utilizzare la definizione contesto per fornire i dati dell'evento richiesti alla procedura di esecuzione che esegue le azioni per l'evento. I nodi e gli attributi della definizione contesto devono corrispondere agli attributi evento nel payload API. Ad esempio, se il payload della richiesta contiene parametri per l'identificatore asset, la potenza di output, il punteggio di integrità e lo stato di attivazione per un evento di errore del sensore, creare una definizione contesto con nodi mappati a questi parametri.

Versioni (Edition) richieste

Disponibile in: Lightning Experience
Disponibile in: Automotive Cloud, Communications Cloud, Consumer Goods, Energy and Utilities Cloud, Manufacturing Cloud e Media Cloud. Visualizzare la disponibilità.

Le definizioni contesto contengono una serie di informazioni necessarie per l'esecuzione di un processo e consentono di recuperare e utilizzare in modo efficiente i dati nelle applicazioni in Salesforce. Per informazioni su come creare una definizione contesto, vedere Creazione di definizioni contesto. È possibile creare più definizioni contesto a seconda del tipo di struttura di payload della richiesta prevista per ogni tipo di evento e sottotipo. È anche possibile creare più mappature contesto per la stessa definizione contesto.

È possibile aggiungere tag di contesto come variabili in una procedura di esecuzione.

Esempio
Esempio

Durkheim Coolers è un'azienda di tecnologie per la lavorazione degli alimenti che desidera attivare orchestrazioni per problemi critici nei propri sistemi di distribuzione dell'aria, come bassa portata d'aria, alto livello di particolato e filtri malfunzionanti. Gli eventi hanno origine nel sistema telematico, vengono inviati al livello di integrazione e quindi inviati a Salesforce. Il tipo di dati inviato dal sistema telematico esterno per tali eventi ha attributi fissi che descrivono l'evento.

Di seguito è riportato un payload tipico delle richieste.

{
    "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'amministratore crea una definizione contesto denominata Eventi diagnostici del sistema di distribuzione dell'aria. Esaminare la struttura del nodo della definizione contesto che corrisponde agli attributi dei dati degli eventi nel payload della richiesta.

Nome nodo Livello nodo Attributi
Evento Nodo controllante
  • ID correlazione
  • assetUniqueIdentifier
  • assetType
  • eventId
  • id
  • priorità
  • eventProviderId
  • eventTriggeredDate
Guasti Nodo figlio dell'evento
  • ParentReference (Riferimento controllante)
  • faultCode
  • faultType
  • faultDescription (Descrizione guasto)
  • faultResolutionType
  • faultCodeSensorValues
  • freezeFrameId
  • code
Dati evento Nodo figlio dell'evento
  • ParentReference (Riferimento controllante)
  • priorità
  • airflowRate
  • particulateMatterLevel
  • filterStatus (Statofiltro)
  • ambientTemperatura
  • VentilazionePrestazioni
  • eventTriggeredDate
Segnale Nodo figlio dell'evento
  • ParentReference (Riferimento controllante)
  • value
  • unit
  • name
  • indicazione oraria
  • dataType
Attributi evento aggiuntivi Nodo figlio dell'evento
  • ParentReference (Riferimento controllante)
  • chiave
Azioni Nodo figlio dell'evento
  • ParentReference (Riferimento controllante)
  • recordAlertSubject
  • recordAlertDescription
  • actionName

L'amministratore può specificare quali attributi vengono utilizzati come input e quali come output nella procedura di esecuzione. Ad esempio, l'ID provider di eventi è un valore di input utilizzato per identificare il sistema telematico esterno come origine dell'evento. Tuttavia, l'identificatore univoco asset è sia un input che un output poiché Durkheim Coolers desidera creare un avviso record per ogni evento di filtri non funzionanti attivato per un asset specifico.

Ogni nodo e attributo della definizione contesto ha un tag contesto corrispondente. Durante la progettazione delle procedure di esecuzione, gli utenti possono identificare facilmente gli attributi dai tag di contesto

 
Caricamento
Salesforce Help | Article