При настройке интерфейсов и написании сценариев используются контекстные переменные. Переменные нужны, чтобы задать в виджете определенное значение, например, значение счетчика, а также настроить отображение компонентов страницы, разместить на форме необходимые для работы поля и т.д.
Следует разделять контекст виджета и контекст приложения.
Контекст виджета
Контекст виджета — это переменные, используемые в настройках виджетов и страниц.Это своего рода служебные переменные, которые используются для разработки сценариев, определяющих поведение виджета. Они нужны для того, чтобы подтягивать нужную информацию из приложений, настраивать отображение самого виджета, загружать файлы и так далее.
Добавить такую переменную можно в дизайнере интерфейсов на вкладке Контекст.
Нажмите кнопку +Добавить и создайте переменную нужного типа. Подробнее про типы данных в системе вы можете прочитать в этой статье.
В названии переменных нельзя использовать кириллицу. Также постарайтесь использовать понятные названия, которые отражают суть переменной, например, Username вместо Var123.
Обратите внимание, в настройках переменных доступна опция Отображается при выполнении условия.
Она позволяет задать условия, при которых данное поле будет отображаться в виджете. В остальных случаях поле будет скрыто. Таким образом вы можете настроить виджет, который будет подстраиваться под действия пользователя. Например, если сотрудник установил переключатель Да/Нет в положение Да, то рядом появится дополнительное поле.
Переменные, добавленные на вкладке Контекст, также отображаются в правой панели дизайнера во вкладке Свойства.
Созданные переменные можно использовать в настройках виджетов и при написании сценариев.
Рассмотрим следующий пример:
Допустим, вы хотите разместить на странице колонку с инструкциями по оформлению платежа, которая будет отображаться только при определенных условиях: когда менеджер по продажам, оформляя заказ, укажет способ оплаты «Постоплата».
Для этого добавьте на страницу виджет Колонка, в его контексте создайте переменную типа Да/Нет и укажите ее в поле «Скрыть». Эта переменная позволяет пользователю выбирать один из двух предложенных вариантов, при этом вместо «Да» и «Нет» вы можете указать любые опции, в нашем случае, «Предоплата» и «Постоплата».
Теперь разместите эту переменную на странице, чтобы пользователь во время работы мог выбрать один из вариантов оплаты. Если он выберет вариант «Постоплата», то отобразится скрытая колонка с дальнейшими инструкциями по оформлению заказа.
Эту же переменную можно использовать в сценарии, к примеру, в событии при наведении курсора виджета «Кнопка». Тогда вкладка появится в тот момент, когда пользователь наведет курсор на кнопку.
Контекст приложения
Контекст приложения — это поля приложения, которые пользователи заполняют или просматривают при работе с карточками приложения. Например, поля для ввода фамилии, суммы заказа, загрузки файла и т.д.
Со свойствами приложения можно работать в дизайнере интерфейсов, а также в стандартном режиме и расширенном режиме.
В дизайнере интерфейсов свойства приложения перечислены на правой панели на вкладке Свойства. Оттуда вы можете перетаскивать их на форму и размещать в нужном порядке.
Подробнее о свойствах форм вы можете прочитать в этой статье.
Работа с дизайнером интерфейсов при создании шаблона формы подробно описана в этой статье.