Құжат үлгілеріндегі функциялар
Формулаларды үлгілер арқылы құжаттарды автоматты түрде форматтағанда қолдануға болады. Функциялар құжаттағы деректердің көрсетілуін жеңілдетеді. Мысалы, сандарды сөзбен автоматты түрде көрсету немесе тапсырыс құнын есептеу үшін формулаларды пайдалануға болады.
Формулалар
Құжатқа формула қосу үшін келесі синтаксисті қолданыңыз: %%%FORMULA%%%.
FORMULA — өрістің мәнін есептеу өрнегі, дәл есептелетін өрістердегі сияқты.
Мысал:
Жоғарыдағы мысалда формулаға "Service" деректер тегі арқылы алынған деректер тиісті айнымалылармен қосылады. Екі мән көбейтіледі, және нәтиже белгілі бір қызметтің немесе өнімнің жалпы құны болады. TEXT() функциясы мәнді адамға оқуға ыңғайлы мәтіндік жолға форматтайды.
Маңызды
Мысалы:
- Формулалар бір жолда жазылуы тиіс және Enter пернесін басып бөлуге болмайды. Егер жол үзілімін енгізу қажет болса, "\n" реттік таңбасын пайдаланыңыз.
- Жол үзілімсіз
- %%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{Datatag.Service calculation.Quantity}} + " " + {{Datatag.Service calculation."Unit"}} + " (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
- Жол үзіліммен
- %%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{atatag.Service calculation.Quantity}} + " " + {{{Datatag.Service calculation."Unit"}} + "\n (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
- Формуладағы айнымалыларды мысалы, қою немесе курсив сияқты пішімдермен құруға болмайды.
- Егер формула нәтижесін қою әріппен көрсету қажет болса, пішімді формуланың бүкіл бөлігіне, соның ішінде пайыз таңбаларына қолдану керек.
Функциялар
Құжат үлгісінің формулаларында қолжетімді барлық функциялар:
- SUM()
- PLURALFORM()
- NUMBERASWORDS()
- FRACTIONALPART()
SUM функциясы
SUM() — формула есептеу кезінде алынған барлық мәндерді қосатын функция. Ол көбейтетін айнымалының әрбір элементіне қолданылады.
Мысалы, егер сізде "Service" деректер тегі болса және құжаттағы барлық қызметтердің жалпы құнын есептегіңіз келсе, келесі функцияны қолданасыз:
SUM({{DataTag.Service.Cost}})
Қызмет көрсетілген жалпы құнын алу үшін қызмет құнын тапсырыс беру санына көбейту қажет. Құжатта қолдануға арналған формула:
SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}))
SUM() функциясы функциялардан құралған кез келген формуланы қамти алатынын ескеріңіз.
PLURALFORM функциясы
Бұл функция құжат үлгісіндегі берілген санға байланысты сөзге қосымша жалғауын қоюға немесе сөзді өзгертуді (ерекше септелетін зат есімдер үшін) қолдануға пайдаланылады.
Пішімі:
PLURALFORM (number; "text1"; "text2";)
Есептелген number мәніне қарай функция екі параметрдің бірін таңдайды. Параметрлер алгоритмге сәйкес қатаң тәртіпте көрсетілуі тиіс.
Мысалы, "dollar" сөзін септеу қажет болса, алгоритмді орындаңыз:
Бірлік санымен қажетті сөзді жазыңыз:
- 1 dollar
Бұл бірінші параметр функцияда "text1" орнына "dollar" болуы керек екенін білдіреді.
Содан кейін екілік санымен сөзді жазыңыз:
- 2 dollars
Бұл екінші параметр функцияда "text2" орнына "dollars" болуы керек екенін білдіреді.
Соңында құжатта келесі PLURALFORM() функциясын көрсетуге болады:
NUMBERASWORDS функциясы
Бұл функция санды сөзбен қайтарады. Тек бүтін бөлік ғана жазылады.
Пішімі:
NUMBERASWORDS(number; Output; "language")
Мұндағы:
- number — сан немесе формула
- Output — санның қалай көрсетілетінін анықтайды (0-ден 6-ға дейін)
- language — шығу тілін көрсететін жол. Егер бос қалдырылса (""), құжатты жасайтын қолданушының тілі пайдаланылады.
Тілдер және олардың Output әдістері:
- English ("en")
- 0-3 — әдепкі (бастапқы сан)
- 4-6 — басталады үлкен әріппен
- German ("de")
- 0 — әдепкі (гендерсіз)
- 1 — әйелдік форма
- 2 — еркектік форма
- 3 — орталық (neuter) форма
- 4 — әйелдік формада үлкен әріппен
- 5 — еркектік формада үлкен әріппен
- 6 — орталық формада үлкен әріппен
- French ("fr")
- 0 — әдепкі (бастапқы сан)
- 1 — әйелдік форма
- 2 — еркектік форма
- 4 — әйелдік формада үлкен әріппен
- 5 — еркектік формада үлкен әріппен
Мысалы, құжатта санды сөзбен көрсету үшін келесі функцияны пайдаланыңыз:
NUMBERASWORDS(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2; "en")
FRACTIONALPART функциясы
Бұл функция санның ондық бөлшегін көрсетеді. Ондық үтірден кейін көрсетуге қажетті таңба санын белгілеуге болады.
Пішімі:
FRACTIONALPART(number; NumberOfDigitsAfterDecimal)
Мысалы, қызмет құнының центтерін құжатта шығару үшін келесі функцияны қолданыңыз:
FRACTIONALPART(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2)
Бұл функция ондық үтірден кейінгі екі таңбаны көрсетеді:
- 176.03 — функция 03 қайтармай, 3 қайтарады.
- 15.15 — функция 15 қайтарады.
- 16.156 — функция бірінші екі ондық сызықты дөңгелектеп 16 қайтарады.