Мастер настройки справочника

Мастер настройки справочника позволяет создать или обновить данные блока "Справочник".

Открытие мастера

Открыть мастер можно несколькими методами:

1. Открытие мастера через верхнее меню:
2. На верхней панели управления щелкнуть по иконке справочника:
   
3. В открывшимся меню выбрать справочник для редактирования, либо переключить флаг "Создать новый справочник" для создания нового справочника, после чего нажать на кнопку "Далее":
   
4. Открытие мастера через настройки блока:
5. Открыть настройки блока и выбрать там пункт "Мастер":
   
6. Перетаскивание нового блока на граф (drag-n-drop):
7. В библиотеке блоков найти блок "Справочник";
8. Зажать левую кнопку мыши и перетащить блок на граф:
   

Окно работы мастера

• Соединение с БД - выбор базы данных из блоков-соединений, которые есть на графе.
• Наименование - наименование блока.
• Наименование таблицы - наименование таблицы, которая будет создана в базе данных.
• Владение таблицей - флаг, позволяющий редактировать таблицу: добавлять, обновлять или удалять столбцы в таблице.
  • По умолчанию включен для всех новых таблиц (если таблица с таким наименованием не найдена в базе данных).
  • У всех скопированных справочников данный флаг отключен, пока существует справочник родитель. Если исходный справочник был удален, то появляется возможность включить данный флаг.

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

• Элементы имеют иерархию - флаг, добавляющий в таблицу системные атрибуты для работы с иерархическим справочником.

• Элементы могут изменяться во времени - флаг, добавляющий в таблицу системные атрибуты для возможности работы с версионностью данных.

  Функционал не используется в текущей версии приложения.

• Элементы имеют права доступа - флаг, добавляющий в таблицу системные атрибуты для разделения прав доступа к таблице.

  Функционал не используется в текущей версии приложения.

• Атрибуты - список всех атрибутов справочника. Совпадает с полями таблицы в базе данных.

  • Редактирование доступно при включенном флаге "Владение таблицей".

  • По умолчанию, в каждом справочнике присутствуют три системных атрибута:

    • Ключ, поле в таблице ID - уникальный идентификатор записи.
    • Наименование, поле в таблице NAME - наименование элемента.
    • Порядок, поле в таблице ORD - порядок сортировки элементов.

    За порядок сортировки данных всегда отвечает это поле. Возможности изменения способа сортировки нет.

Не рекомендуется изменять или удалять системные атрибуты. Без них, корректная работа блока будет невозможна.

Редактирование атрибутов блока

При редактировании атрибутов блока так же редактируются поля в таблице в базе данных.

• Для добавления нового атрибута необходимо нажать знак "+", справа от надписи "Атрибуты":

• Для редактирования атрибута необходимо нажать на три вертикальные точки, справа от наименования атрибута:

После нажатия на добавление или редактирование атрибутов, откроется окно с настройками атрибута.

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

• Имя - наименование атрибута, которое будет использоваться для наименования столбца в мастере данных блока.
• Идентификатор - ключ атрибута, по которому он будет доступен в таблице в базе данных.

Формат наименования может различаться, в зависимости от выбранной базы данных, но в общем случае рекомендуется использовать латинские буквы (a-Z), цифры (0-9) и знак подчеркивания (_).

• Тип - тип атрибута, возможные значения:
  • Строка - строковый тип данных;
  • Дата - значение даны. При выборе этого типа появляются дополнительные настройки:
    • Значение по умолчанию - значение даты по умолчанию;
    • Маска - маска даты для отображения в данных;
    • Динамика - динамика даты;
  • Целочисленный - целое число;
  • Вещественный - вещественное число;
  • Координаты - строковый тип данных, заточенный для распознования координат;
  • JSON - строковый тип данных, в котором хранятся значения в формате JSON;
  • Справочник - возможность связывания одного справочника с другими. В качестве ключа используется поле ID.
• Элементы с пустыми значениями - возможность сохранять атрибут без введеных значений;
• Элементы с множественными значениями - возможность записывать несколько значений в один атрибут;

Функционал не используется в текущей версии приложения.

• Ленивая загрузка полей - флаг, позволяющий при расчете блока произвести "ленивую загрузку" - сохранить в системную таблицу, а вместо значения прописать уникальный идентификатор поля;

Не все блоки могут преобразовать "ленивую загрузку" обратно в значение.

• Входит в уникальный ключ - флаг, отвечающий за вхождение поля в уникальный ключ таблицы (и в первичных ключ объектов);
• Write-back - возможность изменения значения поля при использовании механизма write-back (изменение и сохранение данных).