Syntax vzorcov

Na čo slúži editor vzorcov

Editor vzorcov vám umožňuje zostaviť vlastný výpočet z napísaných tokenov — operátorov, čísel a referencií na riadky, drivery, podpozície a KPI. Rovnaký editor, rovnaká syntax, pri každej metóde Vzorec kdekoľvek v aplikácii: riadky Plánovania, drivery Plánovania, KPI a vlastné dashboardy.

TL;DR

Napíšte číslo alebo operátor na vloženie tokenu. Napíšte názov na automatické dokončenie referencie. Každá referencia nesie voliteľný časový posun (tento mesiac / predchádzajúci mesiac / pred 1 rokom / Vlastný) a s doplnkom Oddelenia aj rozsah zdroja pre medzioddelenské referencie.

Tokeny

Vzorec je plochá postupnosť tokenov. Mriežka vykresľuje každý token ako štítok; Backspace v prázdnom vstupe odstráni posledný štítok.

Čísla

Napíšte ľubovoľné číslo (100, 0.05, -1.2) a stlačením Enter ho vložíte ako číselný token.

Operátory

Päť binárnych operátorov a zátvorky:

+   -   *   /   ^   (   )

Napíšte jeden s prázdnym vstupom a editor ho vloží okamžite. Napíšte postupnosť ako (price * volume) / 12 a pri každom tokene stlačte Enter.

Funkcie

K dispozícii sú tri funkcie. Napíšte názov a editor vloží kostru funkcie, ktorú vyplníte:

  • abs( ) — absolútna hodnota jedného výrazu, napr. abs(Revenues - Plan).
  • min( , ) — menší z dvoch výrazov, napr. min(Cash, 0).
  • max( , ) — väčší z dvoch výrazov, napr. max(EBT, 0).

abs prijíma jeden argument; min a max prijímajú presne dva a porovnávajú hodnoty v rovnakom období (nepracujú s oknom).

Referencie

Začnite písať názov pozície, podpozície, účtu, drivera alebo KPI. Rozbaľovacia ponuka automatického dokončenia sa zúži pri každom stlačení klávesu; stlačením Enter vložíte najlepšiu zhodu, alebo kliknutím na ľubovoľný výsledok ho vložíte priamo. Vo vzorci sa referencia vykresľuje ako štítok s označením riadka.

Referencie sa vyberajú z prehliadacieho výberu zoskupeného podľa zdroja: P&L, BS, CF, KPI plus drivery a pomocné podpozície. S doplnkom Oddelenia sa objaví ďalšia karta zdroja (pozri Medzioddelenské referencie nižšie).

Časové posuny

Každá referencia nesie časový posun — obdobie, z ktorého referencia číta, relatívne k aktuálnej bunke.

Kliknite na odznak posunu na ľubovoľnom štítku referencie a vyberte:

  • tento mesiac — month(0) (predvolené)
  • predchádzajúci mesiac — month(-1)
  • pred 1 rokom — month(-12)
  • Vlastný — otvorí modálne okno, kde nastavíte počet mesiacov a smer (nasledujúci / predchádzajúci), takže napr. month(-3) alebo month(+6) sú dosiahnuteľné

Časové posuny sa vyhodnocujú v čase výpočtu: Revenues@month(-12) číta hodnotu Výnosov dvanásť mesiacov pred počítanou bunkou.

Agregačné okná

Okrem časového posunu môže každá referencia niesť agregáciu kĺzavého okna — namiesto čítania jediného obdobia referencia číta kĺzavé okno a redukuje ho na jednu hodnotu. Kliknite na ovládač agregácie na štítku referencie a vyberte:

  • Súčet — sčíta referenciu cez okno (vykresľuje sa napr. ako Σ 12M).
  • Priemer — priemer referencie cez okno (vykresľuje sa napr. ako avg 3M).

Dĺžka okna je L3M (posledné 3 mesiace), L6M, L12M alebo Vlastná (nastavíte si vlastný počet mesiacov). Súčet cez L12M dáva súčet za posledných dvanásť mesiacov; Priemer cez L3M vyhladzuje zašumený mesačný rad. Agregácia sa kombinuje s časovým posunom — okno sa meria spätne od obdobia posunu.

Medzioddelenské referencie

V kontextoch, ktoré zahŕňajú viacero oddelení (doplnok Oddelenia), výber sprístupňuje ďalšiu kartu zdroja nad zoznamom referencií:

  • Oddelenia — vyberte členenie konkrétneho oddelenia ako zdroj. Medzioddelenské referencie sa vykresľujú s predponou krátkeho kódu na štítku, takže vidíte, ktoré oddelenie sa číta.
  • Všetky oddelenia — agregovaná možnosť, ktorá sčíta referenciu naprieč každým oddelením.

Štítok zobrazuje len krátky kód zdroja; kartu zdroja vo výbere je miestom, kde ho zmeníte.

Ovládanie editora

Vnútri editora:

  • Enter — vloží napísaný token (číslo / operátor / najlepšia zhoda automatického dokončenia), alebo potvrdí vzorec, keď je vstup prázdny
  • Escape — zahodí aktuálnu úpravu
  • Backspace v prázdnom vstupe — odstráni posledný štítok

Validácia

statycs validuje vzorce priebežne. Chyby sa objavia ako červený odznak ! vedľa vzorca s popisom opisujúcim príčinu:

  • Cyklická referencia — vzorec odkazuje priamo na svoj vlastný riadok. Tranzitívne cykly (A → B → A naprieč pozíciami) sa dnes nezisťujú.
  • Prerušená referencia — riadok, podpozícia alebo driver, na ktorý vzorec ukazuje, už neexistuje. Otvorte vzorec a odstráňte alebo nahraďte štítok.
  • Delenie nulou — menovateľ sa v jednom alebo viacerých obdobiach vyhodnotí na nulu. Obaľte menovateľ ochranou alebo vyberte inú referenciu.
  • Posun mimo dátovej sady — časový posun (napr. month(-12)) ukazuje na obdobie pred začiatkom dostupných dát. Objaví sa ako varovanie; buď zúžte posun, alebo akceptujte chýbajúce obdobia.

Chyby neblokujú ukladanie. Ovplyvnené bunky sa vyhodnotia na nulu, kým sa chyba neopraví, takže čiastočne prerušený vzorec vám nezabráni pokračovať — len neprispeje hodnotou.

Súvisiace