Указанные нами параметры, переменные шаблона или поля документа возможно модифицировать с помощью специальных модификаторов, которые преобразуют данные.
Список модификаторов
В таблице ниже собран список всех модификаторов с кратким примером записи. Модификатор добавляется через символ > внутри фигурных скобок. Примеры использования модификаторов есть в этом уроке и в последующих.
| Модификатор | Описание |
|---|
| printable |
Преобразует значение в понятную пользователю строку. Подходит для данных любого типа данных.
{=Variable:Variable1 > printable}
|
| friendly |
Для данных типа Пользователь. Выводит только имя и фамилию пользователя, без его ID и логина.
{=Document:CREATED_BY > friendly}
|
| name |
Получает имя файла для полей типа Файл. С версии 20.100.0 модуля Бизнес-процессы.
{=Variable:File > name}
|
| responsible |
Для данных типа Дата и Дата/время. Выводит дату/время в часовом поясе Ответственного.
{=Variable:Datetime > responsible}
|
| server |
Для данных типа Дата и Дата/время. Выводит дату/время в часовом поясе Сервера.
{=Variable:Datetime > server}
|
| publink |
Для данных типа Файл. Создаёт публичную ссылку на файл. С версии 20.0.700 модуля Бизнес-процессы.
{=Document:PROPERTY_MY_FILE > publink}
|
| shortlink |
Для данных типа Файл. Создаёт короткую ссылку на файл. С версии 20.0.700 модуля Бизнес-процессы.
{=Document:PROPERTY_MY_FILE > shortlink}
|
| src |
Для данных типа Файл. Создаёт прямую ссылку на файл.
Важно: использование в коробочных версиях продукта не безопасно.
{=Document:PROPERTY_MY_FILE > src}
|
| Модификаторы для
преобразования типов данных
Все возможности такого преобразования смотрите в таблице преобразования типов данных.
|
| bool |
Преобразует данные в bool (булевый тип).
{=Variable:Variable1 > bool}
|
| date |
Преобразует данные в тип date (дата).
{=Variable:Variable1 > date}
|
| datetime |
Преобразует данные в тип datetime (дата/время).
{=Variable:Variable1 > datetime}
|
| double |
Преобразует данные в тип double (число).
{=Variable:Variable1 > double}
|
| int |
Преобразует данные в тип int (целое число).
{=Variable:Variable1 > int}
|
| file |
Преобразует данные в тип file (файл).
{=Variable:Variable1 > file}
|
| select |
Преобразует данные в тип select (список).
{=Variable:Variable1 > select}
|
| string |
Преобразует данные в тип string (строка).
{=Variable:Variable1 > string}
|
| text |
Преобразует данные в тип text (текст).
{=Variable:Variable1 > text}
|
| user |
Преобразует данные в тип user (пользователь).
{=Variable:Variable1 > user}
|
|
Таблица преобразования типов данных
Для понимания, как можно преобразовывать типы данных мы подготовили специальную таблицу. В ней вы можете получить информацию о том, возможен ли перевод одно типа данных в другой. И если возможно, то каким будет результат.
| Начальный/конечный
|
bool
(Да/Нет)
|
date
(Дата)
|
datetime
(Дата/Время)
|
double
(Число)
|
int
(Целое число)
|
file
(Файл)
|
select
(Список)
|
string
(Строка)
|
text
(Текст)
|
user
(Пользователь)
|
| bool (Да/Нет) | --- | x | x | 1 или 0 | 1 или 0 | х | х | Y или N | Y или N | x |
| date (Дата) | x | --- | по формату | timestamp | timestamp | x | x | по формату | по формату | x |
| datetime (Дата/Время) | x | по формату | --- | timestamp | timestamp | x | x | по формату | по формату | x |
| double (Число) |
0==N
!0==Y
| из timestamp | из timestamp | --- | (int) | x | x | (string) | (string) | user_<ID> |
| int (Целое число) |
0==N
!0==Y
| из timestamp | из timestamp | (float) | --- | x | x | (string) | (string) | user_<ID> |
| file (Файл) | x | x | x | x | x | --- | x | x | x | x |
| select (Список) | Y или N | x | x | (float) | (int) | x | --- | (string) | (string) |
user_<ID>
group_<CODE>
<ID>
|
| string (Строка) | Y или N | strtotime | strtotime | (float) | (int) | x | x | --- | (string) |
user_<ID>
group_<CODE>
<ID>
|
| text (Текст) | Y или N | strtotime | strtotime | (float) | (int) | x | x | (string) | --- |
user_<ID>
group_<CODE>
<ID>
|
| user (Пользователь) | x | x | x | ID | ID | x | x | (string) | (string) | --- |
|
Примечание: все выражения в тексте автоматически преобразуются к строке, при отсутствии дополнительных идентификаторов.
Примечание: при преобразовании типа Список в Строку или Текст берутся значения списка, при преобразовании Списка в Список - ключи списка. Для получения значения ключа списка используйте конвертирование, например: {=Variable:Select > select}.
Важно! Для версий модуля до 15.6.0 преобразование типов данных, в том числе и запрос печатной формы для значений, не имеющих таковой, возможно с помощью переменных и действия PHP-код.
Примеры
printable
Для параметров и переменных шаблона, а так же полей документа используется модификатор printable, преобразующий значения в понятную пользователю строку.
Возьмем переменную типа пользователь. Результат, если значение переменной равно Автор:
{=Variable:user} author
{=Variable:user > printable} Автор
Для поля документа или параметра такой вариант отображения может быть сразу доступен для вставки в форме Вставка значения.
Если же печатная форма не предусмотрена, то запросить вывод печатной формы от любого значения получится и вручную (для переменной, дополнительного результата и т.п.). Кроме того, можно использовать модификаторы одновременно. Например, для переменной типа Datetime добавляем printable с преобразованием типа данных в Date:
{=Variable:Datetime > date, printable} // перевод даты в печатную форму
{=Variable:string>date} // преобразование строки в дату
friendly
Для данных типа Пользователь есть возможность преобразования в формат friendly. В таком случае выводится только имя и фамилия пользователя, без его ID и логина.
Пример: {=Document:CREATED_BY} > User_1
{=Document:CREATED_BY > printable} > Иван Иванов [1]
{=Document:CREATED_BY > friendly} > Иван Иванов
name
С версии 20.100.0 модуля Бизнес-процессы добавлена возможность получить имя файла через модификатор name для полей типа Файл. Пример для переменной типа Файл:
{=Variable:File > name} // вывод названия файла
Другие примеры
