Флаг

Назначение

Флаг - это компонента, которая используется для проставления отметок в виде “флажков - галочек” в группе из нескольких доступных пользователю вариантов выбора значений. Отличается от компоненты Переключатель тем, что предоставляет выбор сразу нескольких значений вместо одного из альтернативных. При одиночном использовании (не в составе группы) может использоваться как включатель/выключатель какой-либо функциональности, разработанной аналитиком на web-странице. В этом случае используется совместно с компонентой Обработка Событий, которая управляет реакцией системы на изменение значения компоненты Флаг.

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

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

Компонента Флаг (без возможности сохранения) находится в разделе Компоненты - Поля - Флаг

Свойства

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

Наименование свойства	Назначение свойства	Принимаемые значения
Подсказка	позволяет создать подсказку, расположенную внутри элемента	данное свойство не применимо с логикой отображения поля на странице приложения
Надпись	позволяет задать наименование поля, которое будет отображаться на странице	пример возможного значения: Пример поля Флаг
Значение	позволяет задать значение по умолчанию, которое примет компонента при открытии страницы в приложении, значение типа Boolean (TRUE, FALSE, UNDEFINED)	Истина (TRUE), Ложь (FALSE), Не определено (UNDEFINED) - значение по умолчанию
Allow null	позволяет регулировать возможность выбора (отображения) значения “Не определено (UNDEFINED)” при работе с полем Флаг	Активно - позволяет выбирать значение “Не определено (UNDEFINED)” пользователем при работе с полем на ряду со значениямиИстина (TRUE) иЛожь (FALSE), Не активно - исключает возможность выбора значения “Не определено (UNDEFINED)” пользователем при работе с полем, т.е. к выбору доступны только два значения Истина (TRUE) и Ложь (FALSE)- значение по умолчанию

Свойство Флаг.Сохранение значения

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

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

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

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

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

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

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

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

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

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

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

Как задействовать компоненту Флаг на странице?

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

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