Skip to content

Matndagi O'zgaruvchilar


Ushbu yordam maqolasi hujjat shablonlariga taalluqli emas. Hujjat shablonlarida o‘zgaruvchilardan qanday foydalanish haqida bu yerda o‘qing.

O‘zgaruvchilar son, satr yoki boshqa ma’lumot turi kabi qiymatlarni saqlaydi. O‘zgaruvchilardan quyidagilarda foydalaniladi:

  • Vazifa nomi (vazifa shablonida yoki vazifa yaratilayotganda)
  • Vazifa tavsifi (vazifa shablonida yoki vazifa yaratilayotganda)
  • Elektron pochta shablonlari
  • Ssenariy amallari, tugmalar, kiruvchi veb-huklar va vazifalar uchun elektron pochta qoidalari:
    • HTTP so‘rovini yuborish
    • SMS yuborish
    • WhatsApp’ga yozish
    • Instagram’ga yozish
  • Ommaviy amallar, ssenariylar, tugmalar, kiruvchi veb-huklar va vazifalar uchun elektron pochta qoidalari:
    • Nomni o‘zgartirish
    • Tavsifni o‘zgartirish
    • Izoh qo‘shish
    • Maydon qiymatini belgilash («Matn» maydonlari uchun)


Matnga o‘zgaruvchi qo‘shish uchun, masalan, vazifa tavsifiga, «turli o‘zgaruvchilar» havolasini bosing (1), o‘zgaruvchini yarating va uni vazifa shablonidagi kerakli maydon matniga qo‘shing (2):

vBmUi1.jpg

O‘zgaruvchilar bilan hisob-kitoblar

Ba’zan matnga o‘zgaruvchi qiymatini kiritishning o‘zi yetarli bo‘lmaydi: o‘zgaruvchilardagi qiymatlar bilan hisob-kitob qilish yoki hosil bo‘lgan satrni qayta ishlash ham kerak bo‘ladi. Bunday amallar uchun quyidagi sintaksisdan foydalaning:

%%%FORMULA TEXT%%%

Misollar

Chegirmali narx: %%%{{Task.Price}}*0.8%%%
Ish %%%DATEDIF(NOW(); {{Task.Completion Date}}; "d")%%% %%%MULTIPLE(DATEDIF(NOW(); {{Task.Completion Date}}; "d");"kun"; "kun")%%% ichida yakunlanadi.

Muhim

  • Formula matni bir satrda yozilishi kerak va uni bo‘lib bo‘lmaydi. Boshqacha aytganda, Enter tugmasini bosib formulani keyingi satrga o‘tkazmang.
  • Formuladagi o‘zgaruvchilarni formatlab bo‘lmaydi, masalan, qalin yoki kursiv qilib bo‘lmaydi.
  • Formula natijasini qalin qilib ko‘rsatish kerak bo‘lsa, formatlashni natija bilan birga butun formulaga qo‘llang.

IF

O‘zgaruvchilar qiymatlariga (shartlarga) qarab matn kiritish uchun quyidagi sintaksisdan foydalaning:

%%$IF(Mantiqiy formula)$%%
MATN
%%$ENDBLOCK$%%

Misol

%%$IF({{Task.Order Amount}} > 100000)$%%
VIP MIJOZ
%%$ENDBLOCK$%%


Natija:

VIP MIJOZ

ELSE

ELSE faqat IF bilan birga ishlatiladi. IF sharti rost bo‘lmasa, blokning ELSE qismidagi matn ko‘rsatiladi.

%%$IF(Mantiqiy formula)$%%
MATN
%%$ELSE$%%
MATN
%%$ENDBLOCK$%%

Misol

%%$IF({{Task. Invoice №}}="")$%%
[Invoice №] maydoni to‘ldirilmagan
%%$ELSE$%%
Vazifaning kerakli maydoni to‘ldirilgan! :)
%%$ENDBLOCK$%%


Natija:

  • Maydon to‘ldirilmagan bo‘lsa, «[Invoice №] maydoni to‘ldirilmagan» xabari ko‘rsatiladi.
  • Maydon to‘ldirilgan bo‘lsa, «Vazifaning kerakli maydoni to‘ldirilgan! :)» xabari ko‘rsatiladi.

ELSEIF

Shartlari bo‘lgan murakkabroq ifoda yaratishga yordam beradi:

%%$IF(Mantiqiy formula)$%%
MATN
%%$ELSEIF(Mantiqiy formula)$%%
MATN
%%$ELSEIF(Mantiqiy formula)$%%
MATN
%%$ELSE$%%
MATN
%%$ENDBLOCK$%%


Eslatma

  • Blokning oxiridagi ELSE ixtiyoriy qism hisoblanadi.

Misol

