Formato dei dati da inoltare

Formato date

Sono supportati tutti i formati compatibili con JavaScript

  • ISO Date
    2018-04-23T10:26:00.996Z
  • Short Date
    04/23/2018
    04/23/2018 12:26:00.996+02:00
  • Long Date
    Mar 23 2018 10:26:00.996Z
    23 Mar 2018 12:26:00.996+02:00
    March 23 2018

 


 

Formato dei dati

Per inoltrare i dati dei propri dispositivi sono disponibili due formati in Databoom:

  • Invio di più segnali con i loro valori. Tutti i valori fanno riferimento alla stessa data, se non è specificata viene utilizzata la data corrente
    { 
        "device": "TOKEN DISPOSITIVO", 
        "date": "DATA", 
        "signals" : [ 
            {
                "name": "TOKEN SEGNALE 1", 
                "value": VALORE SEGNALE 1
            },
            {
                "name": "TOKEN SEGNALE 2", 
                "value": VALORE SEGNALE 2
            },
            ...
        ]
    }
    In questa modalità è possibile inviare anche informazioni aggiuntive che, in caso di prima comunicazione, permettono la creazione dei segnali già validati. Il formato per l'invio delle informazioni aggiuntive è
    { 
        "device": "TOKEN DISPOSITIVO", 
        "date": "DATA", 
        "signals" : [ 
            {
                "name": "TOKEN SEGNALE 1", 
                "value": VALORE SEGNALE 1,
    "meta": {
    "description":"DESCRIZIONE SEGNALE 1",
    "type": "TIPO SEGNALE 1",
    "unit": "UNITA' DI MISURA SEGNALE 1",
    "tags": ["TAG 1", "TAG 2", ...],
    "chart_type": "TIPO GRAFICO SEGNALE 1",
    "accumulator": {
    "active": true/false (il segnale è un contatore),
    "is_a_sum": true/false (il segnale è contatore incrementale)
    }
    } }, ... ] }
    Il campo meta viene considerato solo in fase di creazione del segnale, se il segnale esiste già le informazioni saranno ignorate. Non è necessario specificare tutti i campi in meta ma solo quelli che si vogliono impostare.
  • Invio di più segnali con il loro storico di valori. Ad ogni valore del segnale è associato una data specifica
    {
        "device": "TOKEN DISPOSITIVO",
        "signals" : {
            "TOKEN SEGNALE 1": {
                "description": "DESCRIZIONE SEGNALE",
                "history": [
                    {
                        "date": "DATA VALORE",
                        "value": VALORE SEGNALE
                    },
                    ...
                ] 
            },
            "TOKEN SEGNALE 2": {
                "description": "DESCRIZIONE SEGNALE",
                "history": [
                    {
                        "date": "DATA VALORE",
                        "value": VALORE SEGNALE
                    },
                    ...
                ] 
            },
            ...
        }
    }
    

 


 

Esempio

Si prenda come esempio il dispositivo in figura:

  • Il device token è 0f6hbfnqz6
  • I token dei segnali sono:
    • Signal 1, signal_one
    • Signal 2, signal_two

I due formati risultano:

  •   {
    	"device":"0f6hbfnqz6",
    	"signals": [
            {
                "name" : "signal_one",
                "value" : 24.35156                    
            },
            {
                "name" : "signal_two",
                "value" : 16.92874                    
            }
    	]
    }
      
  •   {
    	"device":"0f6hbfnqz6",
    	"signals": {
    		"signal_one": {
                "history" : [
                    {
                        "value" : 24.35156, 
                        "date" : "2020-08-04T09:30:00.000+0000"
                    }, 
                    {
                        "value" : 23.90625, 
                        "date" : "2020-08-04T09:31:00.000+0000"
                    }
                ]
            },
            "signal_two": {
                "history" : [
                    {
                        "value" : 22.16728, 
                        "date" : "2020-08-04T09:30:00.000+0000"
                    }, 
                    {
                        "value" : 18.19027, 
                        "date" : "2020-08-04T09:31:00.000+0000"
                    }
                ]    
    		}
    	}
    }
      
Altre domande? Invia una richiesta

0 Commenti

Accedi per aggiungere un commento.