Éditeur de requêtes pour les sources de données

Créez des requêtes de source de données pour les widgets de tableaux et de graphiques afin de sélectionner des données spécifiques dans une base de données. Les requêtes se présentent sous la forme d’un champ de base de données suivi du signe « = » et d’un opérateur, d’un nombre ou d’une chaîne de caractères :

database_string=my string
database_number=1234
database_numger=BETWEEN(3, 6)

Les requêtes peuvent être enrichies par du code JavaScript spécifique :

Calcul de date et d'heure avec momentjs

Operateurs

Operateur	Description
`BETWEEN()`	Plage allant de la valeur de début à la valeur de fin. Les valeurs de début et de fin sont séparées par une virgule
`IN()`	Liste de nombres ou de chaînes de caractères séparés par des virgules à comparer
`GT()`	Valeur supérieure à
`LT()`	Valeur inférieure à
`NOT()`	Négation d'une expression
`AND()`	Liste d'expressions séparées par des virgules. Toutes doivent être satisfaites
`OR()`	Liste d'expressions séparées par des virgules. Au moins une doit être vérifiée
`NULL()`	Vérifie si une valeur est NULL

Exemples

Sélectionner tous les enregistrements dont le salaire est supérieur à 40 000 :

salary=GT(40000)

Sélectionner tous les enregistrements dont le nom n'est ni James, ni John, ni Joe :

name=NOT(IN(James%2CJohn%2CJoe))

Sélectionner tous les enregistrements dont le customerId n'est pas NULL :

customerId=NOT(NULL())

Les virgules dans les arguments doivent être échappées :

. -> %2C

Cela est nécessaire si des opérateurs imbriqués sont utilisés, comme dans l'exemple ci-dessus.

Exemples avec Moment.js

Dans les exemples suivants, params.interval est défini par un widget de sélection de date

Sélectionner uniquement les enregistrements dont la date se situe entre les paramètres de date et d'heure de début et de fin fournis par un widget de sélection de date. Les méthodes begin, end et format() de la bibliothèque momentjs sont utilisées :

date=BETWEEN(${interval(params.interval).begin.format()}, ${interval(params.interval).end.format()})

Sélectionner les enregistrements datant d’un an auparavant :

year=${interval(params.interval).begin.subtract(1, 'years').format('YYYY')}

Interroger le même mois de l’année précédente, le mois étant formaté sans zéros non significatifs :

month=${interval(params.interval).begin.subtract(params.sub, 'years').format('M')}

Interroger le jour de la semaine (0-6) :

weekday=${interval(params.interval).begin.day()}

Requête dépendante d’un paramètre

Si une requête ne doit être appliquée que si un paramètre spécifique est défini (par exemple, une requête de matrice de filtrage), la colonne ainsi que la chaîne de requête peuvent être placées dans des instructions if :

${filterMatrix.device_name ? 'device_name' : 'none'}=${filterMatrix.device_name ? filterMatrix.device_name : ''}

Si le paramètre filterMatrix.device_name est défini, la colonne sera définie sur « device_name » et la chaîne de requête sur « filterMatrix.device_name ») :

device_name=filterMatrix.device_name

Si ce même paramètre n’est pas défini, la requête résultante sera configurée pour la colonne « none », probablement inexistante :

 none=''