Skip to content

Матндаги О'згарувчилар

Ушбу ёрдам мақоласи ҳужжат шаблонларига тааллуқли эмас. Ҳужжат шаблонларида о'згарувчилардан қандай фойдаланишни бу ерда о'қинг.

Навигация

О'згарувчилар рақам, матн ёки бошқа ма'лумот турини сақлайди. О'згарувчилар қуйида ишлатилади:

  • Вазифа номи (вазифа шаблонида ёки вазифа яратишда)
  • Вазифа тавсифи (вазифа шаблонида ёки вазифа яратишда)
  • Эмаил шаблонлари
  • Ссенарий ҳаракатлари, тугмалар, кирувчи wебҳооклар, эмаил қоидалари вазифалар учун:
    • ҲТТП со'ров юбориш
    • СМС юбориш
    • WҳацАппга ёзиш
    • Инстаграмга ёзиш
  • Ко'пдан-бир амаллар, ссенарийлар, тугмалар, кирувчи wебҳооклар, эмаил қоидалари вазифалар учун:
    • Номи о'згартириш
    • Тавсифни о'згартириш
    • Изоҳ қо'шиш
    • Майдон қийматини о'рнатиш (""Матн"" майдонлари учун)


Матнга, масалан вазифа тавсифига, о'згарувчи қо'шиш учун "турли о'згарувчилар" ҳаволасини (1) босинг, о'згарувчини яратинг ва исталган майдон матнига вазифа шаблонида қо'шинг (2):

вБмУи1.жпг

Ҳисобланадиган майдонлар билан ҳисоблашлар

Ба'зан матнга о'згарувчи қийматини қо'йиш етарли бо'лмайди — о'згарувчилардаги қийматлар билан ҳисоблашлар ёки олинган сатрни қайта ишлаш керак бо'лади. Бундай амаллар учун қуйидаги синтаксисдан фойдаланилади:

%%%FORMULA TEXT%%%

Мисоллар

Discounted price: %%%{{Task.Price}}*0.8%%%
Work will be completed in %%%DATEDIF(NOW(); {{Task.Completion Date}}; "d")%%% %%%MULTIPLE(DATEDIF(NOW(); {{Task.Completion Date}}; "d");"day"; "days")%%%

Муҳим

  • Формуланинг матни битта сатрда ёзилиши керак ва сатр бо'либ узилиши мумкин эмас. Я'ни формула Энтер билан кейинги қаторда бо'ла олмайди.
  • Формуладаги о'згарувчиларни форматлаш мумкин эмас, масалан, уларни қалин ёки курсив қилиш мумкин эмас.
  • Агар формуладан чиққан натижани қалин қилиш керак бо'лса, бутун формулани натижа билан бирга форматланг.

ИФ

О'згарувчи қийматларига (шартларга) қараб матн қо'йиш учун қуйидаги синтаксисдан фойдаланинг:

%%$ИФ(Логиcал формула)$%%
ТЕХТ
%%$ЭНДБЛОCК$%%

Мисол

%%$ИФ({{Task.Order Amount}} > 100000)$%%
ВИП CУСТОМЕР
%%$ЭНДБЛОCК$%%


Натижа:

ВИП CУСТОМЕР

ЭЛСЕ

ЭЛСЕ фақат ИФ билан бирга ишлатилади. ИФ даги шарт рост бо'лмаганда, блокнинг ЭЛСЕ қисмидаги матн ко'рсатилади.

%%$ИФ(Логиcал формула)$%%
ТЕХТ
%%$ЭЛСЕ$%%
ТЕХТ
%%$ЭНДБЛОCК$%%

Мисол

%%$ИФ({{Task. Invoice №}}="")$%%
Тҳе фиэлд [Инвоиcе №] ис нот филлед ин
%%$ЭЛСЕ$%%
Тҳе реқуиред таск фиэлд ис филлед ин! :)
%%$ЭНДБЛОCК$%%


Натижа:

  • Агар майдон то'лдирилмаган бо'лса, "Тҳе фиэлд [Инвоиcе №] ис нот филлед ин" хабари ко'рсатилади.
  • Агар майдон то'лдирилган бо'лса, "Тҳе реқуиред таск фиэлд ис филлед ин! :)" хабари ко'рсатилади.

ЭЛСЕИФ

Мураккаброқ шартли ифодалар яратишда ёрдам беради:

%%$ИФ(Логиcал формула)$%%
ТЕХТ
%%$ЭЛСЕИФ(Логиcал формула)$%%
ТЕХТ
%%$ЭЛСЕИФ(Логиcал формула)$%%
ТЕХТ
%%$ЭЛСЕ$%%
ТЕХТ
%%$ЭНДБЛОCК$%%


Эслатма

  • Охирги ЭЛСЕ блокнинг ихтиёрий қисмидир.

Мисол

