Składnia formuł

Do czego służy edytor formuł

Edytor formuł pozwala zbudować niestandardowe obliczenie z wpisywanych tokenów — operatorów, liczb i odwołań do wierszy, driverów, subpozycji oraz KPI. Ten sam edytor, ta sama składnia, przy każdej metodzie Formuła w całej aplikacji: w wierszach Planowania, w driverach Planowania, w KPI oraz we własnych dashboardach.

Tokeny

Formuła to płaska sekwencja tokenów. Siatka renderuje każdy token jako chip; Backspace przy pustym polu wprowadzania usuwa ostatni chip.

Liczby

Wpisz dowolną liczbę (100, 0.05, -1.2) i naciśnij Enter, aby wstawić ją jako token liczbowy.

Operatory

Pięć operatorów binarnych i nawiasy:

+   -   *   /   ^   (   )

Wpisz jeden z nich przy pustym polu, a edytor wstawi go natychmiast. Wpisz sekwencję taką jak (price * volume) / 12 i naciśnij Enter przy każdym tokenie.

Funkcje

Dostępne są trzy funkcje. Wpisz nazwę, a edytor wstawi szkielet funkcji do uzupełnienia:

• abs( ) — wartość bezwzględna pojedynczego wyrażenia, np. abs(Revenues - Plan).
• min( , ) — mniejsze z dwóch wyrażeń, np. min(Cash, 0).
• max( , ) — większe z dwóch wyrażeń, np. max(EBT, 0).

abs przyjmuje jeden argument; min i max przyjmują dokładnie dwa i porównują wartości w tym samym okresie (nie operują na oknie).

Odwołania

Zacznij wpisywać nazwę pozycji, subpozycji, konta, drivera lub KPI. Lista autouzupełniania zawęża się przy każdym naciśnięciu klawisza; naciśnij Enter, aby wstawić najlepsze dopasowanie, lub kliknij dowolny wynik, aby wstawić go bezpośrednio. Wewnątrz formuły odwołanie renderuje się jako chip z etykietą wiersza.

Odwołania wybiera się z selektora do przeglądania pogrupowanego według źródła: P&L, BS, CF, KPI, a także drivery i pomocnicze subpozycje. Przy dodatku Działy pojawia się dodatkowa zakładka źródła (zob. Odwołania międzydziałowe poniżej).

Przesunięcia czasowe

Każde odwołanie ma przesunięcie czasowe — okres, z którego odwołanie odczytuje dane, względem bieżącej komórki.

Kliknij pigułkę przesunięcia na dowolnym chipie odwołania, aby wybrać:

• bieżący miesiąc — month(0) (domyślnie)
• poprzedni miesiąc — month(-1)
• rok temu — month(-12)
• Niestandardowe — otwiera okno, w którym ustawiasz liczbę miesięcy oraz kierunek (następne / poprzednie), dzięki czemu osiągalne są np. month(-3) lub month(+6)

Przesunięcia czasowe są rozwiązywane w momencie obliczania: Revenues@month(-12) odczytuje wartość Przychodów sprzed dwunastu miesięcy względem obliczanej komórki.

Okna agregacji

Oprócz przesunięcia czasowego każde odwołanie może nieść agregację w oknie kroczącym — zamiast odczytywać pojedynczy okres, odwołanie odczytuje okno kroczące i redukuje je do jednej wartości. Kliknij element sterujący agregacją na chipie odwołania, aby wybrać:

• Suma — sumuje odwołanie w oknie (renderuje się np. jako Σ 12M).
• Średnia — średnia odwołania w oknie (renderuje się np. jako avg 3M).

Długość okna to L3M (ostatnie 3 miesiące), L6M, L12M lub Niestandardowa (ustawiasz własną liczbę miesięcy). Suma po L12M daje sumę z ostatnich dwunastu miesięcy; Średnia po L3M wygładza zaszumiony szereg miesięczny. Agregacja łączy się z przesunięciem czasowym — okno jest odmierzane wstecz od okresu przesunięcia.

Odwołania międzydziałowe

W kontekstach obejmujących wiele działów (dodatek Działy) selektor udostępnia dodatkową zakładkę źródła nad listą odwołań:

• Działy — wybierz jako źródło wycinek konkretnego działu. Odwołania międzydziałowe renderują się z prefiksem skróconego kodu na chipie, więc widać, z którego działu następuje odczyt.
• Wszystkie działy — opcja zagregowana, która sumuje odwołanie po wszystkich działach.

Chip pokazuje jedynie skrócony kod źródła; źródło zmieniasz w zakładce źródła w selektorze.

Elementy sterujące edytora

Wewnątrz edytora:

• Enter — wstaw wpisany token (liczba / operator / najlepsze dopasowanie autouzupełniania) lub zatwierdź formułę, gdy pole wprowadzania jest puste
• Escape — odrzuć bieżącą edycję
• Backspace przy pustym polu — usuń ostatni chip

Walidacja

statycs waliduje formuły na bieżąco. Błędy pojawiają się jako czerwona plakietka ! obok formuły, z podpowiedzią opisującą przyczynę:

• Odwołanie cykliczne — formuła odwołuje się bezpośrednio do własnego wiersza. Cykle przechodnie (A → B → A między pozycjami) nie są obecnie wykrywane.
• Zerwane odwołanie — wiersz, subpozycja lub driver, na który wskazuje formuła, już nie istnieje. Otwórz formułę i usuń lub zamień chip.
• Dzielenie przez zero — mianownik przyjmuje wartość zero w jednym lub kilku okresach. Otocz mianownik zabezpieczeniem lub wybierz inne odwołanie.
• Przesunięcie poza zbiorem danych — przesunięcie czasowe (np. month(-12)) wskazuje na okres sprzed początku dostępnych danych. Pojawia się jako ostrzeżenie; albo zmniejsz przesunięcie, albo zaakceptuj brakujące okresy.

Błędy nie blokują zapisu. Komórki, których dotyczą, przyjmują wartość zero do czasu naprawy błędu, więc częściowo zepsuta formuła nie powstrzyma Cię od dalszej pracy — po prostu nie wniesie żadnej wartości.

Powiązane

• Metody planowania — metoda Formuła w wierszach planowania
• Drivery — drivery są przywoływane w formułach
• Działy — odwołania międzydziałowe z dodatkiem