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