Contextdefinitie en toewijzing van eventdetails van voertuigfout

Beschikbaar in: Enterprise, Unlimited en Developer Edition

Een bedrijf wil doeltreffende combinaties activeren voor kritieke voertuigproblemen zoals transmissiestoringen of motorstoringen. De events zijn afkomstig uit het telematicasysteem en worden verzonden naar de integratielaag zoals MuleSoft. De events worden vervolgens verzonden naar het navolgbare Raamwerk voor doeltreffende combinaties van events via platformevents of een directe aanroep van de API voor inkomende events. Het type gegevens dat wordt verzonden vanuit het externe telematicasysteem voor dergelijke events, heeft vaste kenmerken die de event beschrijven.

Hier is een typische verzoekpayload.

{
    "eventId" : "123",
    "assetUniqueIdentifier": "VIN1234",
    "eventType": "Maintenance",
    "eventSubtype": "TransmissionRepair",
    "eventCategory" : "Notification",
    "event data": [{
            "correlationId" : "1001",
            "priority": "High",
            "eventProviderId": "P123",
            "vehicleId": "ABC1234",
            "eventTriggeredDate": "2023-05-16T15:13:41.236Z"
     }],
    "faults": [{
            "code": "string",
            "type": "string",
            "description": "string",
            "resolutionType": "string",
            "codeSensorValues": "string",
            "freezeFrameId": "string"
     }],
    "location": {
       "latitude": 0,
       "longitude": 0
    },
    "signals": [{
            "value": "string",
            "timeStamp": "2023-05-16T15:13:41.236Z",
            "dataType": "string",
            "unit": "string",
            "name": "string"}

De beheerder gebruikt de contextdefinitie Detail van voertuigfoutevent. Controleer de knooppuntstructuur van de contextdefinitie die overeenkomt met de eventgegevenskenmerken in de verzoekpayload.

Knooppuntnaam	Knooppuntniveau	Kenmerken
Event	Bovenliggend knooppunt	correlationId assetUniqueIdentifier assetType eventId id prioriteit eventProviderId vehicleId vehicleName eventTriggeredDate
Fouten	Onderliggend van eventknooppunt	ParentReference faultCode faultType faultDescription faultResolutionType faultCodeSensorValues freezeFrameId code
Signaal	Onderliggend van eventknooppunt	ParentReference value unit name tijdstempel dataType
Locatie van event	Onderliggend van eventknooppunt	ParentReference breedtegraad lengtegraad
Aanvullende eventkenmerken	Onderliggend van eventknooppunt	ParentReference sleutel
Acties	Onderliggend van eventknooppunt	ParentReference recordAlertSubject recordAlertDescription actionName

De beheerder kan opgeven welke kenmerken als invoer worden gebruikt en welke kenmerken als uitvoer worden gebruikt in de uitvoeringsprocedure. Zo is de ID van de eventleverancier een invoerwaarde die wordt gebruikt om het externe telematicasysteem te identificeren als de bron van de event. Maar de voertuig-ID is zowel een invoer als een uitvoer, omdat Neo Motors een recordwaarschuwing wil maken voor elke transmissiefout die voor een specifiek voertuig wordt geactiveerd.

Als de beheerder een uitvoeringsprocedure wil maken die cases activeert in plaats van recordwaarschuwingen, kan deze deze definitie klonen, de kenmerken van het onderliggende knooppunt Actie wijzigen en de definitie in de procedure gebruiken.

De contextdefinitie bevat ook een contexttoewijzing die de kenmerken vehicleId en vehicleName van het eventknooppunt toewijst aan de velden ID en Naam van het voertuigobject.

Elk knooppunt en kenmerk van de contextdefinitie heeft een overeenkomende contexttag. Gebruikers kunnen de kenmerken gemakkelijk herkennen aan de hand van de contexttags tijdens het ontwerpen van de uitvoeringsprocedures.