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,
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.
"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)
}
} }, ... ] } -
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" } ] } } }
0 Commenti