Документация / Система администрирования версии 2.4 / Управление / Списки

NetCat // Online-документация

Списки

Импорт списка

Списки - простейшая таблица, структура которой состоит из трех полей: номер (ID) записи, ее значение (текстовое поле) и приоритет. Так, если мы создаем список 'Деньги' (Money), в ней будут три поля: Money_ID, Money_Name и Money_Priority. В теории баз данных термину 'список' соответствует термин 'классификатор'.

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

Создать список 'Пол' (английское название, к примеру, Sex) и добавить в него элементы 'мужской' и 'женский';
Создать шаблон (например, номер 8) и прочие поля. При этом будет создана таблица Message8;
Создать поле 'Пол' (комментарий к полю) с названием, например, Sex. В 'Типе поля' необходимо выбрать значение 'Список', в 'Формате' указав значение 'Sex' - аналогичное названию классификатора. При этом в таблице Message8 появится поле Sex целого типа.

После этого при добавлении/изменении записей данного шаблона для каждого объекта будет выводиться выпадающий список (HTML-тег <select>), в котором будут значения 'мужской' и 'женский'.

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

В шаблоне при использовании поля типа Список можно получить как название элемента списка, так и его ID. Например, поле называется List, в таком случае $f_List вернет название, а $f_List_id - ID элемента, т.е. приставка _id помогает получить ID.

При использовании альтернативных форм добавления/изменения объектов для вывода списка используйте функцию nc_list_select().