Saltar al contenido principal

Tableros · Idea clave

Pregunta a tus registros con una consulta

Escribe una pregunta en pocas palabras, como kilos entregados por comprador este trimestre, y ve la respuesta en un gráfico y una tabla.

Cada informe de Analítica → Informes es una consulta. Para buscar, guardar, compartir o agregar informes a un tablero, lee Biblioteca de informes; este artículo explica la consulta en sí.

En Informes le haces una pregunta a tus propios registros en un lenguaje corto y simple. Una consulta dice de dónde salen los datos, qué mostrar y cómo agruparlo:

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

Se lee así: de las entregas, muestra los kilos entregados a cada comprador este trimestre, comparados con el trimestre anterior. Las bolsas y las toneladas se convierten a kilos por ti.

Cómo se arma una consulta

  • FROM indica un conjunto de datos: lotes, entregas, certificados, sitios, trabajo de campo y más.
  • SHOW dice qué mostrar: totales como count(), sum(quantity) o avg(moisture), o campos para obtener una lista de registros.
  • BY agrupa los totales: por un campo (un comprador, un producto) o por day, week, month, quarter o year.
  • WHERE deja solo algunos registros: status = "active", product IN ("Café arábica"), NOT HAS certificate.
  • SINCE, DURING y COMPARE TO fijan el período y con qué se compara.
  • VISUALIZE elige la tarjeta: bar, line, donut, histogram, table y otras. En la página de un informe, mira Elegir cómo se dibuja.

Pulsa Ctrl+Espacio para ver sugerencias y Ctrl+Enter para ejecutar. Los nombres que escribes, como un comprador, se buscan en tu directorio. Si algo no está bien, la consulta dice qué y cómo corregirlo.

Ármala, guárdala y ponla en un tablero

La pestaña Constructor escribe la misma consulta con menús: qué mostrar, cómo agrupar, qué registros y el período. Cada cambio aparece en el texto de la consulta, y cada cambio en el texto aparece en el constructor. Guardar guarda la consulta para ti, o para toda la empresa si administras tableros; al volver a guardarla se conservan las versiones anteriores. Agregar a un tablero la pone en uno de tus tableros como una tarjeta que sigue a la consulta guardada y toma el período del tablero cuando la consulta no tiene uno. Cada persona que abre la tarjeta ve lo que su propio rol permite.

Resultados forestales de tus parcelas

El conjunto de datos sites también tiene el resultado forestal de cada parcela, el mismo que muestra el recuadro Bosque en la pestaña Origen de un lote. Los sitios que no son parcelas de tierra, como los depósitos, no tienen ninguno.

  • forest_result: no_loss (no se detecta pérdida de bosque después del 31 dic 2020), review (pérdida de bosque detectada: revisar) o not_enough_data (datos insuficientes).
  • loss_in_forest_ha: las hectáreas de pérdida de cobertura arbórea después de 2020 en terreno que era bosque en 2020.
  • forest_computed_at: cuándo se calculó el resultado.
  • reviewed: si alguien registró una revisión del resultado.
  • review_current: si la última revisión se hizo sobre las cifras que la parcela tiene ahora.

Por ejemplo, para contar las parcelas por resultado:

FROM sites
SHOW count()
BY forest_result

El resultado describe los datos. La conclusión de la diligencia debida corresponde a la empresa.

De dónde vienen las cifras

Cada cifra sale de los registros de tu empresa, leídos con los permisos de tu rol. Las filas que están en el libro de registro lo indican; los registros del directorio y de revisión dicen «Registros de la plataforma». Una consulta solo lee: nunca cambia un registro. Quien no ve datos personales por su rol tampoco puede filtrar ni agrupar por ellos.