Erinevused

Siin näed erinevusi valitud versiooni ja hetkel kehtiva lehekülje vahel.

--- et:retsepti_asetaja_tyybid [2026/08/26 13:37] – tekitatud kete
+++ et:retsepti_asetaja_tyybid [2026/08/26 14:33] (Hetkel kehtiv) – kete
@@ Rida 1: / Rida 1: @@
-# Retsepti asetaja tüüp
+[[et:yld_retsept#rat10|<<< Tagasi]]
-Directo retseptid ei ole ainult staatilised komponentide loetelud. Iga retsepti rea juures saab veerus **Retsepti asetaja tüüp** määrata, mis tüüpi rida see on ja **kuidas rida käitub retsepti asetajas** – vaates, mis avaneb toote omaduste valimiseks (nn *Vali omadused*). Koos rea abiväljadega (**Sisu**, **Filter**, **Filter rn**, **Väärtus**, **Kogus**) saab nii ehitada retsepte, mis toimivad **tootekonfiguraatorina**: kasutaja valib mõõdud ja omadused, ning Directo koostab nende põhjal automaatselt õige komponentide ja operatsioonide koosseisu.
+====== Retsepti asetaja tüüp ======
-See juhend selgitab kõiki asetaja tüüpe, abiväljade koostoimet ja toob kaks anonümiseeritud näidisretsepti (lihtne ja konfiguraatori tasemel).
+Directo retseptid ei ole ainult staatilised komponentide loetelud. Iga retsepti rea juures saab veerus **Retsepti asetaja tüüp** määrata, mis tüüpi rida see on ja **kuidas rida käitub retsepti asetajas** – vormis, mis avaneb toote omaduste valimiseks (nn //Vali omadused//). Koos rea abiväljadega (**Sisu**, **Filter**, **Filter rn**, **Väärtus**, **Kogus**) saab nii ehitada retsepte, mis toimivad **tootekonfiguraatorina**: kasutaja valib mõõdud ja omadused ning Directo koostab nende põhjal automaatselt õige komponentide ja operatsioonide koosseisu.
-> **Märkus näidete kohta.** Kõik selle juhendi artiklikoodid, klassid, lisaväljad ja töökeskused on **väljamõeldud näited**. Kasuta oma andmebaasis kehtivaid koode.
+See juhend selgitab kõiki asetaja tüüpe, abiväljade koostoimet ja toob kaks näidisretsepti (lihtne ja konfiguraatori tasemel).
----
+----
-## 1. Kuidas retsept ja asetaja kokku käivad
+:!: Kõik selle juhendi artiklikoodid, klassid, lisaväljad ja töökeskused on **väljamõeldud näited**. Oma andmebaasis tuleb kasutada kehtivaid koode.
-Retsepti dokumendil kirjeldad **read** – iga rida on kas mõõt/parameeter, artikkel, arvutus, teksti-vahepealkiri või artikli lisavälja info. Kui retsept asetatakse mõnele dokumendile (nt tellimusele või tootmisele) ja retsept on seadistatud kasutaja sisendit küsima, avaneb **retsepti asetaja** – vorm, kus kasutaja täidab mõõdud ja teeb valikud. Valikute põhjal arvutab Directo kogused ja asetab dokumendile õiged read.
+----
-Ülal vasakul on asetajas alati väli **Kogus** – see on toote (dokumendi rea) kogus, millega kogu retsept läbi korrutatakse.
+===== Kuidas retsept ja asetaja kokku käivad =====
-Allservas on valik **Kirjuta dokumendi read üle** ja nupp **Aseta retsept**.
+Retsepti dokumendil kirjeldatakse **read** – iga rida on kas mõõt/parameeter, artikkel, arvutus, teksti-vahepealkiri või artikli lisavälja info. Kui retsept asetatakse mõnele dokumendile (nt tellimusele või tootmisele) ja retsept on seadistatud kasutaja sisendit küsima, avaneb **retsepti asetaja** – vorm, kus kasutaja täidab mõõdud ja teeb valikud. Valikute põhjal arvutab Directo kogused ja asetab dokumendile õiged read.
----
+Ülal vasakul on asetajas alati väli **Kogus** – see on toote (dokumendi rea) kogus, millega kogu retsept läbi korrutatakse. Allservas on valik **Kirjuta dokumendi read üle** ja nupp **Aseta retsept**.
-## 2. Rea abiväljad, mis mõjutavad asetaja käitumist
+//(Lisa siia ekraanipilt: retsepti asetaja vorm „Vali omadused".)//
+===== Rea abiväljad, mis mõjutavad asetaja käitumist =====
 Enne tüüpide juurde asumist tasub tunda viit veergu, mis koos asetaja tüübiga kogu loogika loovad.
-| Väli | Tähendus |
-|------|----------|
-| **Sisu** | Tüübist sõltuv sisend. Valikute puhul komadega eraldatud artiklikoodide/väärtuste loend; klassi puhul klassi kood; lisavälja puhul lisavälja kood. |
-| **Filter** | Tingimus või lubatud väärtusvahemik. Näiteks vahemik `10:100` (min:max) või konkreetsed väärtused `A` või `3,4`. Kasutatakse nii sisendi piiramiseks kui ka rea tinglikuks kuvamiseks. |
-| **Filter rn** | Rea number (**r**ea **n**umber), millele **Filter** viitab. Nii ehitatakse tingimusi teistele ridadele: „rakenda/kuva see rida siis, kui viidatud real on Filtris antud väärtus". |
-| **Väärtus** | Lisatingimus või fikseeritud väärtus (nt lisavälja väärtus, mille järgi artikleid piiritleda). |
-| **Kogus** | Rea koguse valem. Vt allpool oleva valemikeele selgitust. |
-### 2.1 Koguse valemikeel: rea viide vs. konstant
+| Väli           | Tähendus                                                                                                                                                                                |
+|                |                                                                                                                                                                                         |
+| **Sisu**       | Tüübist sõltuv sisend. Valikute puhul komadega eraldatud artiklikoodide/väärtuste loend; klassi puhul klassi kood; lisavälja puhul lisavälja kood.                                      |
+| **Filter**     | Tingimus või lubatud väärtusvahemik. Näiteks vahemik `10:100` (min:max) või konkreetsed väärtused `A` või `3,4`. Kasutatakse nii sisendi piiramiseks kui ka rea tinglikuks kuvamiseks.  |
+| **Filter rn**  | Rea number (**r**ea **n**umber), millele **Filter** viitab. Nii ehitatakse tingimusi teistele ridadele: „rakenda/kuva see rida siis, kui viidatud real on Filtris antud väärtus".       |
+| **Väärtus**    | Lisatingimus või fikseeritud väärtus (nt lisavälja väärtus, mille järgi artikleid piiritleda).                                                                                          |
+==== Koguse valemikeel: rea viide vs. konstant ====
 See on Directo retseptide üks olulisemaid nüansse:
-- **Paljas number viitab teisele reale** selle **Rida**-numbri järgi ja kasutab selle rea tulemust/kogust.
+  * **Paljas number viitab teisele reale** selle **Rida**-numbri järgi ja kasutab selle rea tulemust/kogust.
-- **Loogeliste sulgudega arv `{ }` on püsikonstant** (fikseeritud arv).
-Kuna paljas arv loetakse alati rea viiteks, tuleb **iga „päris" arv panna loogeliste sulgude sisse**. Nii eristab Directo, kas mõtled rida või arvu.
+  * **Loogeliste sulgudega arv ''{ }'' on püsikonstant** (fikseeritud arv).
+Kuna paljas arv loetakse alati rea viiteks, tuleb **iga „päris" arv panna loogeliste sulgude sisse**. Nii eristab Directo, kas mõeldakse rida või arvu.
 Näited (tuletatud allpool olevast lihtsast näitest):
-- `{0.5}` → konstant 0,5.
+  * ''{0.5}'' → konstant 0,5.
-- `50*{2}` → *rea 50 kogus* korda konstant 2. Kui real 50 on kogus 0,5, siis tulemus on `0,5 × 2 = 1`.
-- `{1}*130` → konstant 1 korda *rea 130 tulemus*.
-- `{3.14}` → konstant π ligikaudse väärtusena (kasulik nt kaare pikkuse arvutamisel).
----
+  * ''50*{2}'' → //rea 50 kogus// korda konstant 2. Kui real 50 on kogus 0,5, siis tulemus on ''0,5 × 2 = 1''.
-## 3. Retsepti asetaja tüübid
+  * ''{1}*130'' → konstant 1 korda //rea 130 tulemus//.
-### Tekst
+  * ''{3.14}'' → konstant π ligikaudse väärtusena (kasulik nt kaare pikkuse arvutamisel).
-Tavaline tekstirida. Tekst kirjutatakse **Nimetus** väljale ja asetajas kuvatakse see **vahepealkirjana**. Kasuta plokkide eraldamiseks (nt *MÕÕDUD*, *MATERJALID*, *OPERATSIOONID*), et vorm oleks kasutajale loogiliselt jaotatud.
-Tekstirida saab teha ka **tinglikuks** – täites **Filter** ja **Filter rn** väljad kuvatakse tekst (nt hoiatus või juhis) ainult siis, kui viidatud real on vastav väärtus.
+===== Retsepti asetaja tüübid =====
-### Parameeter
+==== Tekst ====
-Parameetri tüüpi rida küsib asetajas **mõõtu, arvu või valikut, mis ei ole otseselt seotud ühegi artikliga** – näiteks pikkus, laius, sektsioonide arv. Kasutaja sisestatud väärtusele saab teistes ridades viidata rea numbriga.
-- **Filter** väljal saab piirata lubatud vahemikku, nt `10:100`, või pakkuda kindlaid valikuid.
+Tavaline tekstirida. Tekst kirjutatakse **Nimetus** väljale ja asetajas kuvatakse see **vahepealkirjana**. Sobib plokkide eraldamiseks (nt //MÕÕDUD//, //MATERJALID//, //OPERATSIOONID//), et vorm oleks loogiliselt jaotatud.
-- Kui **Sisu** väljale panna komadega loend (nt `A,B,C,D`), kuvatakse asetajas rippmenüü nende valikutega.
+Tekstirida saab teha ka **tinglikuks**: kui täita väljad **Filter** ja **Filter rn**, kuvatakse tekst (nt hoiatus või juhis) ainult siis, kui viidatud real on vastav väärtus.
+==== Parameeter ====
+Parameetri tüüpi rida küsib asetajas **mõõtu, arvu või valikut, mis ei ole otseselt seotud ühegi artikliga** – näiteks pikkust, laiust või sektsioonide arvu. Kasutaja sisestatud väärtusele saab teistelt ridadelt viidata rea numbriga.
+  * **Filter** väljal saab piirata lubatud vahemikku, nt ''10:100''.
+  * Kui **Sisu** väljale panna komadega loend (nt ''A,B,C,D''), kuvatakse asetajas rippmenüü nende valikutega.
+==== Artikkel ====
-### Artikkel
 Kõige tavalisem rida: retsepti reale on artiklite andmebaasist valitud **konkreetne artikkel**. Kogus arvutatakse **Kogus** veeru valemi järgi. Sama tüüpi kasutatakse ka **operatsioonide** kirjeldamiseks (töökeskusega ridadel).
-### Artikkel: valik
+==== Artikkel: valik (Artikkel üksikvalik)====
-Kasutaja saab **Sisu** väljale panna **komadega eraldatud artiklikoodide loendi**. Asetajas kuvatakse neist **rippmenüü**, kust saab valida **ainult ühe** artikli.
-Kasuta siis, kui reale sobib täpselt üks variant mitmest (nt üks profiil, üks kinnitustüüp).
+**Sisu** väljale saab panna **komadega eraldatud artiklikoodide loendi**. Asetajas kuvatakse neist **rippmenüü**, kust saab valida **ainult ühe** artikli. Sobib olukorda, kus reale sobib täpselt üks variant mitmest (nt üks profiil või üks kinnitustüüp).
-### Artikkel: nimekiri
+==== Artikkel: nimekiri (Artikkel mitmikvalik) ====
-Sarnaneb valikuga, kuid **Sisu** väljale pandud komadega loendist kuvatakse asetajas **märkeruutudega loetelu**, kust saab teha **mitu valikut** korraga.
-Kasuta siis, kui kasutaja võib soovida mitut lisandust korraga (nt mitu lisatööd või mitu viimistlust).
+Sarnaneb valikuga, kuid **Sisu** väljale pandud loendist kuvatakse asetajas **märkeruutudega loetelu**, kust saab teha **mitu valikut** korraga. Sobib olukorda, kus kasutaja võib soovida mitut lisandust korraga (nt mitut lisatööd või viimistlust).
-### Artikkel: klass
+==== Artikkel: klass (Artikkel klassi järgi) ====
-Avab asetajas artiklite asetaja, mis on **filtreeritud kindla artikliklassi järgi**. Klassi kood pannakse **Sisu** väljale. Kasutaja valib artikli nendest, mis sellesse klassi kuuluvad.
-Kasuta siis, kui valikud on liiga arvukad käsitsi loetlemiseks, kuid nad on ühes artikliklassis.
+Avab asetajas artiklite valiku, mis on **filtreeritud kindla artikliklassi järgi**. Klassi kood pannakse **Sisu** väljale. Sobib siis, kui valikuid on käsitsi loetlemiseks liiga palju, kuid nad kuuluvad ühte artikliklassi.
-### Artikkel: lisaväli
+==== Artikkel: lisaväli (Artikkel lisavälja järgi) ====
-Avab asetajas artiklite asetaja, mis on **filtreeritud kindla artikli lisavälja järgi**. Lisavälja kood pannakse **Sisu** väljale ja soovitud lisavälja väärtust saab piiritleda **Väärtus** väljal.
-Kasuta siis, kui valikute hulk tuleb piiritleda mõne artiklikaardi lisavälja alusel.
+Avab asetajas artiklite valiku, mis on **filtreeritud kindla artikli lisavälja järgi**. Lisavälja kood pannakse **Sisu** väljale ning soovitud lisavälja väärtust saab piiritleda **Väärtus** väljal. Sobib siis, kui valikute hulk tuleb piirata artiklikaardi lisavälja alusel.
-> **Tähelepanu – kaks sarnase nimega, kuid erineva mõttega tüüpi:**
+:?: Tähelepanu – kaks sarnase nimega, kuid erineva tähendusega tüüpi: **Artikkel: lisaväli** = //vali// artikkel, mis on lisavälja järgi filtreeritud; **Artikli lisaväli** (allpool) = //loe// mõne teise rea artiklilt lisavälja sisu välja.
-> - **Artikkel: lisaväli** = *vali* artikkel, mis on lisavälja järgi filtreeritud.
-> - **Artikli lisaväli** (allpool) = *loe* mõne teise rea artiklilt lisavälja **sisu välja**.
-### Artikli lisaväli
+==== Artikli lisaväli (Lisavälja väärtus)====
-Kasutatakse, kui soovid **tuua välja mõne teisel real valitud artikli kaardilt kindla lisavälja sisu**. **Sisu** väljale pannakse lisavälja kood ja **Filter rn** väljale selle rea number, mille artiklilt info loetakse.
-Näide: kui real 10 on valitud „Profiil" ja soovid näidata selle profiili painutusraadiust, teed rea tüübiga *Artikli lisaväli*, **Sisu** = lisavälja kood, **Filter rn** = 10.
+Kasutatakse siis, kui soovitakse **tuua välja mõnel teisel real valitud artikli kaardilt kindla lisavälja sisu**. **Sisu** väljale pannakse lisavälja kood ja **Filter rn** väljale selle rea number, mille artiklilt info loetakse.
+Näiteks kui real 10 on valitud „Profiil" ja soovitakse näidata selle profiili painutusraadiust, tehakse rida tüübiga //Artikli lisaväli//, **Sisu** = lisavälja kood, **Filter rn** = 10.
+==== Arvutus: nähtav ====
-### Arvutus: nähtav
 Rida, millel tehakse arvutus (**Kogus**/valemi veerus) ja mille **tulemust soovitakse asetajas kuvada**. Sobib, kui kasutaja peab arvutustulemust nägema (nt „Laius kokku mm").
-### Arvutus: peidus
+==== Arvutus: peidus ====
-Sama, mis nähtav arvutus, kuid **tulemust asetajas ei näidata**. Sobib abiarvutusteks, mille vahetulemust kasutajale näidata pole vaja, kuid millele teised read viitavad.
-> **Ajalooline märkus.** Varem oli lihtsalt üks valik *Arvutus*. Nüüd on see jaotatud kaheks: senine *Arvutus* vastab valikule **Arvutus: peidus**, ja juurde on tulnud **Arvutus: nähtav** nende arvutuste jaoks, mille tulemust tahetakse asetajas näidata.
+Sama, mis nähtav arvutus, kuid **tulemust asetajas ei kuvata**. Sobib abiarvutusteks, mille vahetulemust kasutajale näidata pole vaja, kuid millele teised read viitavad.
----
+:?: Varem oli üks valik //Arvutus//. Nüüd on see jaotatud kaheks: senine //Arvutus// vastab valikule **Arvutus: peidus**, ning juurde on tulnud **Arvutus: nähtav** nende arvutuste jaoks, mille tulemust tahetakse asetajas näidata.
-## 4. Näide 1 – lihtne retsept, mis tutvustab kõiki tüüpe
+===== Näide: lihtne retsept, mis tutvustab kõiki tüüpe =====
-Alljärgnev retsept on koostatud **õppeotstarbel**, et näidata iga asetaja tüüpi töös. Kõik koodid on väljamõeldud.
+Alljärgnev retsept on koostatud õppeotstarbel, et näidata iga asetaja tüüpi töös.
+//(Lisa siia ekraanipilt: retsepti read.)//
+| Rida  | Artikkel      | Nimetus                                           | Retsepti asetaja tüüp  | Sisu                          | Filter    | Filter rn  | Väärtus  | Kogus        | Töökeskus  |
+|       |               |                                                   |                        |                               |           |            |          |              |            |
+| 10    |               | MÕÕDUD / PARAMEETRID                              | Tekst                  |                               |           |            |          |              |            |
+| 20    |               | Pikkus                                            | Parameeter             |                               |           |            |          |              |            |
+| 30    |               | Laius (piiranguga 10:100)                         | Parameeter             |                               | `10:100`  |            |          |              |            |
+| 40    |               | MATERJALID                                        | Tekst                  |                               |           |            |          |              |            |
+| 50    | MATERJAL-01   | Materjal tootmiseks 1                             | Artikkel               |                               |           |            |          | `{0.5}`      |            |
+| 60    | MATERJAL-02   | Materjal tootmiseks 2                             | Artikkel               |                               |           |            |          | `50*{2}`     |            |
+| 70    | SN-MATERJAL   | Seerianumbriga materjal                           | Artikkel               |                               |           |            |          | `{1}`        |            |
+| 80    |               | Komponent valikuga                                | Artikkel: valik        | `KOMP-100,KOMP-200,KOMP-300`  |           |            |          | `{1}*85`     |            |
+| 85    |               | kogus                                             | Parameeter             |                               |           |            |          |              |            |
+| 90    |               | TÖÖTLUS                                           | Tekst                  |                               |           |            |          |              |            |
+| 100   |               | Järeltöötluse valik                               | Artikkel: nimekiri     | `VIIMISTLUS-1,VIIMISTLUS-2`   |           |            |          | `{1}*20*30`  |            |
+| 110   |               | Kattematerjal (klassi valik)                      | Artikkel: klass        | `KLASS-MAT`                   |           |            |          | `{1}`        |            |
+| 120   |               | Detaili tüübi valik                               | Parameeter             | `A,B,C,D`                     |           |            |          |              |            |
+| 130   |               | Detaili kogus                                     | Parameeter             |                               | `1:10`    |            |          |              |            |
+| 140   | TOODE-A1      | Detaili valik tüübile A                           | Artikkel: valik        | `TOODE-A1,TOODE-A2`           | `A`       | 120        |          | `{1}*130`    |            |
+| 150   |               | Detaili valik tüübile B                           | Artikkel: nimekiri     | `TOODE-B1,TOODE-B2`           | `B`       | 120        |          | `{1}*130`    |            |
+| 160   | MOODUL-D      | Uus moodul                                        | Artikkel               |                               | `D`       | 120        |          | `{1}*130`    |            |
+| 170   |               | Artikli asetaja lisavälja järgi                   | Artikkel: lisaväli     | `TOOTEGRUPP`                  |           |            | `PÜSI`   | `{1}*130`    |            |
+| 180   |               | Eelmiselt realt valitud artiklilt lisavälja info  | Artikli lisaväli       | `PEATOODE`                    |           | 170        |          |              |            |
+| 190   |               | OPERATSIOONID                                     | Tekst                  |                               |           |            |          |              |            |
+| 200   | OP-EELTÖÖ     | Eeltööd                                           | Artikkel               |                               |           |            |          | `{0.17}`     | TK-EEL     |
+| 210   | OP-SAAG       | Tootmises tehtav operatsioon – saagimine          | Artikkel               |                               |           |            |          | `{0.17}`     | TK-SAAG    |
+| 220   | OP-PLASMA     | Plasma lõikus                                     | Artikkel               |                               |           |            |          | `{0.01}`     | TK-PLASMA  |
+| 230   | OP-PAIGALDUS  | Paigaldus                                         | Artikkel               |                               |           |            |          | `{1.00}`     | TK-PAIG    |
+| 240   |               | Lisatööde valik soovi korral                      | Artikkel: nimekiri     | `KILE,LAKK,LISA-1,LISA-2`     |           |            |          | `{1}*130`    |            |
-| Rida | Artikkel | Nimetus | Retsepti asetaja tüüp | Sisu | Filter | Filter rn | Väärtus | Kogus | Töökeskus |
-|-----:|----------|---------|-----------------------|------|--------|----------:|---------|-------|-----------|
-| 10 | | MÕÕDUD / PARAMEETRID | Tekst | | | | | | |
-| 20 | | Pikkus | Parameeter | | | | | | |
-| 30 | | Laius (piiranguga 10:100) | Parameeter | | `10:100` | | | | |
-| 40 | | MATERJALID | Tekst | | | | | | |
-| 50 | MATERJAL-01 | Materjal tootmiseks 1 | Artikkel | | | | | `{0.5}` | |
-| 60 | MATERJAL-02 | Materjal tootmiseks 2 | Artikkel | | | | | `50*{2}` | |
-| 70 | SN-MATERJAL | Seerianumbriga materjal | Artikkel | | | | | `{1}` | |
-| 80 | | Komponent valikuga | Artikkel: valik | `KOMP-100,KOMP-200,KOMP-300` | | | | `{1}*85` | |
-| 85 | | kogus | Parameeter | | | | | | |
-| 90 | | TÖÖTLUS | Tekst | | | | | | |
-| 100 | | Järeltöötluse valik | Artikkel: nimekiri | `VIIMISTLUS-1,VIIMISTLUS-2` | | | | `{1}*20*30` | |
-| 110 | | Kattematerjal (klassi valik) | Artikkel: klass | `KLASS-MAT` | | | | `{1}` | |
-| 120 | | Detaili tüübi valik | Parameeter | `A,B,C,D` | | | | | |
-| 130 | | Detaili kogus | Parameeter | | `1:10` | | | | |
-| 140 | TOODE-A1 | Detaili valik tüübile A | Artikkel: valik | `TOODE-A1,TOODE-A2` | `A` | 120 | | `{1}*130` | |
-| 150 | | Detaili valik tüübile B | Artikkel: nimekiri | `TOODE-B1,TOODE-B2` | `B` | 120 | | `{1}*130` | |
-| 160 | MOODUL-D | Uus moodul | Artikkel | | `D` | 120 | | `{1}*130` | |
-| 170 | | Artikli asetaja lisavälja järgi | Artikkel: lisaväli | `TOOTEGRUPP` | | | `PÜSI` | `{1}*130` | |
-| 180 | | Eelmiselt realt valitud artiklilt lisavälja info | Artikli lisaväli | `PEATOODE` | | 170 | | | |
-| 190 | | OPERATSIOONID | Tekst | | | | | | |
-| 200 | OP-EELTÖÖ | Eeltööd | Artikkel | | | | | `{0.17}` | TK-EEL |
-| 210 | OP-SAAG | Tootmises tehtav operatsioon – saagimine | Artikkel | | | | | `{0.17}` | TK-SAAG |
-| 220 | OP-PLASMA | Plasma lõikus | Artikkel | | | | | `{0.01}` | TK-PLASMA |
-| 230 | OP-PAIGALDUS | Paigaldus | Artikkel | | | | | `{1.00}` | TK-PAIG |
-| 240 | | Lisatööde valik soovi korral | Artikkel: nimekiri | `KILE,LAKK,LISA-1,LISA-2` | | | | `{1}*130` | |
 **Kuidas seda lugeda:**
-- **Read 10, 40, 90, 190** on *Tekst* – asetajas vahepealkirjad, mis jaotavad vormi plokkideks.
+  * **Read 10, 40, 90, 190** on //Tekst// – asetajas vahepealkirjad, mis jaotavad vormi plokkideks.
-- **Read 20, 30, 85, 120, 130** on *Parameeter*. Real 30 piirab `Filter = 10:100` sisestatava laiuse vahemikku. Real 120 pakub `Sisu = A,B,C,D` rippmenüü.
-- **Read 50–70** on tavalised *Artikkel* read. Real 50 on kogus `{0.5}` (konstant), real 60 `50*{2}` = *rea 50 kogus* × 2 = 0,5 × 2 = **1**. Just nii kuvab asetaja MATERJAL-01 koguseks 0,5 ja MATERJAL-02 koguseks 1.
-- **Rida 80** on *Artikkel: valik* – asetajas rippmenüü kolme komponendi vahel; kogus `{1}*85` viitab real 85 sisestatud kogusele.
-- **Rida 100** on *Artikkel: nimekiri* – märkeruutudega loetelu, kust saab valida mitu viimistlust korraga.
-- **Rida 110** on *Artikkel: klass* – avab artiklite asetaja klassist `KLASS-MAT`.
-- **Read 140, 150, 160** on tinglikud: `Filter rn = 120` viitab „Detaili tüübi valik" reale ja `Filter` väärtus (`A`, `B`, `D`) määrab, milline rida rakendub vastavalt kasutaja valikule. Nii rakendub A-tüübi korral rida 140, B-tüübi korral rida 150, D-tüübi korral rida 160.
-- **Rida 170** on *Artikkel: lisaväli* – avab artiklite asetaja, mis on filtreeritud lisavälja `TOOTEGRUPP` järgi (`Väärtus = PÜSI`).
-- **Rida 180** on *Artikli lisaväli* – loeb real 170 valitud artikli kaardilt lisavälja `PEATOODE` sisu (`Filter rn = 170`).
-- **Read 200–230** on operatsioonid: *Artikkel* tüüp koos töökeskusega; kogused on ajanormid (nt `{0.17}` tundi).
----
+  * **Read 20, 30, 85, 120, 130** on //Parameeter//. Real 30 piirab ''Filter = 10:100'' sisestatava laiuse vahemikku, real 120 pakub ''Sisu = A,B,C,D'' rippmenüü.
-## 5. Näide 2 – konfiguraatori tasemel retsept
+  * **Read 50–70** on tavalised //Artikkel// read. Real 50 on kogus ''{0.5}'' (konstant), real 60 ''50*{2}'' = //rea 50 kogus// × 2 = 0,5 × 2 = **1**. Just nii kuvab asetaja materjali ''MATERJAL-01'' koguseks 0,5 ja ''MATERJAL-02'' koguseks 1.
-See näide demonstreerib **arvutusi, konstante ja tinglikku loogikat** keerukama toote juures. Kirjeldatud on väljamõeldud **konfigureeritav profiiltoode** (nt reguleeritava pikkusega profiilsüsteem koos kinnituste ja lisadega). Kõik koodid on väljamõeldud.
+  * **Rida 80** on //Artikkel: valik// – asetajas rippmenüü kolme komponendi vahel; kogus ''{1}*85'' viitab real 85 sisestatud kogusele.
-| Rida | Artikkel | Nimetus | Retsepti asetaja tüüp | Sisu | Filter | Filter rn | Kogus |
+  * **Rida 100** on //Artikkel: nimekiri// – märkeruutudega loetelu mitme viimistluse valimiseks.
-|-----:|----------|---------|-----------------------|------|--------|----------:|-------|
-| 10 | | Profiil | Artikkel: valik | `PROF-A100,PROF-A200,PROF-A300` | | | |
+  * **Rida 110** on //Artikkel: klass// – avab artiklite valiku klassist ''KLASS-MAT''.
-| 20 | | Toote gabariitlaius mm | Parameeter | | `1:10000` | | |
-| 30 | | Sektsioonide arv | Parameeter | | `1:100` | | |
+  * **Read 140, 150, 160** on tinglikud: ''Filter rn = 120'' viitab reale „Detaili tüübi valik" ja ''Filter'' väärtus (''A'', ''B'', ''D'') määrab, milline rida rakendub. A-tüübi korral rakendub rida 140, B-tüübi korral rida 150 ja D-tüübi korral rida 160.
-| 40 | | Kaugus seinast mm | Parameeter | | `1:10000` | | |
-| 50 | | Painutuse raadius | Artikli lisaväli | `RAADIUS` | | 10 | |
+  * **Rida 170** on //Artikkel: lisaväli// – avab artiklite valiku, mis on filtreeritud lisavälja ''TOOTEGRUPP'' järgi (''Väärtus = PÜSI'').
-| 94 | | Abikaugus min | Arvutus: peidus | | `0:149` | | `{150}-13` |
-| 95 | | Abikaugus tasandus | Arvutus: peidus | | `0:149` | | `94*14` |
+  * **Rida 180** on //Artikli lisaväli// – loeb real 170 valitud artikli kaardilt lisavälja ''PEATOODE'' sisu (''Filter rn = 170'').
-| 100 | | Kaare pikkus mm | Arvutus: nähtav | | `1:10000000` | | `{3.14}/{2}*40-40*25/30+94` |
-| 200 | | Sektsioonisamm mm | Parameeter | `40,60,70,110,0` | | | |
+  * **Read 200–230** on operatsioonid: //Artikkel// tüüp koos töökeskusega; kogused on ajanormid (nt ''{0.17}'' tundi).
-| 210 | | Elemente ühes sektsioonis | Parameeter | | | | `100/30/200+{1}` |
-| 300 | ELEM-STND | Standardelement | Artikkel: valik | `ELEM-STND,ELEM-PLUS` | | | `210*30` |
+===== Näide: konfiguraatori tasemel retsept =====
-| 400 | | Otsakork | Artikkel: valik | `OTS-A100,OTS-A200` | | | `{2}` |
-| 500 | | --NB! Lisa liide kui pikkus üle 5000 mm-- | Tekst | | `5000:10000` | 100 | |
+See näide demonstreerib **arvutusi, konstante ja tinglikku loogikat** keerukama toote juures. Kirjeldatud on **konfigureeritav profiiltoode** (nt reguleeritava pikkusega profiilsüsteem koos kinnituste ja lisadega).
-| 510 | | Liidete kogus | Parameeter | `0,1,2,3` | | | |
-| 520 | LIIDE-A100 | Liide | Artikkel: valik | `LIIDE-A100` | `1:4` | 510 | `510` |
+| Rida  | Artikkel    | Nimetus                                    | Retsepti asetaja tüüp  | Sisu                             | Filter        | Filter rn  | Kogus                        |
-| 600 | | Kinnituste kogus kokku | Parameeter | | | | `100/{500}+{1}` |
+|       |             |                                            |                        |                                  |               |            |                              |
-| 610 | KINN-STD | Standardkinnitused | Artikkel: valik | `KINN-STD` | | | `600` |
+| 10    |             | Profiil                                    | Artikkel: valik        | `PROF-A100,PROF-A200,PROF-A300`  |               |            |                              |
-| 700 | OP-MIN1 | Tööminutid kvalifikatsioon 1 | Artikkel | | | | `{8}` |
+| 20    |             | Toote gabariitlaius mm                     | Parameeter             |                                  | `1:10000`     |            |                              |
-| 800 | | ---LISAD--- | Tekst | | | | |
+| 30    |             | Sektsioonide arv                           | Parameeter             |                                  | `1:100`       |            |                              |
-| 810 | | Tõmbevarda kogus | Parameeter | `0,1,2,3` | | | |
+| 40    |             | Kaugus seinast mm                          | Parameeter             |                                  | `1:10000`     |            |                              |
-| 820 | VARDA-A100 | Tõmbevarras | Artikkel: valik | `VARDA-A100,VARDA-A150` | `1:4` | 810 | `810` |
+| 50    |             | Painutuse raadius                          | Artikli lisaväli       | `RAADIUS`                        |               | 10         |                              |
-| 900 | | Värv (lisaandmeks, mitte täidetav) | Artikli lisaväli | `VARV` | | 10 | |
+| 94    |             | Abikaugus min                              | Arvutus: peidus        |                                  | `0:149`       |            | `{150}-13`                   |
+| 95    |             | Abikaugus tasandus                         | Arvutus: peidus        |                                  | `0:149`       |            | `94*14`                      |
+| 100   |             | Kaare pikkus mm                            | Arvutus: nähtav        |                                  | `1:10000000`  |            | `{3.14}/{2}*40-40*25/30+94`  |
+| 200   |             | Sektsioonisamm mm                          | Parameeter             | `40,60,70,110,0`                 |               |            |                              |
+| 210   |             | Elemente ühes sektsioonis                  | Parameeter             |                                  |               |            | `100/30/200+{1}`             |
+| 300   | ELEM-STND   | Standardelement                            | Artikkel: valik        | `ELEM-STND,ELEM-PLUS`            |               |            | `210*30`                     |
+| 400   |             | Otsakork                                   | Artikkel: valik        | `OTS-A100,OTS-A200`              |               |            | `{2}`                        |
+| 500   |             | --NB! Lisa liide kui pikkus üle 5000 mm--  | Tekst                  |                                  | `5000:10000`  | 100        |                              |
+| 510   |             | Liidete kogus                              | Parameeter             | `0,1,2,3`                        |               |            |                              |
+| 520   | LIIDE-A100  | Liide                                      | Artikkel: valik        | `LIIDE-A100`                     | `1:4`         | 510        | `510`                        |
+| 600   |             | Kinnituste kogus kokku                     | Parameeter             |                                  |               |            | `100/{500}+{1}`              |
+| 610   | KINN-STD    | Standardkinnitused                         | Artikkel: valik        | `KINN-STD`                       |               |            | `600`                        |
+| 700   | OP-MIN1     | Tööminutid kvalifikatsioon 1               | Artikkel               |                                  |               |            | `{8}`                        |
+| 800   |             | ---LISAD---                                | Tekst                  |                                  |               |            |                              |
+| 810   |             | Tõmbevarda kogus                           | Parameeter             | `0,1,2,3`                        |               |            |                              |
+| 820   | VARDA-A100  | Tõmbevarras                                | Artikkel: valik        | `VARDA-A100,VARDA-A150`          | `1:4`         | 810        | `810`                        |
+| 900   |             | Värv (lisaandmeks, mitte täidetav)         | Artikli lisaväli       | `VARV`                           |               | 10         |                              |
 **Mida see näide õpetab:**
-- **Konstant vs. rea viide.** Real 94 tähendab valem `{150}-13` konstanti 150 miinus *rea 13 tulemus* (`{150}` on püsiarv, `13` viide reale 13). Real 100 on `{3.14}` (π) ja `{2}` konstandid, ülejäänud arvud (`40`, `25`, `30`, `94`) viitavad ridadele. Nii saab valemis segada püsiarve ja teiste ridade tulemusi.
+  * **Konstant vs. rea viide.** Real 94 tähendab valem ''{150}-13'' konstanti 150 miinus //rea 13 tulemus// (''{150}'' on püsiarv, ''13'' viide reale 13). Real 100 on ''{3.14}'' (π) ja ''{2}'' konstandid, ülejäänud arvud (''40'', ''25'', ''30'', ''94'') viitavad ridadele.
-- **Arvutus: peidus vs. nähtav.** Read 94 ja 95 on abiarvutused, mida kasutajale ei näidata; rida 100 „Kaare pikkus mm" on kasutajale nähtav arvutustulemus.
-- **Artikli lisaväli.** Rida 50 loeb real 10 valitud profiili kaardilt lisavälja `RAADIUS` (`Filter rn = 10`). Rida 900 teeb sama värvi lisaväljaga – hea viis tuua toote andmed dokumendile, ilma et kasutaja peaks neid käsitsi sisestama.
+  * **Arvutus: peidus vs. nähtav.** Read 94 ja 95 on abiarvutused, mida kasutajale ei kuvata; rida 100 „Kaare pikkus mm" on kasutajale nähtav arvutustulemus.
-- **Tinglik tekst.** Rida 500 on hoiatustekst, mis kuvatakse ainult siis, kui rea 100 (pikkus) väärtus on vahemikus 5000–10000 (`Filter = 5000:10000`, `Filter rn = 100`).
-- **Tinglik artikkel koguse järgi.** Read 520 ja 820 rakenduvad ainult siis, kui vastav kogusrida (510 või 810) on vahemikus 1–4, ning nende kogus võetakse otse sellelt realt (`Kogus = 510` / `Kogus = 810`).
+  * **Artikli lisaväli.** Rida 50 loeb real 10 valitud profiili kaardilt lisavälja ''RAADIUS'' (''Filter rn = 10''). Rida 900 teeb sama värvi lisaväljaga – nii jõuavad toote andmed dokumendile ilma käsitsi sisestamata.
-- **Sammu-põhine valik.** Rida 200 pakub `Sisu = 40,60,70,110,0` – kindlad valikväärtused rippmenüüs.
+  * **Tinglik tekst.** Rida 500 on hoiatustekst, mida kuvatakse ainult siis, kui rea 100 (pikkus) väärtus on vahemikus 5000–10000 (''Filter = 5000:10000'', ''Filter rn = 100'').
+  * **Tinglik artikkel koguse järgi.** Read 520 ja 820 rakenduvad ainult siis, kui vastav kogusrida (510 või 810) on vahemikus 1–4, ning nende kogus võetakse otse sellelt realt (''Kogus = 510'' / ''Kogus = 810'').
+  * **Sammupõhine valik.** Rida 200 pakub ''Sisu = 40,60,70,110,0'' – kindlad valikväärtused rippmenüüs.
+===== Näpunäited hea retsepti ehitamiseks =====
+  * **Struktuur enne sisu.** //Tekst//-read (vahepealkirjad) tasub paika panna kohe alguses, et asetaja vorm oleks loetav ja loogiliselt jaotatud.
+  * **Ridade numbritesse jäetakse ruumi.** Kasutades samme (10, 20, 30 …) saab hiljem ridu vahele lisada ilma viiteid ümber tegemata.
+  * **Konstandi reegel.** Iga „päris" arv koguse valemis kuulub loogeliste sulgude sisse – muidu loeb Directo selle rea viitena.
+  * **Abiarvutuste kasutamine.** Keeruka valemi saab jagada mitmeks //Arvutus: peidus// reaks, mis teeb retsepti loetavamaks ja hõlpsamini hooldatavaks.
+  * **Õige valikutüübi valimine.** Üks variant → //Artikkel: valik//; mitu varianti korraga → //Artikkel: nimekiri//; palju sarnaseid artikleid → //Artikkel: klass// või //Artikkel: lisaväli//.
----
+  * **Asetaja testimine.** Enne kasutuselevõttu tasub asetaja läbi täita ja veenduda, et tinglikud read (Filter / Filter rn) rakenduvad õigesti ning kogused arvutatakse ootuspäraselt.
-## 6. Näpunäited hea retsepti ehitamiseks
+----
-- **Alusta struktuurist.** Pane *Tekst*-read (vahepealkirjad) kohe paika, et asetaja vorm oleks kasutajale loetav ja loogiliselt jaotatud.
+:!: Käesolev juhend on nõuandev. Konkreetse retsepti seadistuse õigsust tasub alati kontrollida asetajat läbi testides.
-- **Jäta ridade numbritesse ruumi.** Kasuta samme (10, 20, 30 …), et hiljem saaks vahele lisada uusi ridu ilma kõiki viiteid ümber tegemata.
-- **Pea meeles konstandi reeglit.** Iga „päris" arv koguse valemis kuulub loogeliste sulgude sisse – muidu loeb Directo selle rea viitena.
-- **Kasuta abiarvutusi.** Keerulise valemi saab jagada mitmeks *Arvutus: peidus* reaks – see teeb retsepti loetavamaks ja lihtsamini hooldatavaks.
-- **Vali õige valikutüüp.** Üks variant → *Artikkel: valik*; mitu varianti korraga → *Artikkel: nimekiri*; palju sarnaseid artikleid → *Artikkel: klass* või *Artikkel: lisaväli*.
-- **Testi asetajat.** Ava asetaja ja täida vorm läbi, et veenduda, et tinglikud read (Filter / Filter rn) rakenduvad õigesti ja kogused arvutatakse ootuspäraselt.
----
-*Käesolev juhend on nõuandev. Konkreetse retsepti seadistuse õigsust tasub alati kontrollida asetajat läbi testides.*