Skip to content

Hujjat shablonlaridagi funksiyalar

Shablonlardan foydalangan holda hujjatlarni avtomatik formatlashda funksiyalardan foydalanish mumkin. Funksiyalar hujjatlaringizda ma'lumotlarni qanday ko‘rsatilishini soddalashtiradi. Masalan, formulalardan foydalanib sonlarni so‘zlarda avtomatik ko‘rsatish yoki buyurtma qiymatlarini hisoblash mumkin.

Formulalar

Hujjatga formula qo‘shish uchun quyidagi sintaksisdan foydalaning: %%%FORMULA%%%.

A FORMULA maydonning qiymatini hisoblash uchun ifoda bo‘lib, u hisoblanadigan maydondagidek ishlaydi.

Misol:

%%%TEXT({{DataTag.Service.Quantity}}*{{DataTag.Service.Cost}};".2f")%%%

Yuqoridagi misolda formula ichiga "Service" ma'lumot yorlig‘idan tegishli o‘zgaruvchilar yordamida ma'lumot qo‘shilgan. Ikkita qiymat ko‘paytirilib, natija muayyan xizmat yoki mahsulotning umumiy qiymatini beradi. TEXT() funksiyasi qiymatni inson uchun o‘qilishi qulay matn qatoriga formatlaydi.

Muhim

Masalan:

  • Formulalar bitta satrda yozilishi kerak va Enter bosish orqali bo‘linishi mumkin emas. Agar yangi qatordan boshlash kerak bo‘lsa, "\n" ketma-ketligidan foydalaning.
  • Qator bo‘linmasdan
%%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{Datatag.Service calculation.Quantity}} + " " + {{Datatag.Service calculation."Unit"}} + " (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
  • Qator bo‘lishi bilan
%%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{atatag.Service calculation.Quantity}} + " " + {{{Datatag.Service calculation."Unit"}} + "\n (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
  • Formuladagi o‘zgaruvchilarni masalan, qalin yoki kursiv qilib formatlash mumkin emas.
  • Agar formuladan olingan natija qalin qilib ko‘rinishini xohlasangiz, formatlashni foiz belgilarini ham o‘z ichiga olgan butun formulaga qo‘llang.

Funksiyalar

Hujjat shabloni formulalarida mavjud bo‘lgan barcha funksiyalar:

SUM funksiyasi

SUM() — formula hisoblanganda olinadigan barcha qiymatlarni qo‘shuvchi funksiya. U ko‘paytiriladigan o‘zgaruvchining har bir elementi uchun qo‘llanadi.

Masalan, sizda "Service" ma'lumot yorlig‘i bor va hujjatdagi barcha xizmatlar uchun umumiy qiymatni hisoblamoqchisiz. Buning uchun quyidagi funksiyani ishlatasiz:

SUM({{DataTag.Service.Cost}})

Xizmatlar uchun umumiy qiymatni olish uchun xizmat narxini buyurtma qilingan miqdorga ko‘paytirishingiz kerak. Hujjatda foydalaniladigan formula quyidagicha bo‘ladi:

SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}))

E'tibor bering, SUM() funksiyasi ichida har qanday funksiyalardan tashkil topgan formula bo‘lishi mumkin.

PLURALFORM funksiyasi

Berilgan sondan kelib chiqqan holda so‘z oxirini qo‘shish yoki nom oddiy bo‘lmagan holda so‘zning o‘zini o‘zgartirish uchun ishlatiladi.

Format:

PLURALFORM (number; "text1"; "text2";)

Hisoblangan sondan kelib chiqqan qiymatga qarab funksiya ikkita parametrdan birini tanlaydi. Parametrlar algoritmga muvofiq qat'iy tartibda ko‘rsatilishi kerak.

Masalan, "dollar" so‘zini shakllantirish kerak bo‘lsin. Algoritmga amal qiling:

Avvalo, kerakli so‘zni 1 bilan yozing:

  • 1 dollar

Bu shuni anglatadiki, funksiyaning birinchi parametri "text1" o‘rniga "dollar" bo‘lishi kerak.

Keyin 2 bilan so‘zni yozing:

  • 2 dollars

Bu esa funksiyaning ikkinchi parametri "text2" o‘rniga "dollars" bo‘lishi kerakligini anglatadi.

Natijada hujjatda quyidagi PLURALFORM() funksiyasini ko‘rsatishingiz mumkin:

PLURALFORM(SUM({{Datatag.Service.Cost}}*{{Datatag.Service.Quantity}}); "dollar"; "dollars")

NUMBERASWORDS funksiyasi

Bu funksiya sonni so‘zlarda qaytaradi. Faqat butun qismi so‘zlarda yoziladi.

Format:

NUMBERASWORDS(number; Output; "language")

Qayerda:

  • number — son yoki formula
  • Output — raqam qanday ko‘rsatilishini belgilaydi (0 dan 6 gacha)
  • language — chiqish tilini belgilovchi qator. Agar bo‘sh qoldirilsa (""), hujjatni yaratayotgan foydalanuvchining tili ishlatiladi.

Tillar va ularning Output usullari:

  • Inglizcha ("en")
    • 0-3 — standart (kardinal son)
    • 4-6 — bosh harf bilan boshlanadigan standart
  • Nemischa ("de")
    • 0 — standart (jinsdan mustaqil)
    • 1 — ayol shaklida yoziladi
    • 2 — erkak shaklida yoziladi
    • 3 — neytral shaklda yoziladi
    • 4 — bosh harf bilan ayol shaklida
    • 5 — bosh harf bilan erkak shaklida
    • 6 — bosh harf bilan neytral shaklda
  • Fransuzcha ("fr")
    • 0 — standart (kardinal son)
    • 1 — ayol shaklida yoziladi
    • 2 — erkak shaklida yoziladi
    • 4 — bosh harf bilan ayol shaklida
    • 5 — bosh harf bilan erkak shaklida

Masalan, hujjatda sonni so‘zlarda ko‘rsatish uchun quyidagi funksiyadan foydalaning:

NUMBERASWORDS(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2; "en")

FRACTIONALPART funksiyasi

Bu funksiya sonning kasr qismini ko‘rsatadi. O‘nlik nuqtadan keyin nechta raqam ko‘rsatilishini belgilashingiz mumkin.

Format:

FRACTIONALPART(number; NumberOfDigitsAfterDecimal)

Masalan, xizmat narxining sentlarini hujjatda chiqarish uchun quyidagi funksiyadan foydalaning:

FRACTIONALPART(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2)

Ushbu funksiya o‘nlikdan keyingi ikki raqamni ko‘rsatadi:

  • 176.03 — funksiya 3 qaytaradi.
  • 15.15 — funksiya 15 qaytaradi.
  • 16.156 — funksiya birinchi ikkita o‘nlikni 16 ga yaxlitlaydi.

O‘tish