Метки нужны для альтернативного способа добавления полей.
Метки — это элементы, которые позволяют автоматизировать создание документов и настраивать их содержимое в зависимости от данных или заданных условий. С их помощью можно вставлять поля в шаблон и управлять ими, задавать условия и выполнять повторяющиеся операции.
Ранее мы уже встречались с метками через использование полей. Например, при вставки полей в шаблон, использовалось: Вставить "Значение", которое соответствует метке «Значение». В поле Да/Нет мы использовали метку «Условие». В полях Перечисление и Объединение применялась конструкция «Выбор», а в поле Список использовалась конструкция «Цикл».
Метки в шаблон можно вставить двумя способами:
1. Через вкладку «Метки» в верхнем меню.
2. Щелкнув правой кнопкой мыши по области редактирования и выбрав пункт «Вставить метку».
Значение
Подробнее
Метка «Значение» — это способ вставки полей в шаблон по их идентификатору с возможностью проведения различных манипуляций над ними, таких как применение функций или выполнение арифметических операций.
Данная метка предназначена для таких полей как: Текст, Целое число, Десятичное число, Дата, Время, Дата/Время, Перечисление.
Работа с меткой:
Для вставки метки в шаблон (область редактирования) перейдите на вкладку«Метки»®«Значение». Обращение к полю возможно только через его идентификатор. Если поля, вставляемые через метку «Значение», находятся внутри составного поля, сначала указывается идентификатор составного поля, затем ставится точка (.), после чего указывается идентификатор вложенного поля. Составное поле выступает как контейнер для других полей, поэтому обращение сначала производится к контейнеру, а затем к вложенному полю.
В появившемся окне введите идентификатор поля и нажмите кнопку «ОК»
Сохраните изменения и проверьте результат.
Условие
Подробнее
Метка «Условие» — это способ настроить шаблон так, чтобы определённая информация появлялась только при выполнении заданного правила. Например, вы можете указать, что если сумма заказа больше 10 000, в документе автоматически просчитается скидка в 10%. Если правило не выполняется, то отображается сумма без скидки.
Метка «Условие» имеет конструкцию: ЕСЛИ(условие) [действие, происходящие при выполнении условия] ИНАЧЕ [действие, отображаемое, если условие не выполнено]/ЕСЛИ
Пример использования
В магазине предоставляется скидка 10% на товар, если его стоимость превышает 10 000 рублей. Если стоимость товара 10 000 рублей или меньше, скидка не применяется, и покупатель платит полную сумму.
Шаги:
Создайте поле «Десятичное число».
Установите курсор в область редактирования, перейдите на вкладку «Метки» и выберите «Условие» ® «Если».
В открывшемся окне задайте условие:
цена > 10000
где цена— идентификатор поля,
>— символ «больше»,
10000— пороговое значение, при превышение которого будет применена скидка.
Нажмите «ОК».
Установите курсор после если(цена > 10000).
Щелкните правой кнопкой мыши и выберите «Вставить метку» ®«Значение».
Формула для расчета цены со скидкой:
Цена со скидкой = Цена товара * (1 - Скидка/100).
Формула учитывает:
Скидка = 10% (в дробном выражении 0.1).
Умножение на (1 - 0.1) = 0.9 (показывает, что из 100% стоимости товара вычитается 10%).
Пример формулы в Комбинаторе:
цена * 0.9
Альтернативные варианты:
цена * (1-0.1)
цена - (цена * 0.1)
Нажмите «ОК».
Для обработки случая, когда условие не выполняется, добавьте блок «Иначе». Поставьте курсор после формулы, перейдите на вкладку «Метки» и выберите «Условие» ® «Иначе».
После блока «Иначе» нажмите правой кнопкой мыши и выберите «Вставить метку» ®«Значение». Здесь просто укажите идентификатор поля Цена, так как скидка в этом случае не применяется.
Нажмите «ОК».
Завершите конструкцию, выбрав на вкладке «Метки» пункт «Условие» ® «/Если».
Выбор
Подробнее
Метка «Выбор» — это способ проверить конкретные значения, которые вводит пользователь. Например, если в поле «Целое число» ввести значение 5, и для него предусмотрен вариант, то в документе отобразится текст, например: «Отлично!». Если ввести значение, которое не соответствует ни одному из вариантов, то может отобразиться либо введённое число, либо другой заранее заданный текст, либо ничего. Это удобно, если нужно определить несколько вариантов и настроить логику для каждого из них.
Метка «Выбор» имеет конструкцию: ВЫБОР (идентификатор поля) ВАРИАНТ (Условие) [действие происходящие при выполнении условия] ПРОЧЕЕ [действие, отображаемое, если условие не выполнено] \ВЫБОР
Пример использования
Вводится оценка ученика (от "Отлично" до "Плохо"). На основании результата нужно вывести соответствующее число:
- Если ученик получил "Отлично" — 5.
- Если ученик получил "Хорошо" — 4.
- Если ученик получил "Удовлетворительно" — 3.
- Если ученик получил "Плохо" — 2.
Шаги:
Создайте поле «Текст».
Установите курсор в область редактирования, перейдите на вкладку «Метки» и выберите «Выбор» ® «Выбор».
В открывшемся окне укажите идентификатор поля оценка:
Нажмите «ОК».
Установите курсор после выбор(оценка).
Щелкните правой кнопкой мыши и выберите «Вставить метку» ®«Выбор» ®«Вариант» .
В появившемся окне в двойных кавычках введите слово Отлично.
Нажмите «ОК».
Установите курсор после вариант("Отлично").
Введите цифру 5.
Пропишите остальные варианты также.
Для обработки случая, когда нет подходящего варианта, добавьте блок «Прочее». Поставьте курсор после цифры "2", перейдите на вкладку «Метки» и выберите «Выбор» ® «Прочее».
Пропишите, что должно выводиться, если введенное значение не совпадает не с одним вариантом.
Завершите конструкцию, выбрав на вкладке «Метки» пункт «Выбор» ® «/Выбор».
Цикл
Подробнее
Метка «Цикл» — это конструкция, которая позволяет повторять одно и то же действие или набор действий несколько раз
ЦИКЛ([идентификатор элемента списка] из [идентификатор поля Список]) [действие/поле, которое будет повторяться] /ЦИКЛ
ТАБЛИЦА([идентификатор элемента списка] из [идентификатор поля Список])
Пример использования ЦИКЛА
Задача: Сформировать список товаров с указанием наименования и стоимости каждого товара.
Шаги:
Создайте поле «Список» с элементом списка «Составное поле».
Добавьте в составное поле «Текст» и «Десятичное число».
Установите курсор в область редактирования, перейдите на вкладку «Метки» и выберите «Цикл» ® «Цикл».
В открывшемся окне укажите «Переменная ряда» (идентификатор составного поля), «Список» (идентификатор поля Список), и по желанию разделитель (. , ; :):
Нажмите «ОК».
Внутри цикла пропишите текст.
Напротив «Наименование» и «Стоимость» вставите поля через «Метки»®«Значение». Если элементом списка является составное поле, сначала укажите идентификатор составного поля, затем поставьте "." и добавьте идентификатор вложенного поля (например: товары.наименование).
Закройте цикл, через вкладку «Метки» ® «Цикл» ® «/Цикл».
Пример использования ТАБЛИЦЫ
Задача: Сформировать список товаров с указанием наименования, стоимости и количества каждого товара, а также рассчитать общую стоимость всех позиций.
Шаги:
Создайте поле «Список» с элементом списка «Составное поле».
Добавьте в составное поле «Текст», «Целое число» и «Десятичное число».
Установите курсор в область редактирования, перейдите на вкладку «Метки» и выберите «Цикл» ® «Таблица».
В открывшемся окне укажите «Переменная ряда» (идентификатор составного поля), «Список» (идентификатор поля Список), «Количество столбцов», «Строка заголовка» (строка для наименование столбцов), «Нижний колонтитул таблицы» (строка для подсчетов Итоговой стоимости):
Нажмите «ОК».
Поместите курсор в ячейку, предназначенной для вставки полей.
Щелкните правой кнопкой мыши по ячейке и выберите «Вставить метку» ® «Значение».
В появившемся окне укажите идентификатор поля, который является элементом списка. Если элементом списка является составное поле с другими вложенными полями, сначала укажите идентификатор составного поля, затем поставьте "." и добавьте идентификатор вложенного поля (например: товары.наименование).
Нажмите кнопку «ОК».
Повторите этот процесс для всех вложенных полей.
Шаблон
Подробнее
Основной функционал метки «Шаблон» заключается в возможности подгружать данные из одного шаблона в другой с использованием всего одной строки. Например, если у вас есть два готовых шаблона — «Акт приёма» и «Акт сдачи», вы можете с помощью метки «Шаблон» подключить их к основному документу, например, после текста договора.
Данная метка подгружает уже заранее созданные шаблоны.
Добавление метки и настройка ее вариативности в шаблоне
Автоматическая загрузка «Акт приема» в «Договор»
Вариант 1
Откройте шаблон «Акт приема» и скопируйте поля, находящиеся в Анкете слева. Для этого нажмите на три точки рядом с Анкетой и выберите пункт «Экспорт».
Перейдите в шаблон «Договор», нажмите на три точки слева от Анкеты и выберите пункт «Импорт».
Нажмите «Выберите файл», перейдите в «Этот компьютер»®«Загрузки». Выберите файл в формате .json и подтвердите действие.
После загрузки полей в Анкету установите курсор в область редактирования, в то место, где нужно будет отображать информацию из другого шаблона.
Откройте вкладу «Метки» и выберите пункт «Шаблон».
В появившемся окне укажите путь к шаблону. Для этого нажмите на три точки справа от поля «Путь к фрагменту».
Выберите необходимый шаблон и нажмите «ОК».
После указания пути снова нажмите «ОК».
Сохраните изменения и проверьте результат.
Вариант 2
Откройте два шаблона в разных вкладках: «Акт приема» и «Документ».
В шаблоне «Документ» установите курсор в область редактирования, в то место, где необходимо отобразить информацию из другого шаблона.
Перейдите на вкладу «Метки» и выберите пункт «Шаблон».
В появившемся окне укажите путь к шаблону. Для этого нажмите на три точки справа от поля «Путь к фрагменту».
Выберите нужный шаблон и нажмите «ОК».
После указания пути нажмите на кнопку «Добавить параметр», чтобы связать поля.
Укажите «Имя параметра» и «Выражение параметра».
Имя параметра— идентификатор поля в шаблоне «Акт приема».
Выражение параметра— идентификатор поля в шаблоне «Договор».
Нажмите «ОК»
Сохраните изменения и проверьте результат.
Отображение «Акт приема» только после выбора в анкете
Откройте шаблон «Акт приема» и скопируйте поля, находящиеся в Анкете слева. Для этого нажмите на три точки рядом с Анкетой и выберите пункт «Экспорт».
Перейдите в шаблон «Договор».
В Анкете слева создайте поле типа«Да/Нет»с названием «Акт приема».
Нажмите на три точки слева от Анкеты и выберите пункт «Импорт».
Нажмите «Выберите файл», перейдите в «Этот компьютер»®«Загрузки». Выберите файл в формате .json и подтвердите действие.
Вставьте поле «Акт приема» в область редактирования.
Установите курсор междуесли(актПриема) и иначе.
Перейдите на вкладу «Метки» и выберите пункт «Шаблон».
В появившемся окне укажите путь к шаблону. Для этого нажмите на три точки справа от поля «Путь к фрагменту».
Выберите необходимый шаблон и нажмите «ОК».
После указания пути снова нажмите «ОК».
Нажмите на поле «Акт приема»и в его свойствах, в поле «Значение по умолчанию», укажите: ложь.
В свойствах полей «Дата приема» и «ФИО»в свойствах пропишитеусловия видимости: актПриема. Это необходимо, чтобы поля отображались только в случае, если нужно отобразить шаблон «Акт приема».
