Barre d'export API
En-têtes de colonnes des exports CSV
Dans Data Flow, vous pouvez décider d'afficher soit le libellé des dimensions, soit les libellés des dimensions ET des groupes de dimensions dans les entêtes de colonnes des fichiers CSV :
Pour que cette configuration soit prise en compte, il est impératif de sauvegarder le flux.
Séparateur décimal
Dans Data Flow, vous pouvez configurer le caractère séparateur de décimales: point ou virgule.
Pour que cette configuration soit prise en compte, il est impératif de sauvegarder le flux, y compris avant de télécharger le fichier de test.
Format de sortie
L’Api Data Flow offre 2 formats : JSON & CSV.
Ce format peut être choisi en haut à droite de la zone ci-dessus, ou changé directement dans l’URL API.
Note: Le format peut être changé à la volée directement dans l’URL sans avoir à éditer le flux; changer le format et sauvegarder les modifications.
Conseil:
Le format JSON est plus lourd que le format CSV, nous recommandons d’utiliser le format CSV pour un téléchargement plus rapide. Si le format JSON est plus intéressant pour vous, vous pouvez demander un fichier compressé via l'en-tête de l’appel API afin de diminuer son poids.
Plus de détails sur la compression des fichiers sur : API Technical Documentation.
Enregistrer un flux
Quand vous avez créé un flux, cliquez sur “Sauvegarder” sans oublier de lui donner un nom.
Si vous enregistrez les modifications appliquées sur un flux existant vous aurez le message suivant. Ce message signifie que l'URL précédente cessera de fonctionner dans les 7 jours. Après 7 jours, cette URL recevra un message d'erreur de l'API et la nouvelle URL devra être utilisée.
Gestion des périodes
Data Flow s’actualise toutes les heures ou toutes les demi-heures.
Format horaire:
Le format pour interroger au format heure est le suivant: YYYY-MM-DDTHH
Lorsque vous cliquez sur “Copier l’URL”, n’oubliez pas de spécifier l’heure à laquelle vous souhaitez extraire les données pour que cela puisse fonctionner correctement.
Format demi-heure:
Le format pour interroger à la demi-heure est le suivant: start:'yyyy-MM-ddTHH:mm',end:'yyyy-MM-ddTHH:mm'
il est nécessaire de spécifier les minutes de début et de fin:
Pour les 30 premières minutes de chaque heure : start: 00 ; end: 29
Pour les deuxièmes 30 minutes de chaque heure : start: 30 ; end: 59
Conseil:
Seules les valeurs "0" et "30" sont valides dans le champ "mm" pour le paramètre "start:"
Seules les valeurs "29" et "59" sont valides dans le champ "mm" pour le paramètre "end:"
Exemples:
Pour requêter les données sur une plage de 30 minutes à 16h le 25 juillet 2018 (de 16h à 16h29):
start:'2018-07-25T16:00',end:'2018-07-25T16:29'
Pour requêter les données sur une plage de 30 minutes à 9h30 le 25 juillet 2018 (9h30 à 9h59):
start:'2018-07-25T09:30',end:'2018-07-25T09:59'
Conseil:
Les données ne sont disponibles que pour des heures et demi-heures complètes. Nous disposons d’un délai de 3 à 5 min pour les données en temps réel. Nous vous conseillons donc de patienter 10 min avant d’interroger l’heure ou la demi-heure précédente dans le but de limiter autant que possible ce message d’erreur : “Data Not ready”.
Supprimer un flux
Sur la page d’accueil de l’application vous pouvez: Supprimer un flux existant, le renommer ou l’éditer.
Pour supprimer plusieurs flux, sélectionnez-les à la gauche du tableau puis cliquez sur le bouton “Supprimer” au dessus.
