Skip to main content

iComfort Message

In iComfort Message sono presenti Tre tipologie di Nodi base della piattaforma iComfort.

I Nodi Entity, Sensor e Device definiscono la posssibilità di gestire quello che avviene in piattaforma e permettono di intercettarlo.

Il Nodo Entity permette di gestire gli eventi che possono avvenire sulla base della gestione degli spazi quindi eventi di creazione, cancellazione, aggiunta di attributi, aggiornamento o eliminazione di attributi.

Campi messaggi CONFIG

Event: lista eventi

Space Type: lista tipologia spazi su cui filtrare gli eventi in arrivo

Places: lista spazi su cui filtrare gli eventi in arrivo

Include Space Children: indica se bisogna solo di intercettare gli eventi degli spazi indicati oppure anche dei “figli” di tali spazi che soddisfano la combinazione impostata

Tracing Mode: Modalità di tracciatura degli eventi

Campi messaggi in uscita relativi ad Entity

Object Guid: Guid dell'Entità coinvolta nell'evento

Verb: Nome dell'azione effettuata sull'Entità coinvolta nell'evento; può assumere questi valori:

Entity Add in caso di nuova entità

Entity Update in caso di modifica dell'entità

Entity Delete in caso cancellazione, logica, dell'entità

Event Type nome della Categoria di Evento effettuata sull'Entità coinvolta; può assumere questi valori:

Booking: tutti gli eventi sulle Reservation (new Reservation, Check-in, Check-out, Delete, etc...)

Engine: tutti gli eventi sugli Engine (Start, Stop e License Expired)

Device: tutti gli eventi sui Device (Device_Add, Device_Update, AddToGroup, OnLine, OffLine, Status, Measure, etc...)

Entity: tutti gli eventi sulle Entità e i suoi Attributi Device (Entity_Add, Entity_Update, Entity_Delete, Attribute_Add, Attribute_Update, Attribute_Delete)

Entity_Measure: tutti gli eventi che si verificano in fase di ricezione dei dati e in fase di create, update e delete di una relazione tra Entità e Device

Group: tutti gli eventi sui Gruppi (Group_Add, Group_Update, Group_Delete, Group_Property_Change, Group_Acl_Update)

User: tutti gli eventi sugli Utenti (User_Add, User_Update, User_Change_PWD, etc...)

InvokerId Guid dell'Utente che ha scatenato l'evento in seguito ad una azione che ha effettuato.

TraceSessionGuid

Campi messaggi in uscita relativi a Sensor

ObjectGuid Guid dell'Entità coinvolta nell'evento

Verb Nome dell'azione effettuata sull'Entità coinvolta nell'evento; può assumere questi valori:

Entity Name Nome dell'Entità coinvolta nell'evento di ricezione dei dati

Event Type Nome della Categoria di Evento effettuata sull'Entità coinvolta; può assumere questi valori:

BaseType: Nome del BaseType dell'Entità coinvolta nell'evento

BaseTypeGuid: Guid del BaseType dell'Entità coinvolta nell'evento

DeviceName: Nome del Device coinvolto nell'evento di ricezione dei dati

DeviceId: ID del Device coinvolto nell'evento di ricezione dei dati

DeviceTypeName: Nome del Device Type del Device coinvolto nell'evento di ricezione dei dati

DeviceTypeGuid: Guid del Device Type del Device coinvolto nell'evento di ricezione dei dati

Event Name: Nome dell'evento di ricezione dei dati (Batteria, Temperatura, Umidità, etc..)

Event Code: Codice Univoco dell'evento di ricezione dei dati (Batteria=>0, Temperatura=>1, Umidità=>2, etc..)

Event Value: Valore della Misura rilevata.

traceSessionGuid:

Campi messaggi in uscita relativi a Device

Device Name Nome del Device coinvolto nell'evento di ricezione dei dati

Device Id ID del Device coinvolto nell'evento di ricezione dei dati

Device Type Name Nome del Device Type del Device coinvolto nell'evento di ricezione dei dati

Device Type Guid Guid del Device Type del Device coinvolto nell'evento di ricezione dei dati

Verb Nome dell'azione effettuata sull'Entità coinvolta nell'evento

Event Type Nome della Categoria di Evento effettuata sull'Entità coinvolta

InvokerId Guid dell'Utente che ha scatenato l'evento in seguito ad una azione che ha effettuato.

TraceSessionGuid

Descrizione Payload Messaggi​

Entity Message​

MessageId = Identificativo univoco del Messaggio

TimeStamp = TimeStamp del Messaggio

EventType = Entity, tipologia del Messaggio

Verb = Verb, l'azione effettuata sull'entità: può essere Add, Update, Delete, etc...

ObjectGuid = Identificativo univoco dell'Entità

InvokerId = Identificativo univoco dell'Utente

Measures = è una lista di informazioni (denominate Measure) formata da coppie di Name, Value

//Di seguito la descrizione 
 
