Променљиве

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

Белешка

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

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

Променљиве могу бити излистане уносом :: (баш као и текстуални исечци у корисничком интерфејсу), све док сте у оквиру подржаног поља подешавања. Zammad ће приказати све доступне променљиве у овом контексту и додати у текст чим их одаберете. Можете чак претражити за и користити променљиве прилагођених атрибута објекта.

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

Путоказ

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

Структура

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

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

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

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

Ако желите да користите преведене променљиве у окидачима или планеерима, можете проширити поље променљиве на следећи начин: #{t(ticket.state.name)}. Функција t ће потражити међу одговарајућим преводима. Циљни језик је базиран на основу системског језика Zammad-а који можете подесити у панелу администратора под брендингом или на основу одабраног језика у дијалогу окидача/планера.

Могући случај употребе: ако желите да пошаљете својим клијентима обавештења о тикетима путем окидача или планера која укључују и стање тикета. Коришћење подразумеване променљиве #{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 класе. За више информације, погледајте овде.