Переключатель

Назначение

Переключатель - это компонента, которая используется для выбора одного из нескольких предоставленных вариантов.Значения берутся из базы данных,а не вводятся вручную.

В зависимости от настройки свойств, включенных по умолчанию в состав компоненты, компонента Переключатель может использоваться для:

Для сохранения введенной информации в базу данных и отображения значения из базы данных (в данном случае, функция компоненты Переключатель. Сохранение значения должна быть включена)
Для отображения значений,которые были введены пользователем приложенияили являются константой, определённой в логике приложения (в данном случае, функция компоненты Дата. Сохранение значения должна быть выключена или удалена через настройки функции по кнопке)

Компонента Переключатель находится в разделе Компоненты - Поля - Переключатель.

Свойства

Компонента имеет набор общих свойств. Ниже отображены свойства, специфичные только для данной компоненты.

Наименование свойства	Назначение свойства	Принимаемые значения
Подсказка	позволяет создать подсказку, расположенную внутри элемента. Данное свойство не применимо с логикой отображения поля на странице приложения
Надпись	позволяет задать наименование поля, которое будет отображаться на странице	пример возможного значения: Статусы

Свойство Переключатель. Подгрузка данных

Позволяет задать источник подгрузки/сохранения данных в компоненту из/в объекта базы данных (таблицы или представления) с указанием следующих дополнительных настроек:

Граф сущностей элемента настраивается в соответствии с п. Настройка Графа сущностей. Является обязательным к заполнению и настройке.
Возвращать значение дополнительно из - по умолчанию компонента возвращает идентификатор записи выбранной из справочника значений. Настройка данного параметра позволяет указать компоненте, какое значение необходимо дополнительно считать и вернуть, кроме значения идентификатора выбранной пользователем записи.
Колонка наименования - позволяет задать колонку базы данных, значение которой будет отображено пользователю в списке
Порядок сортировки - позволяет задать порядок сортировки отображаемых значений в списке для выбора, принимает значения:
- по возрастанию- значения будут сортироваться от меньшего к большему
- по убыванию- значения будут сортироваться от большего к меньшему
Колонка сортировки - позволяет задать колонку базы данных, по которой будет производиться сортировка

Пример возможной настройки:

Свойство Переключатель. Сохранение значения

В случае, если значение в поле Переключатель необходимо сохранить или подгрузить из базы данных, указывается поле таблицы базы данных, куда будет сохраняться и откуда будет подгружаться введенное значение. Для выбора доступны только колонки имеющие числовой тип в базе данных.

В случае, если значение поля Переключатель не требуется сохранять или подгружать из базы данных, то данное свойство удаляется (или отключается). Данный вариант может быть необходим, когда поле используется для отображения значения, которое было введено пользователем приложения или является константой, определённой в логике приложения.

Базовые функции

Заполнить значением по умолчанию

Заполнить значением из переменной процесса

Дополнительные функции

В ходе настройки свойств компоненты (заданных по умолчанию) может оказаться недостаточно для выполнения поставленной задачи и получения необходимого результата.

Для каждой компоненты предусмотрен перечень функций, расширяющих её базовую функциональность, которые можно добавить нажатием кнопки Добавить скрипт.

Вследствие технических особенностей реализации функций (функции, которые выполняются удаленно на сервере приложений,- функции, которые выполняются в браузере пользователя), они имеют разные иконки, но это никак не влияет на их функциональность или предпочтительность использования.

Сохранить значение в переменную процесса любого типа

Методические рекомендации по применению

Пошаговые инструкции по применению компонента в типовых задачах Вы можете найти в разделах:

Как добавить Переключатель на страницу?

Часто задаваемые вопросы

Вопрос	Ответ
Чем отличается компонента Статичный переключатель от компоненты Переключатель?	Компонента Статичный переключательиспользуются для выбора значений, которые вводятся аналитиком при настройке компоненты,Переключательиспользуется для выбора значений,которые берутся из базы данных.
Все ли свойства компоненты обязательны для заполнения?	Нет.Свойства компоненты определяются в зависимости от решаемой задачи.
Возникнет ли ошибка при запуске приложения, если оставить незаполненным свойство Переключатель. Сохранение значения?	Да. В случае, если функция “Переключатель. Сохранения значения” включена у элемента и не заполнены ее параметры, то при валидации проекта возникнет ошибка. Если по условию задачи данное поле не должно подгружаться и сохраняться в базу данных, данную функцию в компоненте необходимо либо отключить либо удалить.
Если удалить базовые функции, которые включены в компоненту по умолчанию, например, “Заполнить значением по умолчанию” можно ли будет вновь их добавить?	Да. Если удалить какую-то базовую функцию компоненты, то по кнопке “Добавить функцию” она будет доступна для выбора.