Les types globaux sont des types de données fondamentaux qui ne peuvent être décomposés davantage. Ils respectent les normes de l'industrie et ne sont pas spécifiques à SmartSense.
Toutes les API SmartSense utilisent les types personnalisés suivants :
Chiffres
Fuseaux horaires
Énumérations
Vous trouverez ci-dessous une présentation détaillée de chacun de ces types globaux.
Chiffres
Byte - Les paramètres de type byte peuvent renvoyer ou accepter un nombre entier compris entre 0 et 255 inclus.
Entier (16 bits) - Les paramètres de type entier (16 bits) peuvent renvoyer ou accepter un nombre entier compris entre -32 768 et 32 767 inclus.
Entier (32 bits) - Les paramètres de type entier (32 bits) peuvent renvoyer ou accepter un nombre entier compris entre -2 147 483 648 et 2 147 483 647 inclus.
Entier (64 bits) - Les paramètres de type entier (64 bits) peuvent renvoyer ou accepter un nombre entier compris entre -9 223 372 036 854 775 808 et 9 223 372 036 854 775 807, inclus.
Float (32 bits) - Les paramètres de type float (32 bits) peuvent renvoyer ou accepter un nombre à virgule flottante de 4 octets.
Float (64 bits) - Les paramètres de type float (64 bits) peuvent renvoyer ou accepter un nombre à virgule flottante de 8 octets.
Décimal - Les paramètres de type décimal peuvent comporter une partie fractionnaire séparée par un point. Il est possible de spécifier le nombre de chiffres autorisés de part et d'autre du point.
Exemple : un type de paramètre défini comme « decimal (5,2) » comporterait au maximum 5 chiffres avant la virgule et 2 après.
Date - Les paramètres de type « date » doivent être envoyés au service (et proviennent de celui-ci) sous la forme d'une date et d'une heure combinées au format ISO 8601. Les informations relatives au fuseau horaire doivent être incluses, faute de quoi les résultats de l'appel de l'API ne sont pas définis.
Remarque : toutes les dates fournies par le service sont exprimées en UTC.
Fuseaux horaires
Les fuseaux horaires sont renvoyés sous forme de chaîne de caractères lisible par l'utilisateur, conformément à la description de l'IANA, et stockés dans sa base de données des fuseaux horaires.
Énumérations
Les champs de type énumération sont renvoyés sous forme de chaînes de caractères au format JSON. La valeur de la chaîne sera limitée aux valeurs possibles de l'énumération, telles que définies pour le type. Tous les types d'énumération peuvent prendre la valeur null.
Type de groupe
Spécifie le type d'un groupe.
Les valeurs sont les suivantes :
« Compte »
« Organisation »
« Lieu »
« Département »