"MessageId": "56FE0532-7C08-46F4-905D-A1DD4416FC39",
"TimeStamp": "1713962586641",
"EventType": "Entity",
"Verb": "Add",
"ObjectGuid": "F063DA84-CEAB-4829-A90E-00E7B702D219",
"InvokerId": "1B165288-CF5B-4CE9-AFFD-8271E358A8E4",
"Measures":  [
    {
        "Name" : "EntityName",
        "Value" : "DESK - WPT 101", //nome dell'Entità
    },
    {
        "Name" : "ParentEntityName",
        "Value" : "Floor 1", //nome dell'Entità Padre dell'Entità su cui è stata effettuata l'azione
    },
    {
        "Name" : "ParentEntityGuid",
        "Value" : "4B9A7749-7A32-4073-905C-767A58AC80D3", //Identificativo univoco dell'Entità Parent
    },
    {
        "Name" : "ComplexTemplateName",
        "Value" : "DESK", //nome del Complex Template
    },
    {
        "Name" : "BaseTemplateName",
        "Value" : "DESK", //nome del Base Template
    },
    {
        "Name" : "BaseTemplateGuid",
        "Value" : "2D6C4E43-5189-45AC-BB6D-679DE2A6A4B3", //Codice univoco del Base Template
    },
 ]

}

Sensor Message​

MessageId = Identificativo univoco del Messaggio

TimeStamp = TimeStamp del Messaggio

EventType = EntityMeasure, tipologia del Messaggio

Verb = Entity_Measure, misurazione rilevata

ObjectGuid = Identificativo univoco dell'Entità

InvokerId = Identificativo univoco dell'Utente

Measures = è una lista di informazioni (denominate Measure) formata da coppie di Name, Value

//Di seguito la descrizione 

{
"MessageId": "56FE0532-7C08-46F4-905D-A1DD4416FC39",
"TimeStamp": "1713962586641",
"EventType": "EntityMeasure",
"Verb": "Entity_Measure",
"ObjectGuid": "F063DA84-CEAB-4829-A90E-00E7B702D219",
"InvokerId": "1B165288-CF5B-4CE9-AFFD-8271E358A8E4",
"Measures": [
        {
            "Name" : "Device_Name",
            "Value" : "P06-01", //Nome Device
        },
        {
            "Name" : "Device_Id",
            "Value" : "2871", //ID Device
        },
        {
            "Name" : "Device_Type_Name",
            "Value" : "iComfortSensor", //Nome Device Type
        },
        {
            "Name" : "Device_Type_Guid",
            "Value" : "{18E521EB-0683-46D9-A054-CBE6D62543D8}", //Guid del Device Type
        },
        {
            "Name" : "EventCode",
            "Value" : "1", //Codice univoco dell'evento di Misurazione
        },
        {
            "Name" : "EventName",
            "Value" : "Temperature", //Nome dell'evento di Misurazione
        },
        {
            "Name" : "EntityName",
            "Value" : "DESK - WPT 101", //Nome Entità
        },
        {
            "Name" : "BaseTemplateName",
            "Value" : "2D6C4E43-5189-45AC-BB6D-679DE2A6A4B3", //Nome Base Template
        },
        {
            "Name" : "BaseTemplateGuid",
            "Value" : "2D6C4E43-5189-45AC-BB6D-679DE2A6A4B3", //Codice univoco del Base Template
        }
        {
            "Name" : "EventValue",
            "Value" : "19", //valore del dato di sensoristica)
            "Type" : "int", //tipo del dato utilizzato per la misurazione, ad esempio: 'stringa', 'intero', 'float', etc...
            "Unit" : "C", //unità di misura utilizzata per la misurazione, ad esempio 'V = Volts', 'C = Gradi Centigradi', etc...
        }
]

}

Device Message​

MessageId = Identificativo univoco del Messaggio

TimeStamp = TimeStamp del Messaggio

EventType = Tipologia del Messaggio

Verb = Verb, l'azione effettuata sull'entità: può essere Device_Add, Device_Update, Device_Delete, etc...

ObjectGuid = string vuota

InvokerId = Identificativo univoco dell'Utente

Measures = è una lista di informazioni (denominate Measure) formata da coppie di Name, Value

//Di seguito la descrizione 

{
"MessageId": "56FE0532-7C08-46F4-905D-A1DD4416FC39",
"TimeStamp": "1713962586641",
"EventType": "Device",
"Verb": "Device_Add",
"ObjectGuid": "",
"InvokerId": "1B165288-CF5B-4CE9-AFFD-8271E358A8E4",
"Measures": [
        {
            "Name" : "Device_Name", 
            "Value" : "P06-01", //Nome Device
        },
        {
            "Name" : "Device_Id",
            "Value" : "2871", //ID Univoco del Device
        },
        {
            "Name" : "Device_Type_Name",
            "Value" : "iComfortSensor", //Nome del Device Type
        },
        {
            "Name" : "Device_Type_Guid",
            "Value" : "{18E521EB-0683-46D9-A054-CBE6D62543D8}", //Guid del Device Type
        },
        {
            "Name" : "GroupName",
            "Value" : "iComfort Device Group", //Nome del Gruppo a cui appartiene il Device
        },
        new Measure//)
        {
            "Name" : "Id_Group",
            "Value" : "634236", //ID del Gruppo a cui appartiene il Device
        },
        new Measure//)
        {
            "Name" : "LastContact",
            "Value" : "2024-03-02 16:21:54.790", //Data e Ora dell'ultimo invio dei dati di sensoristica da parte del sensore
        }
    }