Kas yra kintamieji?

Kintamieji – tai vietos žymekliai .docx šablone, kurie generuojant dokumentą automatiškai pakeičiami tikrais duomenimis. Pavyzdžiui, ##{{employeeName}} tampa Jonas Petraitis, o ##{{hireDate}} – 2024-03-15.

Kintamieji šablone žymimi dvigubais riestiniais skliaustais: ##{{kintamojoRaktas}}.

Automatinis kintamųjų aptikimas

Kai įkeliate .docx failą, sistema automatiškai nuskaito visus ##{{...}} formato kintamuosius ir sukuria jų sąrašą. Kiekvienas rastas kintamasis rodomas konfigūracijos skiltyje, kur galite nurodyti jo tipą, etiketę ir kitus parametrus.

Pakartotinis nuskaitymas

Jei atnaujinote šabloną (įkėlėte naują versiją arba redagavote integruotame redaktoriuje), sistema automatiškai perskanuoja kintamuosius. Nauji kintamieji pridedami, o pašalinti – pažymimi kaip nebenaudojami.

Kintamųjų tipai

Tipas	Pavadinimas	Aprašymas
TEXT	Tekstas	Laisvo formato teksto laukas.
DATE	Data	Datos pasirinkiklis (kalendorius).
EMAIL	El. paštas	El. pašto adresas su formato tikrinimu.
NUMBER	Skaičius	Skaitinė reikšmė.
SELECT	Pasirinkimas	Išskleidžiamasis sąrašas su iš anksto nurodytomis reikšmėmis.
BOOLEAN	Taip/Ne	Taip arba Ne jungiklis.

Kintamųjų konfigūravimas

Kiekvienam kintamajam galite nustatyti šiuos parametrus:

Parametras	Aprašymas
Rodomas pavadinimas	Etiketė, kurią mato naudotojas pildydamas formą (pvz., "Darbuotojo vardas").
Privalomas	Ar laukas turi būti užpildytas prieš generuojant dokumentą.
Numatytoji reikšmė	Reikšmė, kuri bus įrašyta automatiškai, jei naudotojas jos nepakeis.
Aprašymas	Pagalbinis tekstas, paaiškinantis, ką įrašyti į lauką.
Rikiavimo tvarka	Skaičius, nurodantis lauko poziciją formoje (mažesnis skaičius – aukščiau).

SELECT tipo pasirinkimų nustatymas

Jei kintamojo tipas yra SELECT (Pasirinkimas), turite nurodyti galimas reikšmes:

Pasirinkite kintamąjį konfigūracijos sąraše.
Skiltyje Pasirinkimai pridėkite reikšmes po vieną.
Galite keisti tvarką vilkdami elementus.
Nereikalingas reikšmes pašalinkite spausdami šalinimo piktogramą.

Pastaba: Maksimalus pasirinkimų skaičius – 50.

Automatinio užpildymo šaltiniai

Kintamuosius galima susieti su automatinio užpildymo šaltiniais – tada generuojant dokumentą sistema automatiškai įrašo reikšmę iš darbuotojo, organizacijos arba dokumento duomenų.

Darbuotojo laukai

Šaltinio raktas	Aprašymas
`employee.firstName`	Darbuotojo vardas
`employee.lastName`	Darbuotojo pavardė
`employee.fullName`	Pilnas vardas ir pavardė
`employee.email`	El. pašto adresas
`employee.phone`	Telefono numeris
`employee.jobTitle`	Pareigų pavadinimas
`employee.department`	Skyrius
`employee.employeeNumber`	Darbuotojo numeris
`employee.hireDate`	Įdarbinimo data
`employee.dateOfBirth`	Gimimo data
`employee.address`	Gyvenamosios vietos adresas
`employee.personalCode`	Asmens kodas

Organizacijos laukai

Šaltinio raktas	Aprašymas
`organization.name`	Organizacijos pavadinimas
`organization.registrationCode`	Įmonės kodas
`organization.address`	Organizacijos adresas
`organization.phone`	Organizacijos telefonas
`organization.email`	Organizacijos el. paštas

Dokumento laukai

Šaltinio raktas	Aprašymas
`document.generatedDate`	Dokumento sugeneravimo data
`document.templateName`	Šablono pavadinimas
`document.documentNumber`	Dokumento numeris (jei įjungta numeracija)

Geriausia praktika kintamųjų pavadinimams

Naudokite camelCase formatą – pvz., employeeName, ne employee_name ar Employee Name.
Būkite konkretūs – contractStartDate geriau nei date1.
Grupuokite su priešdėliais – employeeFirstName, employeeLastName, companyName, companyAddress.
Venkite tarpų ir specialiųjų simbolių – naudokite tik raides, skaičius ir camelCase.
Naudokite anglų kalbą raktams – tai palengvina automatinio užpildymo susiejimą.