%%$ИФ({{Task.Invoice Number}}="")$%%
Тҳе фиэлд [Инвоиcе Нумбер] ис нот филлед ин
%%$ЭЛСЕИФ({{Task.UPD Number}}="")$%%
Тҳе фиэлд [УПД Нумбер] ис нот филлед ин
%%$ЭЛСЕИФ({{Task.Contract Number}}="")$%%
Тҳе фиэлд [Cонтраcт Нумбер] ис нот филлед ин
%%$ЭЛСЕ$%%
Алл таск фиэлдс аре филлед ин, ёу'ре аwесоме! :)
%%$ЭНДБЛОCК$%%


Натижа:

  • Агар учала майдон ҳам то'лдирилмаган бо'лса, фақат биринчи хабар "Тҳе фиэлд [Инвоиcе Нумбер] ис нот филлед ин" ко'рсатилади, қолганлари о'тказиб юборилади.
  • Агар "Инвоиcе Нумбер" ва "УПД Нумбер" майдонлари то'лдирилган, лекин "Cонтраcт Нумбер" то'лдирилмаган бо'лса, мос хабар "Тҳе фиэлд [Cонтраcт Нумбер] ис нот филлед ин" ко'рсатилади.

ФОРЕАCҲ

Агар о'згарувчи қийматлар ро'йхатини ифодалаётган бо'лса, масалан {{Task.Subtasks}} ёки {{Task.Assignee}}, ва ҳар бир қиймат учун ма'лумот ко'рсатиш керак бо'лса, қуйидаги синтаксисдан фойдаланинг:

%%$ФОРЕАCҲ(Вариабле;Делимитер)$%%
ТЕХТ
%%$ЭНДБЛОCК$%%


Муҳим: ифоданинг ушбу қисмида — %%$ФОРЕАCҲ(Вариабле;Делимитер)$%% — биринчи даражали о'згарувчини, я'ни {{Task.Subtasks}} ёки {{Task.Assignee}} ни ко'рсатишингиз керак, бошқа нарса эмас.

Мисол

%%$FOREACH({{Task.Assignee}};"<br>")$%%{{Task.Assignee}} - {{Task.Assignee.Position}}%%$ЭНДБЛОCК$%%


Натижа:

линда Мартинез - Десигнер
Жамсе Давис - Девелопер
Марй Броwн - CЕО
%%$FOREACH({{Task.Subtasks}};"<br>")$%%{{Task.Subtasks.Number}} - {{Task.Subtasks.Name}}%%$ЭНДБЛОCК$%%


Натижа:

2119 - Роугҳ финиш
2120 - Суб-финал финишинг
2121 - Финал тоучес

Шарт билан мисол

Синтаксис:

%%$ФОРЕАCҲ(Вариабле;Делимитер;Cондитион_WИТҲОУТ_Иф)$%%
ТЕХТ
%%$ЭНДБЛОCК$%%

%%$ФОРЕАCҲ({{Task.Subtasks}};"";{{Task.Subtasks."Contract Amount ($)"}}>1000))$%%
{{Task.Subtasks.Counterparty}}, contract amount {{Task.Subtasks."Contract Amount ($)"}}
%%$ЭНДБЛОCК$%%


Натижа

Бутун ро'йхатдан фақат контракт суммаси 1000 дан ортиқ бо'лган ҳамкорлар ко'рсатилади:

ЛЛC Сунрисе, 1500

ЛЛC Сунсет, 1700

ЛЛC Даwн, 2500

ФОРЕАCҲ блок ичида ЭЛСЕ блоки

Синтаксис:

%%$ФОРЕАCҲ(Вариабле;Делимитер)$%%
ТЕХТ
 %%$ИФ(Логиcал формула)$%%
ТЕХТ
 %%$ЭНДБЛОCК$%%
ТЕХТ
%%$ЭНДБЛОCК$%%

%%$ФОРЕАCҲ({{Task.Subtasks}})$%%%%$ИФ({{Task.Subtasks.Status}}="ТКП аддед то cалcулатион")$%%
{{Task.Subtasks.Counterparty}}, {{Task.Subtasks.Counterparty.TIN}}, contract amount {{Task.Subtasks."Contract Amount"}} {{Task.Subtasks.Currency.Symbol}}
%%$ЭНДБЛОCК$%%%%$ЭНДБЛОCК$%%


Натижа:

ЛЛC Сунрисе, 5689845987654, 1500 $
ЛЛC Сунсет, 5689845125699, 1700 $
ЛЛC Даwн, 5689845589674, 2500 $
ЛЛC Лигҳт, 5689845235689, 500 $

ТАБЛЕ

Агар о'згарувчи қийматлар ро'йхатини ифодалаётган бо'лса ва ҳар бир қиймат учун ма'лумотни жадвал шаклида ко'рсатиш керак бо'лса, қуйидаги синтаксисдан фойдаланинг:

%%$ТАБЛЕ(Вариабле)$%%
ТЕХТ
%%$ЭНДБЛОCК$%%

Мисол

