Модификаторы плейсхолдеров
- В плейсхолдеры можно добавить модификаторы, для этого нажмите в созданном плейсхолдере на кнопку «Добавить модификатор»:
- Например, значение поля ФИО по умолчанию выводится в именительном падеже — Иванов Иван Петрович:
- Чтобы виджет вывел поле, например, в дательном падеже — Иванову Ивану Петровичу, в плейсхолдер надо добавить специальный модификатор «Склонение ФИО» и выбрать «Дательный падеж»:
- Создадим такой шаблон с модификатором «Склонение ФИО» (в дательном падеже):
- Теперь переходим в сделку, где есть наименование контакта (полное ФИО):
- Генерируем документ. Согласно нашему шаблону ФИО контакта автоматически просклонялось в дательном падеже:
- Чтобы удалить модификатор из плейсхолдера, нажмите на крестик:
- Один и тот же плейсхолдер может быть как с модификатором, так и без модификатора:
- У одного плейсхолдера может быть несколько модификаторов. Например, можно выбрать, чтобы виджет писал наименование контакта транслитом и переводил полное ФИО к фамилии с инициалами. Для этого добавьте в плейсхолдер («Сущность» — «Контакт», «Поле» — «Наименование контакта») сначала один модификатор («Фамилия с инициалами»):
- Сгенерированный виджетом документ будет выглядеть следующим образом:
Примеры модификаторов:
- Модификатор «Необязательное поле» — при отсутствии данных в выбранных полях сделки плейсхолдер будет оставаться незаполненным. Можно вписать в поле значение по умолчанию.
Пример
- Создайте плейсхолдер с любыми «Сущностью» и «Полем». В выпадающем списке выберите модификатор «Необязательное поле»:
- Теперь можете оставить поле незаполненным, тогда при отсутствии данных в выбранном поле плейсхолдер будет оставаться незаполненным, или вписать значение по умолчанию, тогда при отсутствии данных в выбранном поле будет выводиться написанное в «по умолчанию». В данном примере при отсутствии значения «Бюджета сделки» будет автоматически в шаблоне выводиться слово «нет»:
- Вставим плейсхолдер в шаблон, перейдём в сделку без бюджета и сгенерируем документ:
- Так как поле бюджета пустое, в сделке выведется слово “нет”:
- Если бы поле «по умолчанию» осталось незаполненным, то в сгенерированном документе вместо «нет» было бы пусто.
Если этого модификатора нет, то поле обязательное и виджет будет гореть красным, напоминая о том, что нужно заполнить поля, чтобы сгенерировать этот документ.
- Модификатор «Число прописью» — записывает числовые значения поля в виде слов.
Пример
- Выберите модификатор «Число прописью» для «Сущности» в числовом выражении. В примере: «Сущность» — «Сделка», а «Поле» — «Бюджет сделки», именно «Бюджет сделки» будет выводиться в прописном виде:
- В нашем примере в сделке бюджет равен 12 600:
- В сгенерированном документе по шаблону выше бюджет сделки вывелся прописью:
Модификатор «Число прописью» можно использовать для составления договоров, когда необходимо в скобках прописать, например, сумму бюджета. Особенно часто число прописью необходимо для подготовки накладных, договоров и других документов.
- Модификатор «Штрихкод» — создаёт штрихкод из id сделки по заданным параметрам.
Пример
- Выберите «Сущность» — «Сделка», «Поле» — «ID сделки», задайте штрихкоду размеры и тип кодирования:
- Вставьте плейсхолдер с модификатором в шаблон:
- По шаблону выше Dokker из сделки сгенерировал документ со штрихкодом:
- Модификатор «Формат даты» — вид, в котором будет выводиться дата.
Пример
- Полям типа «Дата» можно задать формат вывода. Для этого выберите модификатор «Формат даты» и из выпадающего списка выберите тот формат, который необходим:
- Модификатор «Склонение ФИО» — изменяет ФИО в нужном падеже.
Пример
- Создайте плейсхолдер: «Сущность» — «Контакт»/«Пользователь», «Поле» — «Наименование контакта/пользователя». Выберите модификатор «Склонение ФИО»:
- По умолчанию ФИО выводится в именительном падеже — Иванов Иван Петрович. Чтобы виджет вывел поле, например, в дательном падеже — Иванову Ивану Петровичу, нажмите на «Дательный падеж» в выпадающем списке:
- Теперь вставьте данный плейсхолдер в шаблон и перейдите в сделку, где есть наименование контакта (полное ФИО):
- Если вы сгенерируете документ, ФИО контакта автоматически просклоняется в дательном падеже:
- Модификатор «Денежная сумма прописью» — записывает денежные суммы в виде слов с указанием валюты.
Пример
- Выберите модификатор «Денежная сумма прописью» для «Поля» плейсхолдера в числовом выражении. В данном примере создан плейсхолдер: «Сущность» — «Сделка», «Поле» — «Бюджет сделки». Именно «Бюджет сделки» будет выводиться в прописном виде:
- Выберите валюту:
- И поставьте нужные галочки:
- Вставьте модификатор в документ:
- Теперь перейдите в сделку, в данном примере бюджет равен 12 600:
- В сгенерированном документе по шаблону выше бюджет сделки вывелся прописью:
Модификатор «Денежная сумма прописью» можно использовать для составления договоров, когда необходимо в скобках прописать, например, сумму бюджета в накладных, договорах и других документах.
- Модификатор «Число прописью» — записывает числа в буквенном представлении.
Пример
- Выберите модификатор «Число прописью» для «Поля» в плейсхолдере в числовом выражении. В данном примере создан плейсхолдер: «Сущность» — «Сделка», «Поле» — «ID сделки». Именно «ID сделки» будет выводиться в прописном виде:
- Скопируйте нужный модификатор и вставьте в документ:
- Перейдите в сделку и сгенерируйте документ. В данном примере ID сделки представлен в числовом виде — 4247109:
- По созданному выше шаблону виджет создал документ, представив ID сделки в прописном виде:
- Модификатор «Фамилия с инициалами» — преобразование полного ФИО к фамилии с инициалами (фамилией считает первое слово).
Пример
- Создайте плейсхолдер: «Сущность» — «Контакт»/«Пользователь», «Поле» — «Наименование контакта/пользователя». Выберите модификатор «Фамилия с инициалами»:
- Вставьте плейсхолдер с модификатором в шаблон:
- Теперь перейдите в сделку. В данном примере указано ФИО контакта — Григорьев Николай Александрович:
- Сгенерированный документ по шаблону выше выглядит следующим образом:
- Модификатор «Склонение слов» — склонения любых русских слов в нужном падеже кроме ФИО.
Пример
- Выберите модификатор «Склонение слов» для «Поля» в плейсхолдере в текстовом виде:
- Выберите нужный падеж, в котором хотите просклонять слово:
- Вставьте плейсхолдер в документ:
- Теперь перейдите в сделку, в данном примере должность клиента — руководитель отдела продаж:
- Сгенерировав документ по шаблону выше, должность просклонялась в указанном падеже (родительном):
- Модификатор «Транслит» — преобразование любого текста в транслитное написание по ГОСТу 7.79-2000.
Пример
- Создайте плейсхолдер с любым текстовым «Полем», выберите модификатор «Транслит»:
- В данном примере в транслитное написание будет преобразовываться ФИО контакта. Вставьте плейсхолдер в шаблон:
- Теперь перейдите в сделку, в данном примере ФИО контакта — Соловьева Елена Михайловна:
- Далее — сгенерируйте документ, ФИО виджет преобразовал в транслитное написание:
- Модификатор «Дата прописью» — преобразует дату в буквенное выражение.
Пример
- Создайте плейсхолдер: «Сущность» — «Документ», «Поле» — «Текущая дата». Выберите модификатор «Дата прописью»:
- Использовать можно для написания текущей даты в прописном виде, например, в скобках в документах:
- Сгенерируйте документ, дату виджет отобразил в прописном виде:
