[Intum Pomoc](https://intum.pl/pomoc.md) / [Insight](https://intum.pl/pomoc/insight.md)

# [Jak działa Insight - zbiory, pola, wartości](https://intum.pl/pomoc/insight/insight-jak-dziala.md)

Każdy wykres w Insight stoi na tych samych trzech klockach. Warto je poznać, zanim założysz pierwszy
własny raport - wtedy wiadomo, co dokładnie trzeba dostarczyć, żeby linia na wykresie się pojawiła.

> [!PATH]
> [Insight → Zbiory danych](app:/insight/datasets) → **Dodaj**

## Zbiór danych {#zbior-danych}

**Zbiór danych** to teczka na liczby jednego tematu: „sprzedaż", „zapisy na newsletter", „magazyn".
Ma **Nazwę** (widoczną na listach) i **Kod** - krótki identyfikator małymi literami, bez spacji
(`sprzedaz`, `newsletter`), którym posługujesz się w raportach i w API. Moduły Intum mają swoje
zbiory założone z góry (np. `helpdesk`, `mail`, `voip`) i same je zasilają.

## Pole {#pole}

**Pole** to jedna mierzona wielkość w zbiorze: „liczba zamówień", „wartość brutto", „liczba zapisów".
Tak jak zbiór ma **Nazwę** i **Kod** (`zamowienia`, `wartosc_brutto`). W raporcie wskazujesz pole
razem ze zbiorem, zapisem z kropką: `sprzedaz.zamowienia`, `sprzedaz.wartosc_brutto`.

Pola są wspólne dla całego konta, nie przypięte do jednego zbioru - to samo pole `liczba` może
występować w kilku zbiorach. Dlatego zawsze podaje się parę „zbiór.pole".

## Wartość {#wartosc}

**Wartość** to pojedyncza liczba z **datą**: „2026-09-15, `sprzedaz.zamowienia`, 42". Wykres to
po prostu ciąg takich wartości ułożony w czasie. Zasady:

- na jeden dzień, jedno pole i jedną serię przypada **jedna wartość** - drugą tego samego dnia
  system odrzuci jako duplikat; żeby poprawić liczbę, edytujesz istniejącą wartość,
- wartości z kilku dni składają się na tydzień czy miesiąc według **agregacji** wybranej nad
  wykresem (suma, mediana, średnia) - zapisujesz więc liczby dzienne, resztę liczy wykres,
- datę podawaj z godziną w środku dnia (np. 12:00). Wartość zapisana o północy może po zmianie
  strefy czasowej „przeskoczyć" na sąsiedni dzień.

## Seria (encja) {#seria}

Gdy ta sama wielkość dotyczy wielu osób, produktów czy regionów, każdej wartości możesz dopisać
**Encję** - krótką etykietę serii: `region_pl`, `produkt_123`, `u_36860`. Raport z włączonymi
seriami rysuje wtedy osobną linię dla każdej encji zamiast jednej łącznej. Etykieta w formie
`u_<numer>` jest zamieniana na nazwę użytkownika konta; każda inna wyświetla się dosłownie, więc
wybieraj takie, które da się czytać w legendzie. Jak z seriami pracować na wykresie:
[Serie na wykresie](insight/insight-serie-na-wykresie).

## Skąd biorą się liczby {#skad-liczby}

- **Moduły Intum** liczą swoje zbiory same: raz dziennie w nocy za poprzedni dzień, a na żądanie
  przyciskiem **Policz do teraz** przy raporcie.
- **Własne zbiory** zasilasz ty: przez API ze swojego systemu, skryptu czy automatyzacji, albo
  ręcznie na liście [Wartości zbioru danych](app:/insight/dataset_values). Krok po kroku:
  [Własne dane - ręcznie i przez API](insight/insight-dane-przez-api).

Przy każdym raporcie i zbiorze widać **Dane policzone do** - datę ostatniej wartości. Jeśli
zatrzymała się kilka dni temu, zasilanie przestało działać - patrz
[Dane przestały spływać](insight/insight-problemy-dane-przestaly-splywac).

## Alerty {#alerty}

**Alert** to warunek sprawdzany na danych zbiorów raz dziennie („zamówień mniej niż 10",
„czas reakcji powyżej godziny") - gdy jest spełniony, na liście alertów widać ostrzeżenie. Zakłada
je i odczytuje administracja konta (dostęp **Wszystkie raporty Insight**) na liście
[Alerty](app:/insight/alerts). Jak zapisać warunek i co się dzieje po jego spełnieniu:
[Alerty](insight/insight-alerty).