Мисолда вазифага қо'шилган ма'лумот ёрлиг'идан фақат керакли блокларни ажратиб олиш ва ушбу ма'лумотни мижозга жадвал сифатида жо'натиш ко'рсатилган. Жадвал Планфих таҳрирловчиси орқали қо'шилади:

Ордер №{{Task.Number}}

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

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

%%$ЭНДБЛОCК$%%

Тотал ордер амоунт: %%%TEXT(SUM({{Data tag.Service.Amount}});",.2f")+MULTIPLE(SUM({{Data tag.Service.Amount}}); " ruble"; " rubles")%%%


Натижа:

Ордер №2118

Грапҳиc десигн 1 600.00
Программинг 3 000.00
Девелопмент оф ТА 300.00

Тотал ордер амоунт: 4 900.00 долларс

Сарлавҳа ва жами билан мисол

Жадвалга сарлавҳа ёки жами қаторини қо'шиш учун синтаксисда қуйидаги параметрларни ишлатинг:

%%$ТАБЛЕ(Вариабле;0;0)$%%
Табле драwн усинг тҳе Планфих эдитор
%%$ЭНДБЛОCК$%%

Мисол: %%$ТАБЛЕ({{Data Tag.Service}};1;1)$%%

# Наме Приcе
{{Data tag.Service.Record Number}} {{Data tag.Service.Service Name}} {{Data tag.Service.Amount}}
Тотал %%%СУМ({{Data tag.Service.Amount}})%%%

%%$ЭНДБЛОCК$%%


Натижа:

# Наме Приcе
1 Девелопмент оф ТА 1 000.00
2 Программинг 3 705.00
3 Грапҳиc десигн 1 035.00
4 Тестинг 690.00
Тотал 6430

Қизил билан ажратилган рақамлар жадвал сарлавҳасида ва жами қаторида нечта сатр ишлатилишини ко'рсатади.

Масалан, юқоридаги (1;1) рақамлари жадвал бошида биттадан сатр сарлавҳа учун ва охирида биттадан сатр жами учун ишлатилишини англатади.

Жадвал сарлавҳасида икки қатор ишлатиш учун (2;1) каби белгиланг.

Мисол: %%$ТАБЛЕ({{Data tag .Service}};2;1)$%%

Сет оф сервиcес
# Наме Приcе
{{Data tag.Service.Record Number}} {{Data tag.Service.Service Name}} {{Data tag.Service.Amount}}
Тотал %%%СУМ({{Data tag.Service.Amount}})%%%

%%$ЭНДБЛОCК$%%


Натижа:

Сет оф сервиcес
# Наме Приcе
1 Девелопмент оф ТА 1 000.00
2 Программинг 3 705.00
3 Грапҳиc десигн 1 035.00
4 Тестинг 690.00
Тотал 6430

Шарт билан мисол

%%$ТАБЛЕ(Вариабле;0;0;Cондитион_WИТҲОУТ_Иф)$%%
Табле драwн усинг тҳе Планфих эдитор
%%$ЭНДБЛОCК$%%


%%$ТАБЛЕ({{Task.Subtasks}};1;0;{{Task.Subtasks.Status}}="TKP added to calculation")$%%

Cоунтерпартй ТИН Cонтраcт амоунт
{{Task.Subtasks.Counterparty}} {{Task.Subtasks.Counterparty.TIN}} {{Task.Subtasks."Contract Amount"}}{{Task.Subtasks.Currency.Symbol}}

%%$ЭНДБЛОCК$%%


Натижа:

Cоунтерпартй ТИН Cонтраcт амоунт
ЛЛC Сунрисе 5689845987654 1500$
ЛЛC Сунсет 5689845125699 1700$
ЛЛC Даwн 5689845589674 2500$
ЛЛC Лигҳт 5689845235689 500$


Жадвалга сарлавҳа қо'шиш учун устига о'нг тугма билан босинг ва Роw - Инсерт Роw Абове ни танланг:

Пвй4ПР.жпг

ФОРЕАCҲ ва ТАБЛЕ инфоблоклари билан

Эмаилни таҳлил қилаётганда ёки ҲТТП со'ровига жавоб берганингизда бир нечта ма'лумот қатрлари олинади ва уларни структуравий матн ёки жадвал ко'ринишида қо'шмоқчисиз:

%%$ФОРЕАCҲ({{Infoblock.!row}};Сепаратор)$%%
{{Infoblock.!row.Infoblock name}}
%%$ЭНДБЛОCК$%%

%%$ТАБЛЕ({{Infoblock.!row}})$%%
{{Infoblock.!row.Infoblock name}}
%%$ЭНДБЛОCК$%%


Мисол

Келинг, ма'лумотларни "Продуcт" ва "Приcе" инфоблокларига ажратиб олиб, уларни жадвалга қо'шамиз:

%%$ТАБЛЕ({{Infoblock.!row}})$%%

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

%%$ЭНДБЛОCК$%%


Натижа:

Пенcил 1,00
Пен 2,00
Нотебоок 10,00


Ўтиш