Referenca nastavitev podatkovnega modela

To poglavje pojasnjuje ustaljeni pomen nastavitev podatkovnega modela. Natančen položaj kontrolnika se lahko spremeni, vendar te izbire določajo kanonično definicijo in vedenje med izvajanjem.

Nova spremenljivka (New Variable)

Odprite Nova spremenljivka (New Variable) v razdelku Podatkovni model, na strani (Page), v izbirniku definicij formule ali z gumbom + v tabeli izhodnih spremenljivk. V splošnih kontekstih najprej izberite, ali želite določiti formulo ali shraniti vrednost brez formule. Nato izberite namen Izračunaj (Calculate) in po potrebi še cilj; nastavite ime, vrsto vrednosti in obseg. Z možnostjo Nadaljuj na formulo (Continue to formula) odprete urejevalnik formul, medtem ko pot za shranjeno vrednost uporabi možnost Ustvari spremenljivko (Create Variable) in ne doda vira izračuna. V tabeli izhodnih spremenljivk namen in cilj določa sama tabela, zato izbira med formulo in shranjevanjem ter izbira cilja nista na voljo.

Izračunaj (Calculate)

• Shranjena ali prikazana vrednost (Stored or displayed value) ustvari spremenljivko brez samodejnega vira izračuna. Nanj se je mogoče takoj sklicevati, vendar ostane prazna ali ohrani obstoječo vrednost, dokler je ne zapiše drug vir.
• Začetna ali naključna vrednost (Starting or random value) enkrat izračuna formulo ob začetku igre. Privzeto je to številska spremenljivka za posameznega igralca.
• Vrednost, izračunana za to stran (Value calculated for this Page) izračuna formulo, ko se prikaže stran, ki vsebuje spremenljivko. Če izbiro opravite zunaj določene strani, enakovredni cilj velja vsakič, ko se prikaže stran, ki jo vsebuje.
• Rezultat prehoda faze (Result of a Stage transition) zapiše spremenljivko po koncu izbrane faze prostega formata in pred začetkom naslednje faze.
• Rezultat tržne transakcije (Result of a Market trade) zapiše spremenljivko po vsaki tržni transakciji za račun izbrane vrste igralca.
• Periodično izračunana vrednost (Periodically calculated value) zapiše spremenljivko ob vsakem izvajanju izbranega periodičnega prehoda na trgu. Če trg nima periodičnega prehoda, lahko pogovorno okno ustvari prehod z enosekundnim intervalom.

Seznam je odvisen od konteksta. Namen, specifičen za fazo ali trg, je uporaben samo, če trenutna igra vsebuje združljiv cilj.

Mesto izračuna (Calculation Location)

Drugi izbirnik se prikaže samo, če obstaja več kot en konkreten cilj. Označen je z Faza (Stage), Vrsta igralca (Player type) ali Periodični dogodek (Periodic event). Če obstaja samo en cilj, je namesto tega prikazano pojasnjevalno besedilo. Na voljo so naslednja mesta izračuna:

• Samo prikaz ali sklicevanje (Display or reference only) ne ustvari formule ali dodelitve izhoda.
• Ob začetku igre (At game start) shrani vneseno formulo kot začetni izračun spremenljivke.
• Ponovno izračunaj ob prikazu te strani (Recalculate when this Page is displayed) pripne izračun ob prikazu strani.
• Po _fazi_ (After _Stage_) doda izhod spremenljivke tej fazi prostega formata.
• Po vsaki tržni transakciji – _vrsta igralca_ (After every Market trade - _Player Type_) doda izhod v izhode transakcij računa te vrste igralca.
• Periodično – _interval_ sekund (Periodically - _interval_ seconds) doda izhod izbranemu tržnemu prehodu.
• Periodično – ustvari enosekundni tržni prehod (Periodically - create a 1-second Market transition) ustvari prehod in doda njegov izhod.

Pogovorno okno za vire v splošnem podatkovnem modelu lahko za zaključevanje trga dodatno ponudi možnost Pred rezultati (Before Results). Spremenljivka na istem cilju ne more imeti dveh virov.

