Променљиве

Користите променљиве у текстуалним исечцима, окидачима и многим другим местима у Zammad-у за повлачење динамичких информација атрибута објекта.

Белешка

Обратите пажњу да је ово само преглед доступних променљивих. Може бити некомплетан или променљиве можда нису доступне унутар неких функција. Ако вам зафале променљиве или нисте сигурни да ли раде на очекиван начин, слободно питајте на форуму заједнице.

Основна употреба

Variables can be called by typing :: (just like text modules in the article editor), as long as you’re in a supported text field in the settings. Zammad will display all variables being available within this context and add the variable to your text as soon as you selected an entry. You can even search for and use variables for custom object attributes.

По одабиру променљиве, биђе приказана структура налик на: #{object.attribute}

Путоказ

Референцирате на празно поље и приказује се као -? Ово је очекивано понашање – пробајте да обезбедите да ова поља увек имају вредност.

Структура

Први део назива променљиве садржи врсту објекта, нпр. ticket, config, user.

Други део је назив атрибута. За прилагођене атрибуте објкета, ово је назив који одређујете за атрибут и можете га пронађи унутар панела атрибута. Први и други део променљиве су одвојени тачком, нпр.: ticket.number што на крају резултује у #{ticket.number}.

За атрибуте селекције са паровима кључ/вредност, Zammad преписује променљиву са називом кључа. У случају да желите да Zammad препише променљиву са вредношћу уместо кључа, мораћете додати трећу компоненту: #{ticket.select.value}.

Коришћење преведених променљивих

If you want to use a translated variable in triggers or schedulers, you can extend the placeholder like this: #{t(ticket.state.name)}. The t tells Zammad to search for fitting translated strings. The used output language is based on the system language of Zammad which you can set in the admin settings under Брендинг or based on the selected locale in the trigger/scheduler edit dialog.

Могући случај употребе: ако желите да пошаљете својим клијентима обавештења о тикетима путем окидача или планера која укључују и стање тикета. Коришћење подразумеване променљиве #{ticket.state.name} (без функције превода t()) ће резултовати у вредности назива стања на оригиналном (енглеском) језику.

Форматирање датума и времена

Језик и временска зона система одређују подразумевани формат датума и времена. Овај формат може бити прилагођен коришћењем dt() функције.

Параметри функције су следећи:

  1. Променљива датума или временске ознаке коју желите да форматирате.

  2. Формаз излазног низа текста.

  3. Временска зона за примену (необавезно).

Пример:
#{dt(ticket.updated_at, "%A %Y-%m-%d %H:%M у канцеларији", "Europe/Berlin")}
Понедељак, 2024-03-18 15:31 у канцеларији

Путоказ

Уколико желите да користите наш пример, обавезно налепите текст изнад без формата (CTRL Shift v), у супротном неће успети.

Следећа табела приказује доступне директиве формата:

Параметар

Опис

Напомена

%Y

Година са 4 цифре

Користите %y за годину са 2 цифре

%m

Месец године (као број са допуном нула)

Користите %-m за месец без допуне нула

%d

Дан месеца (као број са допуном нула)

Користите %e за дан без допуне нула

%H

Час дана у 24-часовном формату са допуном нула

Користите %k за час без допуне нула

%I

Час дана у 12-часовном формату са допуном нула

Користите %l за час без допуне нула и %p / %P за индикатор меридијана

%M

Минут часа

%S

Секунда минута

%A

Назив дана у недељи

Користите %a за скраћеницу или %^A за велика слова

%B

Назив месеца

Користите %b за скраћеницу

%U

Број недеље у текућој години

Користите %W за другачији обрачун

Савет

Подржане су све директиве Ruby метода strftime из DateTime класе. За више информације, погледајте овде.