%%$IF({{Task.Invoice Number}}="")$%%
[Invoice Number] maydoni to‘ldirilmagan
%%$ELSEIF({{Task.UPD Number}}="")$%%
[UPD Number] maydoni to‘ldirilmagan
%%$ELSEIF({{Task.Contract Number}}="")$%%
[Contract Number] maydoni to‘ldirilmagan
%%$ELSE$%%
Vazifaning barcha maydonlari to‘ldirilgan, qoyil! :)
%%$ENDBLOCK$%%


Natija:

  • Uchala maydon ham to‘ldirilmagan bo‘lsa, faqat birinchi xabar — «[Invoice Number] maydoni to‘ldirilmagan» — ko‘rsatiladi, qolganlari o‘tkazib yuboriladi.
  • «Invoice Number» va «UPD Number» maydonlari to‘ldirilgan, lekin «Contract Number» maydoni to‘ldirilmagan bo‘lsa, «[Contract Number] maydoni to‘ldirilmagan» degan tegishli xabar ko‘rsatiladi.

FOREACH

O‘zgaruvchi qiymatlar ro‘yxatini bildirsa, masalan, {{Task.Subtasks}} yoki {{Task.Assignee}}, va har bir qiymat uchun ma’lumotni ko‘rsatish kerak bo‘lsa, quyidagi sintaksisdan foydalaning:

%%$FOREACH(O‘zgaruvchi;Ajratgich)$%%
MATN
%%$ENDBLOCK$%%


Muhim: ifodaning ushbu qismida — %%$FOREACH(O‘zgaruvchi;Ajratgich)$%% — birinchi darajali o‘zgaruvchini, ya’ni {{Task.Subtasks}} yoki {{Task.Assignee}} ni ko‘rsating va boshqa hech narsa yozmang.

Misol

%%$FOREACH({{Task.Assignee}};"<br>")$%%{{Task.Assignee}} - {{Task.Assignee.Position}}%%$ENDBLOCK$%%


Natija:

linda Martinez - Dizayner
Jamse Davis - Dasturchi
Mary Brown - Bosh direktor
%%$FOREACH({{Task.Subtasks}};"<br>")$%%{{Task.Subtasks.Number}} - {{Task.Subtasks.Name}}%%$ENDBLOCK$%%


Natija:

2119 - Dag‘al pardozlash
2120 - Oraliq pardozlash
2121 - Yakuniy ishlov

Shartli misol

Sintaksis:

%%$FOREACH(O‘zgaruvchi;Ajratgich;IFsiz_SHART)$%%
MATN
%%$ENDBLOCK$%%

%%$FOREACH({{Task.Subtasks}};"";{{Task.Subtasks."Contract Amount ($)"}}>1000))$%%
{{Task.Subtasks.Counterparty}}, shartnoma summasi {{Task.Subtasks."Contract Amount ($)"}}
%%$ENDBLOCK$%%


Natija

Hamkor tomonlarning butun ro‘yxatidan faqat shartnoma summasi 1000 dan ortiq bo‘lganlari ko‘rsatiladi:

LLC Sunrise, 1500

LLC Sunset, 1700

LLC Dawn, 2500

FOREACH bloki ichidagi ELSE bloki

Sintaksis:

%%$FOREACH(O‘zgaruvchi;Ajratgich)$%%
MATN
 %%$IF(Mantiqiy formula)$%%
MATN
 %%$ENDBLOCK$%%
MATN
%%$ENDBLOCK$%%

%%$FOREACH({{Task.Subtasks}})$%%%%$IF({{Task.Subtasks.Status}}="Hisob-kitobga TKP qo‘shildi")$%%
{{Task.Subtasks.Counterparty}}, {{Task.Subtasks.Counterparty.TIN}}, shartnoma summasi {{Task.Subtasks."Contract Amount"}} {{Task.Subtasks.Currency.Symbol}}
%%$ENDBLOCK$%%%%$ENDBLOCK$%%


Natija:

LLC Sunrise, 5689845987654, 1500 $
LLC Sunset, 5689845125699, 1700 $
LLC Dawn, 5689845589674, 2500 $
LLC Light, 5689845235689, 500 $

TABLE

O‘zgaruvchi qiymatlar ro‘yxatini bildirsa va har bir qiymat haqidagi ma’lumotni jadval shaklida ko‘rsatish kerak bo‘lsa, quyidagi sintaksisdan foydalaning:

%%$TABLE(O‘zgaruvchi)$%%
MATN
%%$ENDBLOCK$%%

Misol

Misolda vazifaga qo‘shilgan ma’lumot yorlig‘idan faqat kerakli bloklarni ajratib olish va bu ma’lumotni mijozga jadval shaklida yuborish ko‘rsatilgan. Jadval Planfix muharriri yordamida qo‘shiladi:

Buyurtma №{{Task.Number}}

%%$TABLE({{Data tag.Service}})$%%

{{Data tag.Service.Service Name}} {{Data tag.Service.Amount}}

%%$ENDBLOCK$%%

Buyurtmaning umumiy summasi: %%%TEXT(SUM({{Data tag.Service.Amount}});",.2f")+MULTIPLE(SUM({{Data tag.Service.Amount}}); " rubl"; " rubl")%%%


Natija:

Buyurtma №2118

Grafik dizayn 1 600.00
Dasturlash 3 000.00
Texnik topshiriqni ishlab chiqish 300.00

Buyurtmaning umumiy summasi: 4 900.00 dollar

Sarlavha va jami ko‘rsatilgan misol

Jadvalga sarlavha qatori yoki jami qatorini qo‘shish uchun sintaksisda quyidagi parametrlarni ishlating:

%%$TABLE(O‘zgaruvchi;0;0)$%%
Planfix muharriri yordamida chizilgan jadval
%%$ENDBLOCK$%%

Misol: %%$TABLE({{Data Tag.Service}};1;1)$%%

№ Nomi Narxi
{{Data tag.Service.Record Number}} {{Data tag.Service.Service Name}} {{Data tag.Service.Amount}}
Jami %%%SUM({{Data tag.Service.Amount}})%%%

%%$ENDBLOCK$%%


Natija:

№ Nomi Narxi
1 Texnik topshiriqni ishlab chiqish 1 000.00
2 Dasturlash 3 705.00
3 Grafik dizayn 1 035.00
4 Sinovdan o‘tkazish 690.00
Jami 6430

Qizil rang bilan ajratilgan raqamlar sarlavha va jami qatorlarida ishlatiladigan qatorlar sonini bildiradi.

Masalan, yuqoridagi misoldagi (1;1) raqamlari jadval boshida sarlavha uchun bir qator, oxirida esa jami uchun bir qator ishlatilishini anglatadi.

Jadval sarlavhasida ikki qator ishlatish uchun quyidagicha ko‘rsating — (2;1).

Misol: %%$TABLE({{Data tag .Service}};2;1)$%%

Xizmatlar to‘plami
№ Nomi Narxi
{{Data tag.Service.Record Number}} {{Data tag.Service.Service Name}} {{Data tag.Service.Amount}}
Jami %%%SUM({{Data tag.Service.Amount}})%%%

%%$ENDBLOCK$%%


Natija:

Xizmatlar to‘plami
№ Nomi Narxi
1 Texnik topshiriqni ishlab chiqish 1 000.00
2 Dasturlash 3 705.00
3 Grafik dizayn 1 035.00
4 Sinovdan o‘tkazish 690.00
Jami 6430

Shartli misol

%%$TABLE(O‘zgaruvchi;0;0;IFsiz_SHART)$%%
Planfix muharriri yordamida chizilgan jadval
%%$ENDBLOCK$%%


%%$TABLE({{Task.Subtasks}};1;0;{{Task.Subtasks.Status}}="Hisob-kitobga TKP qo‘shildi")$%%

Hamkor tomon STIR Shartnoma summasi
{{Task.Subtasks.Counterparty}} {{Task.Subtasks.Counterparty.TIN}} {{Task.Subtasks."Contract Amount"}}{{Task.Subtasks.Currency.Symbol}}

%%$ENDBLOCK$%%


Natija:

Hamkor tomon STIR Shartnoma summasi
LLC Sunrise 5689845987654 1500$
LLC Sunset 5689845125699 1700$
LLC Dawn 5689845589674 2500$
LLC Light 5689845235689 500$


Jadvalga sarlavha qo‘shish uchun uning ustida sichqonchaning o‘ng tugmasini bosing va Qator - Yuqoriga qator qo‘shish bandini tanlang:

Pvy4PR.jpg

FOREACH va TABLE: axborot bloklari bilan ishlash

Elektron pochta tahlil qilinayotganda yoki HTTP so‘roviga javob qaytarilayotganda bir nechta ma’lumot qatorini olsangiz va ularni tuzilgan matn yoki jadval shaklida qo‘shmoqchi bo‘lsangiz:

%%$FOREACH({{Infoblock.!row}};Ajratgich)$%%
{{Infoblock.!row.Infoblock name}}
%%$ENDBLOCK$%%

%%$TABLE({{Infoblock.!row}})$%%
{{Infoblock.!row.Infoblock name}}
%%$ENDBLOCK$%%


Misol

Ma’lumotlarni «Mahsulot» va «Narx» axborot bloklariga ajratib, jadvalga qo‘shamiz:

%%$TABLE({{Infoblock.!row}})$%%

{{Infoblock.!string.Product}} {{Infoblock.!string.Price}}

%%$ENDBLOCK$%%


Natija:

Qalam 1,00
Ruchka 2,00
Daftar 10,00


O‘tish