Tappion tiedostoformaatti

Tappion tilikausitiedostot (*.tlk) ovat tekstitiedostoja, jotka sisältävät täsmälleen yhden S-lauseen (S-expression, sexp). Tappion tiedostoformaatissa S-lauseita on neljää eri tyyppiä:

• Kokonaisluku on merkkijono, joka sisältää yhden tai useampia numeromerkkejä '0' – '9' sekä mahdollisesti ensimmäisenä merkkinä miinuksen ('-'). Kokonaisluvut ovat kymmenkantaisia.
• Symboli on merkkijono, joka sisältää yhden tai useampia kirjaimia 'a' – 'z', 'A' – 'Z', numeromerkkejä '0' – '9' ja erikoismerkkejä '!', '$', '%', '&', '/', '+', '?', '-', '_' ja '*'. Symboliksi tulkittava merkkijono ei myöskään saa olla tulkittavissa kokonaisluvuksi.
• Merkkijono suljetaan lainausmerkkien ('"') sisään. Sisällä kenoviiva ('\') toimii pakomerkkinä, jonka avulla saadaan ilmaistua lainausmerkki ('\"'), kenoviiva ('\\') ja rivinvaihto ('\n').
• Lista suljetaan sulkeisiin ('(' ... ')'), joiden välissä on nolla tai useampia S-lauseita. Lauseet erotetaan toisistaan välimerkeillä (välilyönti, sarkain, rivinvaihto).

Määritellään myös tyyppi Päivämäärä, joka on neljän lauseen mittainen lista. Ensimmäinen lause on symboli date, jonka jälkeen seuraavat kokonaislukuina ilmaistut vuosi, kuukausi ja päivä. Edelleen tyyppi Rahasumma on kahden alkion lista. Ensimmäinen alkio on symboli money ja toinen on kokonaisluku, joka kertoo rahasumman suuruuden sentteinä. Positiivinen summa on debetiä, negatiivinen kreditiä.

Tappion tilikauden muodostava S-lause on lista, joka koostuu kuudesta lauseesta:

• Symboli identity
• Merkkijono "Tappio"
• Symboli version
• Merkkijono "versio 0.10" (tämä luonnollisesti päivittyy version mukaisesti)
• Symboli finances
• Lista, joka sisältää fiscal-year-määrittelyn.

Viimeisenä oleva fiscal-year-lista koostuu myös kuudesta lauseesta:

• Symboli fiscal-year
• Merkkijono, joka sisältää tilikauden otsakkeen
• Päivämäärä tilikauden aloitukselle
• Päivämäärä tilikauden lopetukselle
• Tilikartta
• Päiväkirja.

Tilikarttamäärittely on jälleen lista. Sen ensimmäinen lause on symboli account-map, jonka jälkeen seuraa kolme tilimääritystä. Näistä ensimmäinen on taseen Vastaavaa-tili, toinen taseen Vasttavaa-tili ja kolmas Tulos-tili. Kukin tilimääritys on neljän alkion mittainen lista:

• Symboli account
• Kokonaisluku, joka ilmoittaa tilin numeron (-1 tiliryhmille)
• Merkkijono, joka kertoo tilin nimen
• Lista, joka sisältää nolla tai useampia tilimäärittelyitä.

Tilimäärittely sisältää siis rekursiivisesti muita tilimäärittelyitä. Nämä määrittelyt näkyvät tilikartassa alitileinä. Ylimmällä tasolla

Päiväkirja on lista, joka sisältää nolla tai useampia tapahtumamäärittelyjä. Kukin tapahtumamäärittely on viisialkioinen lista:

• Symboli event
• Kokonaisluku, joka kertoo tapahtuman järjestysnumeron
• Päivämäärä tapahtumalle
• Merkkijono, joka on tapahtuman kuvaus
• Lista, joka sisältää tiliöinnit.

Kukin tiliöinti on kahden alkion lista. Ensimmäinen alkio on kokonaisluku ja kertoo sen tilin numeron, jolle tiliöinti kohdistuu. Toinen alkio on rahasumma.

Kannattanee katsella tallennettuja tlk-tiedostoja, sieltä rakenne käy helposti ilmi. Tappio ei tosin tallentaessaan käytä rivinvaihtoja, joten koko tilikausimäärittely on yksi pitkä rivi, mikä tekee lukemisen hieman ikävämmäksi. Kannattanee pilkkoa sopivista kohdista.

Lopuksi vielä esimerkkitilikausi:

(identity "Tappio"
 version "versio 0.10"
 finances (fiscal-year "Esimerkkiyhdistys ery"
                       (date 2003 1 1)
		       (date 2003 12 31)
		       (account-map (account -1 "Vastaavaa" ((account 101 "Pankkitili")))
		                    (account -1 "Vastattavaa" ((account 201 "Oma pääoma"))
				    (account -1 "Tulos" ((account 300 "Tulot") (account 400 "Menot")))))
		       ((event 1 (date 2003 1 1) "Tilinavaus" ((101 (money 123456)) (201 (money -123456)))))))