Urejanje formul v podatkovnem modelu, na strani in v splošnem urejevalniku ponuja razpoložljive vrste izračunov. Vrednotenje trga, začetna dotacija in začetno denarno stanje omejujejo nove spremenljivke na izračun ob začetku igre, tudi če so spremenljivke ustvarjene znotraj formul za njihov izračun.

V tabeli izhodnih spremenljivk gumb + v stolpcu »Spremenljivka« odpre poenostavljeno pogovorno okno za ustvarjanje spremenljivke v kontekstu tega izhoda, nato pa še njen urejevalnik formul. Izhodna tabela določa, kje se vrednost izračuna, zato izbirnik cilja ni prikazan. Ko uporabite formulo, se spremenljivka in njena dodelitev izhodu dodata skupaj. Če postopek pred zaključkom prekličete, tabela ostane nespremenjena.

Parametri funkcij

Parametri pripadajo definiciji funkcije. Deklarirani so kot vhodi te funkcije in so med urejanjem njenega Telesa funkcije (Function Body) prikazani v izbirniku definicij. Niso splošne spremenljivke ali globalni parametri: druge formule pokličejo funkcijo in podajo argument za vsak deklarirani vhod. Če funkcija na primer deklarira a in b, se lahko njeno telo sklicuje na parameter::a in parameter::b; klicatelji podajo ustrezne vrednosti v klicu funkcije.

Druga polja

• Ime (Name) je ime, ki ga vidi avtor, ter ne sme biti prazno in mora biti enolično med spremenljivkami.
• Vrsta vrednosti (Value type) je lahko število, celo število, logična vrednost ali besedilo. Določa preverjanje formul in združljive kontrolnike.
• Obseg (Scope) je Za vsakega igralca (Per player) ali Globalen (Global). Spremenljivka za posameznega igralca ima ločeno vrednost za vsakega udeleženca; globalna spremenljivka predstavlja skupno stanje igre.

Privzete nastavitve namena so izhodišče. Vrsto vrednosti in obseg lahko spremenite pred nadaljevanjem, vendar morata izbrana formula in cilj ostati združljiva z vrsto.

Nova izbira (New Choice)

Izbira je vrednost, ki jo udeleženec pošlje s strani.

• Uporabi kot (Use as) je Vrednost, ki jo vnese igralec (Value entered by a player).
• Ime (Name) ne sme biti prazno in mora biti enolično med izbirami.
• Vrsta vrednosti (Value type) je lahko število, celo število, logična vrednost ali besedilo.
• Najmanjša vrednost (Minimum) in Največja vrednost (Maximum) sta na voljo za številske izbire in izbire celih števil ter nista obvezni.

Stran vstavi sklic na novo izbiro. Preverjanje veljavnosti vnosa med izvajanjem uporablja njeno vrsto in nastavljene meje.

Obstoječi viri spremenljivk

Pregledovalnik spremenljivke prikaže vse shranjene vire in morebitne spremembe virov, ki čakajo na uveljavitev za stran:

• naslov pove, kdaj se vir izvede,
• podrobnosti določajo njegovo fazo, vrsto igralca, prehod ali modul,
• izraz prikazuje, kaj se dodeli,
• svinčnik odpre urejevalnik formul,
• možnost Premakni spremeni cilj izračuna,
• koš odstrani vir po potrditvi,
• gumb plus doda drug združljiv vir.

Spremembe med urejanjem strani ostanejo v čakanju do izbire Uveljavi stran (Apply Page). Z možnostjo Končano (Done) zaprete pregledovalnik spremenljivke, vendar ne uveljavite vsebujoče strani.

Izbira vira

Izberite najzgodnejšo točko življenjskega cikla, na kateri je vrednost na voljo in pomensko pravilna:

• stabilne začetne vrednosti inicializirajte ob začetku igre,
• za vrednosti ob prikazu uporabite izračun strani,
• za rezultate procesov uporabite izhode faz,
• za vrednosti, ki se spreminjajo ob vsaki transakciji, uporabite izhode transakcij,
• za stanje, ki ga sproži časovnik, uporabite periodične izhode,
• za končne posnetke in rezultate uporabite zaključevanje trga.

Sklic na strani sam po sebi ne izračuna spremenljivke, razen če je bil izrecno izbran izračun strani.