6 Echantillon d’objet DataChunk version 2 au format JSON.
DataChunk version 2 est la version actuelle des objets DataChunk utilisés par DotVision
Les DataChunks sont un format propriétaire de DotVision utilisé pour transporter des données de type série temporelle, telles que les valeurs des DataPoints.
La spécification complète du format DataChunk version 2 est accessible depuis le site de DotVision à l’adresse https://docs.blueforest.io/docs/datachunk/
Cette section décrit uniquement le sous-ensemble des fonctionnalités DataChunk V2 utilisées par les appareils Spoony. Les champs non utilisés ne sont pas mentionnés mais sont documentés dans les spécifications détaillées mentionnées plus haut.
Spoony utilise actuellement la version 2.0 du format DataChunk.
La version actuelle des appareils supporte uniquement l’encodage JSON.
Le diagramme de classes suivant résume l’architecture des objets DataChunk
Figure 1 – Diagramme de classe de l’objet DataChunk
1 Objet DataChunk
Property |
Name |
Type |
Card. |
Description |
v |
Version |
String |
1 |
Datachunk Version. Currently 2.0 |
f |
From |
DateTime |
1 |
Timestamp when this datachunk start. UTC Time |
t |
To |
DateTime |
1 |
Timestamp when this datachunk end. UTC Time |
r |
Records |
* |
List of Records |
Figure 2 - DataChunk object specifications
2 Objet Record
Property |
Name |
Type |
Card. |
Description |
d |
DeviceId |
String |
1 |
Device Id (Friendly Name) |
u |
Unit |
String |
1 |
Unit as configured in DataChunk Service |
s |
Series |
* |
List of Series |
Figure 3 - Record object specifications
Sur les appareils Spoony, un objet Record est créé pour chaque Unit unique déclarée dans la configuration du DataChunk service version 2.
3 Objet Serie
Property |
Name |
Type |
Card. |
Description |
m |
Measurement |
String |
1 |
Measurement name |
t |
Type |
String |
1 |
Always “float” on Spoony devices |
s |
Samples |
* |
List of Samples |
Figure 4 - Serie object specifications
Sur les appareils Spoony, le Measurement name est le nom spécifié comme alias dans la configuration du DataChunk service version 2, ou le nom du DataPoint par défaut.
4 Objet Sample
Property |
Name |
Type |
Card. |
Description |
i |
Index |
Int64 |
1 |
Sample’s Index. Represent the order those samples were generated on the device |
t |
Timestamp |
DateTime |
1 |
Timestamp when the measure was Taken. UTC time |
q |
Quality |
String |
1 |
Value quality. Always “good” currently |
v |
Value |
Float |
1 |
DataPoint value. Always floating-point type on Spoony devices. |
e |
Extensions |
? |
Minimum/Maximum values extension |
Figure 5 - Sample object specifications
Le champ value a deux valeurs possibles sur les appareils Spoony :
- Si la fonctionnalité d’intégration est activée dans le service DataChunk pour le DataPoint correspondant, le champ value correspond à la valeur moyenne calculée
- Sinon, le champ value correspond à la valeur instantanée.
Le champ extension est uniquement présent lorsque l’agrégation est activée pour le DataPoint correspondant, et est décrit dans le paragraphe suivant.
5 Objet MinMax extension
Property |
Name |
Type |
Card. |
Description |
min |
Minimum |
Float |
1 |
Minimum value over aggregation period |
max |
Maximum |
Float |
1 |
Maximum value over aggregation period |
Figure 6 - MinMax extension object specifications
L’extension MinMax est seulement disponible lorsque la fonction d’agrégation est activée pour le DataPoint correspondant dans la configuration du service DataChunk. Voir le paragraphe 4.7.3.1.1 pour plus de détails sur la fonction d’aggrégation.
6 Echantillon d’objet DataChunk version 2 au format JSON
L’exemple suivant est un DataChunk version 2.0 valide capturé depuis un appareil Spoony, qui peut être utilisé comme référence. Il contient à la fois des Samples standard ainsi que des Samples agrégés avec valeurs moyenne, minimum et maximum.
Figure 7 – Echantillon d’objet DataChunk Version 2 au format JSON
Figure 1 – Diagramme de classe de l’objet DataChunk
Figure 2 - DataChunk object specifications
Figure 3 - Record object specifications
Figure 4 - Serie object specifications
Figure 5 - Sample object specifications
Figure 6 - MinMax extension object specifications
Figure 7 – Echantillon d’objet DataChunk Version 2 au format JSON
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.