Naar de hoofdinhoud
Neem contact op

Dashboards · Kernbegrip

Uw gegevens bevragen met een query

Schrijf een vraag in een paar woorden, zoals geleverde kilo’s per koper dit kwartaal, en zie het antwoord als grafiek en tabel.

Elk rapport in Analyses → Rapporten is een query. Hoe u rapporten vindt, opslaat, deelt of aan een dashboard toevoegt, leest u in Rapportenbibliotheek; dit artikel legt de query zelf uit.

In Rapporten stelt u uw eigen gegevens een vraag in een korte, eenvoudige taal. Een query zegt waar de gegevens vandaan komen, wat u wilt tonen en hoe u groepeert:

FROM deliveries
SHOW sum(quantity) IN kg AS delivered
BY recipient
DURING this_quarter
COMPARE TO previous_period

Dat betekent: toon uit de leveringen de kilo’s die dit kwartaal aan elke koper zijn geleverd, vergeleken met het vorige kwartaal. Zakken en tonnen worden voor u omgerekend naar kilo.

Hoe een query is opgebouwd

  • FROM noemt een gegevensset: partijen, leveringen, certificaten, locaties, veldwerk en meer.
  • SHOW zegt wat u toont: totalen zoals count(), sum(quantity) of avg(moisture), of velden voor een lijst met records.
  • BY groepeert de totalen: op een veld (een koper, een product) of op day, week, month, quarter of year.
  • WHERE houdt alleen sommige records over: status = "active", product IN ("Café arábica"), NOT HAS certificate.
  • SINCE, DURING en COMPARE TO bepalen de periode en de vergelijking.
  • VISUALIZE kiest de kaart: bar, line, donut, histogram, table en andere. Op de pagina van een rapport, zie Kiezen hoe het getekend wordt.

Druk op Ctrl+Spatie voor suggesties en op Ctrl+Enter om uit te voeren. Namen die u typt, zoals een koper, worden in uw adresboek gezocht. Klopt er iets niet, dan zegt de query wat en hoe u het oplost.

Samenstellen, opslaan en op een dashboard zetten

Het tabblad Bouwer schrijft dezelfde query met menu’s: wat u toont, hoe u groepeert, welke records en de periode. Elke wijziging verschijnt in de querytekst, en elke wijziging in de tekst verschijnt in de bouwer. Opslaan bewaart de query voor u, of voor het hele bedrijf als u dashboards beheert; opnieuw opslaan bewaart de eerdere versies. Aan dashboard toevoegen zet hem als kaart op een van uw dashboards; de kaart volgt de opgeslagen query en neemt de periode van het dashboard als de query er geen heeft. Wie de kaart opent, ziet wat de eigen rol toestaat.

Bosresultaten van uw percelen

De gegevensset sites bevat ook het bosresultaat van elk perceel, hetzelfde dat de tegel Bos op het tabblad Herkomst van een partij toont. Locaties die geen perceel grond zijn, zoals magazijnen, hebben er geen.

  • forest_result: no_loss (geen bosverlies gevonden na 31 dec 2020), review (bosverlies gevonden: beoordelen) of not_enough_data (onvoldoende gegevens).
  • loss_in_forest_ha: de hectares verlies van boombedekking na 2020 op grond die in 2020 bos was.
  • forest_computed_at: wanneer het resultaat is berekend.
  • reviewed: of iemand een beoordeling van het resultaat heeft vastgelegd.
  • review_current: of de laatste beoordeling is gemaakt op de cijfers die het perceel nu heeft.

Bijvoorbeeld, om uw percelen per resultaat te tellen:

FROM sites
SHOW count()
BY forest_result

Het resultaat beschrijft de gegevens. De conclusie van de due diligence is aan het bedrijf.

Waar de cijfers vandaan komen

Elk cijfer komt uit de records van uw bedrijf, gelezen met de rechten van uw rol. Rijen die in het register staan, zeggen dat; adresboek- en beoordelingsrecords heten ‘Records van het platform’. Een query leest alleen: hij wijzigt nooit een record. Wie met de eigen rol geen persoonsgegevens ziet, kan er ook niet op filteren of groeperen.