Загрузка...

4.03. Поле Список

Поле обеспечивает для пользователя выбор из заранее установленных администратором конфигурации значений. Эти значения либо вводятся в таблицу из 3 полей: значение, заголовок, по умолчанию, либо получаются из какого-либо поля документа в режиме выполнения.

В таблице для каждого варианта нужно установить:

1) значение - это числовое значение, которым можно будет оперировать в дальнейшем в действиях маршрута;

2) заголовок - это текст варианта, который увидит пользователь;

3) переключатель "по умолчанию" позволяет указать вариант, который будет установлен по умолчанию при создании документа.

При использовании в качестве источника данных для списка не таблицы, а поля с разделителями, необходимо:

1) выбрать само это поле-источник (очевидно, что лучше всего на этом месте будут смотреться строковые и текстовые поля);

2) ввести разделитель между вариантами, например, |

3) ввести разделитель между заголовком и вариантом, например, ::

Если использовать приведенные примеры разделителей, то поле-источник должно содержать строку следующего формата:

    Значение 1::Заголовок 1|Значение 2::Заголовок 2|Значение 3::Заголовок 3

которое поле Список превратит в выпадающий список или набор переключателей: Заголовок 1, Заголовок 2, Заголовок 3, а в качестве значения поля будут выступать Значение 1, Значение 2 или Значение 3.

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

Методы поля для записи данных

  • Найти и записать значение по заголовку. По умолчанию, для изменения выбранного варианта через, скажем, действие Запись в поле нужно передавать числовой идентификатор значения этого варианта. Данный метод позволяет использовать не числовое значение, а текстовый заголовок варианта.  Например, имеется списочное поле с двумя вариантами: Да (значение = 1) и Нет (значение = 2). Чтобы установить второй вариант можно напрямую (через обычный стандартный метод) записать 2 либо через описываемый метод строку Нет.  В обоих случаях результат будет одинаков.

Методы поля для получения данных

  • Получить заголовок выбранного варианта. Если записать списочное поле, скажем, в строку, то запишется значение выбранного варианта (числовой идентификатор). Чтобы записать текстовый заголовок выбранного варианта просто примените этот метод. Если поле имеет включенный множественный выбор, и пользователь выбрал несколько вариантов, метод вернет заголовки всех этих вариантов, перечисленные через запятую.