Для формирования иерархических справочников в системе существует форма «Настройка иерархии». Вызов формы можно осуществлять двумя способами:
- при настройке публикаций профильных документов в окне “Публикации” нажатием кнопки “Настройка иерархии” (см.п. «Профильные документы»). Система позволяет формировать иерархическую структуру только для существующих справочников, поэтому сначала необходимо опубликовать профильный документ, а затем формировать его иерархию;
- из пункта меню «Настройки»->»Настройка иерархий». В этом случае можно работать с иерархиями всех существующих справочников.
Иерархические справочники организованы таким образом, что при манипулировании атрибутами иерархий происходит реструктуризация только самой иерархической структуры, а элементы справочника остаются неизменны.
Форма содержит следующие элементы и сервисы:
- Элемент “Наименование справочника” содержит наименование текущего настраиваемого справочника. Справочник выбирается из выпадающего списка элемента.
- Элемент “Настройки иерархий” содержит список всех настроенных иерархий выбранного справочника. Первое поле списка содержит наименование иерархии, второе – флаг “Иерархия по умолчанию”. Иерархия по умолчанию может быть одна для данного справочника и автоматически устанавливается текущей при вызове иерархического справочника. Иерархию по умолчанию можно удалить только в том случае, если не существует других настроенных для данного справочника иерархий. В противном случае система будет отменять операцию удаления. В случае если добавляемая иерархия является первой для данного справочника, она назначается иерархией по умолчанию.
- Элемент “Свойства иерархии” предназначен для редактирования параметров, достаточных для создания иерархий. Их всего четыре:
“Наименование” – наименование иерархии.
“Ширина уровня” задает количество символов для кодирования элементов одного уровня. Возможность манипулирования этим параметром была реализована для предотвращения использования лишней памяти для хранения строкового идентификатора при необходимости. Максимальное количество символов в идентификаторе равно 255. Максимальное количество символов на один уровень равен 9 (определяется диапазоном целочисленного типа int). Таким образом, минимальное количество уровней иерархи равно 28 (255 MOD 9), максимальное количество равно 255.
“Поле кода экземпляра” – наименование поля документа для построения связи Parent-Child, на который будет ссылаться документ более низкого уровня.
“Поле ссылки на код родителя” – наименование поля документа, содержащего ссылку на элемент более высокого уровня для построения связи Parent-Child, на который будет ссылаться документ более низкого уровня.
Значения последних двух параметров выбираются из выпадающего списка полей профильного документа, имеющих флаг возможности установки фильтра по ним. (см. п. «Публикация профильных документов»). При выборе полей для связи необходимо учитывать следующие ограничения: 1) поля должны быть одного типа данных; 2) поля не должны быть одинаковыми.
Взаимодействие с иерархическими справочниками.
Работа с иерархическим справочником осуществляется тем же самым способом, что и работа с линейным. В случае, если выбор происходит из справочника, имеющего хотя бы одну сгенерированную иерархию, то он будет представлен в иерархическом виде, иначе – в линейном. В первом случае окно справочника состоит из трех основных элементов: “Представления справочника”, “Элементы справочника”, “Поиск и сортировка”.
Элемент “Представления справочника” представляет собой поле со списком содержащее наименования настроенных для данного справочника иерархий и дополнительно строку “Все строки”. Значение элемента окна “Представления справочника” определяет внешний вид окна справочника. В случае выбора наименования одной из иерархий будет меняться древовидная структура в элементе “Элементы справочника” в соответствии с выбранной иерархией. При выборе значения “Все строки” будет выдаваться линейный список всех элементов справочника c учетом настроек фильтра. При вызове справочника он выглядит в соответствии с иерархией, назначенной для него по умолчанию.
Часть формы “Элементы справочника” состоит в свою очередь из иерархического списка, позволяющего просматривать древовидную структуру справочника (слева), и элемента, представляющего линейный список строк справочника (справа). Между ними находится разделитель, позволяющий изменять ширину окон по усмотрению пользователя.
В списке просмотра древовидной структуры справочника представлены только те элементы, у которых имеются вложения более низкого уровня. Вершина структуры не соответствует никакому элементу справочника. Наименование узла в древовидной структуре имеет следующий формат: <код элемента> наименование элемента. Навигация в древовидной структуре аналогична навигации в Проводнике Windows:
- для просмотра элементов более низкого уровня для данного элемента воспользуйтесь двойным щелчком на этом элементе, либо щелчком левой клавишей мыши по знаку “плюс” слева от элемента;
- для сокрытия элементов более низкого уровня для данного элемента воспользуйтесь двойным щелчком на этом элементе, либо щелчком левой клавишей мыши по знаку “минус” слева от элемента;
- используя клавиши “вверх” и ”вниз”, перемещение по элементам будет происходить в том порядке, в котором они представлены в данный момент в списке просмотра.
Состав линейного списка в режиме иерархического справочника контекстно-зависим от текущего элемента в окне просмотра древовидной структуры справочника. Он содержит вложения более низкого уровня относительно текущего элемента древовидной структуры с учетом настроек фильтра. Те элементы, которые не являются листьями (конечными элементами), помечаются значком папки.
Выбор элемента справочника производится только из линейного списка, а не из окна представления древовидной структуры.
Работа с элементом “Поиск по вхождению” иерархического справочника аналогична работе соответствующего элемента при использовании линейного справочника. Однако существует несколько нюансов:
- при сортировке списка по полю, установленный режим сортировки будет сохраняться при изменении элемента в окне просмотра древовидной структуры и соответствующего обновления линейного списка;
- поиск элемента справочника производится только среди элементов, выбранных в линейном списке, а не по всему справочнику. Поиск по всем элементам справочника можно осуществлять в режиме линейного справочника.
Для перехода в линейный режим представления справочника выберите из элемента окна “Представления справочника” значение “Все строки” (см. п. “Элемент окна “Представления справочника” “). При этом элемент просмотра древовидной структуры справочника станет недоступным, а элемент просмотра линейного списка будет содержать все строки справочника с учетом настроек фильтра.