Prérequis : s'être logué sur io-base depuis le module IndaSheet.
Dans le bandeau, ouvrir l'onglet IndaSheet et cliquer sur le bouton Récupération des données.
Un bandeau à droite apparaît. Il va vous permettre de saisir les paramètres voulus, afin d'interroger la base de données de Io-base et d'en récupérer des données.
Les types de requêtes possibles
Vous avez la possibilité d'interroger la base Io-base avec trois types de requêtes différentes :
RANGE : récupération des données d'une métrique entre deux dates
LATEST : récupération de la dernière valeur inscrite en base pour une ou plusieurs métriques
INSTANT : récupération de la valeur saisie à une date
Pour la requête RANGE, il est possible de choisir une méthode d’agrégation pour les données.
Le panneau de droite va vous assister dans la construction de la formule, et l'inscrire dans la cellule choisie. La formule fonctionnera alors comme tout autre formule d'un fichier Excel. Elle remontera, à partir de sa cellule, toutes les données brutes qui sont contenues dans la base de données, selon les paramètres définis.
Construction d'une formule
Cellule du résultat
La premier champ Cellule du résultat permet de définir la cellule dans laquelle la formule va s'inscrire. Il faut inscrire la référence de la cellule ("A1" par exemple) dans laquelle la formule s'inscrira (et donc à partir de laquelle les résultats apparaîtront). Vous pouvez aussi utiliser l'icône de grille, qui inscrira la cellule active dans le champ.
Paramètres de la formule
Cette section va vous permettre de définir les paramètres de la requête. En premier lieu, choisir le type de requête à exécuter dans le champ Type de formule.
Formule de type RANGE
La formule de type RANGE va permettre de récupérer les valeurs d'une métrique entre deux dates.
Source : nom de la base de données à interroger. Ce champ est une liste déroulante, qui affiche toutes les base de données existantes. En général, les données de production se trouvent dans la base de données prod.
Item(s) de données : nom de la métrique pour laquelle il faut remonter les données. Si le nom de la métrique est inscrit dans une cellule, vous pouvez la sélectionner en utilisant l'icône grille. Sinon, vous pouvez utiliser l'icône loupe qui vous permettra d'afficher la fenêtre de recherche.
Remarque : il est possible qu'un message demandant l'autorisation d'afficher la fenêtre apparaisse. Pour plus de détails sur la fenêtre de recherche, se référer à l'article correspondant.
Remarque : pour la fonction RANGE, il n'est possible de saisir qu'une métrique à la fois
Heure de début : date et heure pour le début de la plage de récupération des données. Vous pouvez saisir directement une valeur, ou bien vous servir de l'icône calendrier pour sélectionner la date et l'heure voulue.
Remarque : Si vous saisissez une valeur, elle doit être au format suivant : yyyy/MM/dd, hh:mm:ss
Heure de fin : date et heure pour la fin de la plage de récupération des données. Vous pouvez saisir directement une valeur, ou bien vous servir de l'icône calendrier pour sélectionner la date et l'heure voulue.
Remarque : Si vous saisissez une valeur, elle doit être au format suivant : yyyy/MM/dd, hh:mm:ss
Remarque : Le bouton "Jusqu'à maintenant" est mis à votre disposition, pour
indiquer la date actuelle comme date de fin.
Agrégations : vous pouvez choisir de récupérer les données brutes, ou agrégées. Pour paramétrer l'agrégation, il faut activer le bouton Je veux choisir des agrégations.
Une fois activé, ce bouton vous permet de sélectionner dans une liste l'agrégation voulue.
Vous avez le choix entre:
- MIN : valeur minimum
- MAX : valeur maximum
- SUM : somme
- AVG : valeur moyenne
- COUNT : nombre de valeurs
Après le type d'agrégation, vous devez indiquer la Fréquence. Cette fréquence définit l'intervalle dans lequel l'agrégation va être appliquée. Par exemple, si vous saisissez MIN pour une fréquence 1d, la requête vous renverra la valeur minimale de chaque jour. Vous pouvez saisir un nombre de jour, d'heure, de minutes et de secondes
(0d0h0m0s)
Remarque : La fréquence est optionnelle. Si vous ne saisissez aucune valeur, alors le résultat sera l'agrégation sur toute la plage choisie. Il n'y aura donc qu'une valeur de résultat (par exemple la valeur moyenne de toute la plage sélectionnée).
Formule de type LATEST
La formule de type LATEST va permettre de récupérer la dernière valeurs inscrite en base pour une ou plusieurs métriques
Source : nom de la base de données à interroger. Ce champ est une liste déroulante, qui affiche toutes les bases de données existantes. En général, les données de production se trouvent dans la base de données prod.
Item(s) de données : nom de la ou les métriques pour lesquelles il faut remonter les données. Si le nom des métriques sont inscrits dans une cellule, vous pouvez la sélectionner en utilisant l'icône grille. Sinon, vous pouvez utiliser l'icône loupe qui vous permettra d'afficher la fenêtre de recherche.
Remarque : il est possible qu'un message demandant l'autorisation d'afficher la fenêtre apparaisse. Pour plus de détails sur la fenêtre de recherche, se référer à l'article correspondant.
Remarque : pour la fonction LATEST, il est possible de saisir plusieurs métriques à la fois, en le séparant par des ";"
Remarque : si plusieurs métriques sont sélectionnées, il faut qu'elles fassent toutes parties de la même Source (même base de données). Sinon, il faudra faire des requêtes séparées.
Formule de type INSTANT
La formule de type INSTANT va permettre de récupérer de la valeur saisie à une date donnée.
Source : nom de la base de données à interroger. Ce champ est une liste déroulante, qui affiche toutes les bases de données existantes. En général, les données de production se trouvent dans la base de données prod.
Item(s) de données : nom de la ou les métriques pour lesquelles il faut remonter les données. Si le nom des métriques sont inscrits dans une cellule, vous pouvez la sélectionner en utilisant l'icône grille. Sinon, vous pouvez utiliser l'icône loupe qui vous permettra d'afficher la fenêtre de recherche.
Remarque : il est possible qu'un message demandant l'autorisation d'afficher la fenêtre apparaisse. Pour plus de détails sur la fenêtre de recherche, se référer à l'article correspondant.
Remarque : pour la fonction INSTANT, il est possible de saisir plusieurs métriques à la fois, en le séparant par des ";"
Remarque : si plusieurs métriques sont sélectionnées, il faut qu'elles fassent toutes parties de la même Source (même base de données). Sinon, il faudra faire des requêtes séparées.
Heure de début : date et heure pour laquelle on souhaite récupérer la valeur. Vous pouvez saisir directement une valeur, ou bien vous servir de l'icône calendrier pour sélectionner la date et l'heure voulue.
Remarque : Si vous saisissez une valeur, elle doit être au format suivant : yyyy/MM/dd, hh:mm:ss
Si aucune valeur n'existe à l'horodatage exact sélectionné, la requête va remonter la dernière valeur enregistrée en base juste avant l'horodatage choisi.
Paramètres d'affichage
Les champs suivants permettent de paramétrer l'affichage des résultats.
Affichage : ce bouton vous permets de choisir si vous souhaitez que les résultats s'affichent, à partir de la cellule de résultat, en ligne ou en colonne.
Horodatage : permet d'indiquer si vous voulez que la première colonne des résultats qui apparaîtra contiennent les horodatages des points. Si vous sélectionnez Sans, seules les valeurs remonteront. Si vous sélectionnez Avec, la première colonne contiendra les horodatages, et la seconde les valeurs.
Si vous choisissez d'afficher l'horodatage, vous devez indiquer la norme d'horodatage
souhaité (ISO ou locale) :
Afficher le nom de la métrique : si vous choisissez Oui pour ce champ, la première ligne contiendra le nom de la métrique. Avant les lignes contenant les résultats.
Une fois tous les champs renseignés, vous pouvez cliquer sur Appliquer. La formule est construite, et elle s'inscrit dans la cellule résultat qui est renseignée.
La formule est créée, et s'affiche dans la cellule de résultat sélectionnée.
Vidéo tutoriel : Récupération des données