Chaque rapport d’Analyses → Rapports est une requête. Pour trouver, enregistrer, partager ou ajouter des rapports à un tableau de bord, voir Bibliothèque de rapports ; cet article explique la requête elle-même.
Dans Rapports, vous posez une question à vos propres enregistrements dans un langage court et simple. Une requête indique d’où viennent les données, quoi afficher et comment regrouper :
FROM deliveries
SHOW sum(quantity) IN kg AS delivered
BY recipient
DURING this_quarter
COMPARE TO previous_period
Cela se lit : à partir des livraisons, affichez les kilos livrés à chaque acheteur ce trimestre, comparés au trimestre précédent. Les sacs et les tonnes sont convertis en kilos pour vous.
Comment une requête est construite
- FROM désigne un jeu de données : lots, livraisons, certificats, sites, travaux aux champs, etc.
- SHOW indique quoi afficher : des totaux comme
count(),sum(quantity)ouavg(moisture), ou des champs pour obtenir une liste d’enregistrements. - BY regroupe les totaux : par un champ (un acheteur, un produit) ou par
day,week,month,quarterouyear. - WHERE ne garde que certains enregistrements :
status = "active",product IN ("Café arábica"),NOT HAS certificate. - SINCE, DURING et COMPARE TO fixent la période et ce à quoi elle est comparée.
- VISUALIZE choisit la carte :
bar,line,donut,histogram,tableet d’autres. Sur la page d’un rapport, voir Choisir comment il est dessiné.
Appuyez sur Ctrl+Espace pour des suggestions et sur Ctrl+Entrée pour exécuter. Les noms que vous tapez, comme un acheteur, sont cherchés dans votre annuaire. Si quelque chose ne va pas, la requête dit quoi et comment corriger.
La construire, l’enregistrer, la mettre sur un tableau de bord
L’onglet Assistant de création écrit la même requête avec des menus : quoi afficher, comment regrouper, quels enregistrements et la période. Chaque changement apparaît dans le texte de la requête, et chaque changement du texte apparaît dans l’assistant. Enregistrer garde la requête pour vous, ou pour toute l’entreprise si vous gérez les tableaux de bord ; l’enregistrer à nouveau conserve les versions précédentes. Ajouter à un tableau de bord la place sur l’un de vos tableaux de bord comme une carte qui suit la requête enregistrée et prend la période du tableau de bord quand la requête n’en a pas. Chaque personne qui ouvre la carte voit ce que son propre rôle permet.
Résultats forestiers de vos parcelles
Le jeu de données sites contient aussi le résultat forestier de chaque parcelle, le même que celui de la tuile Forêt dans l’onglet Origine d’un lot. Les sites qui ne sont pas des parcelles, comme les entrepôts, n’en ont pas.
forest_result:no_loss(aucune perte de forêt détectée après le 31 déc. 2020),review(perte de forêt détectée : à examiner) ounot_enough_data(données insuffisantes).loss_in_forest_ha: les hectares de perte de couvert arboré après 2020 sur des terres boisées en 2020.forest_computed_at: la date du calcul du résultat.reviewed: si quelqu’un a consigné un examen du résultat.review_current: si le dernier examen porte sur les chiffres actuels de la parcelle.
Par exemple, pour compter vos parcelles par résultat :
FROM sites
SHOW count()
BY forest_result
Le résultat décrit les données. La conclusion de la diligence raisonnée revient à l’entreprise.
D’où viennent les chiffres
Chaque chiffre vient des enregistrements de votre entreprise, lus avec les droits de votre rôle. Les lignes inscrites au registre l’indiquent ; les enregistrements de l’annuaire et des revues indiquent « Enregistrements de la plateforme ». Une requête ne fait que lire : elle ne modifie jamais un enregistrement. Les personnes dont le rôle ne montre pas les données personnelles ne peuvent ni filtrer ni regrouper par elles.