Создание таблицы соответствий

В системе новую таблицу соответствий можно создать следующими способами:

  • добавить ее в системном справочнике "Таблицы соответствий";
  • загрузить/выгрузить из файлов конфигурации;
  • загрузить/выгрузить из метаинформации.

Создание таблицы соответствий в системном справочнике "Таблицы соответствий"

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

Место настройки в интерфейсе: Меню навигации "Справочники" → "Системные справочники" → название справочника "Таблицы соответствий".

Подробное описание справочника приведено в разделе Справочник "Таблицы соответствий".

Чтобы добавить таблицу соответствий, в блоке "Элементы справочника" нажмите кнопку Добавить элемент, заполните поля на форме добавления и нажмите кнопку "Сохранить". В карточке справочника "Таблицы соответствий" отобразится новый элемент.

Поля на форме добавления таблицы соответствий:

  • Название — введите название таблицы соответствий.
  • Код — введите код элемента, уникальный в пределах справочника.
  • Родитель — выберите папку справочника, в которую вложен данный элемент.

  • Объекты — выберите класс объектов или несколько типов в рамках одного класса, для которых настраивается таблица соответствия.

    От выбранного класса зависят списки определяемых и определяющих атрибутов. Если выбрано несколько типов, то в списках отображаются атрибуты, общие для выбранных типов.

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

    Определяемый атрибут — атрибут, значение которого вычисляется по таблице соответствий.

    Для выбора доступны:

    • системные атрибуты классов;
    • пользовательские атрибуты всех типов, кроме "Обратная ссылка", "Счетчик времени", "Счетчик времени (обратный)", "Файл" и атрибутов с признаком "Составной". Агрегирующий атрибут может быть определяемым только целиком, его составные части в качестве определяемых атрибутов не используются.

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

    В списке с двумя частями доступно перемещение Drag and drop из одной части списка в другую.

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

  • Определяющие атрибуты — выберите один или несколько атрибутов объекта, значение которых будет влиять на значение определяемых атрибутов.

    Определяющий атрибут — атрибут, значение которого влияет на значение определяемого атрибута. Один набор определяющих атрибутов может использоваться для определения значения нескольких определяемых атрибутов.

    Для выбора доступны: системные и пользовательские атрибуты всех типов, кроме "Вещественное число", "Временной интервал", "Гиперссылка", "Дата", "Дата/время", "Строка", "Счетчик времени", "Счетчик времени (обратный)", "Текст", "Текст в формате RTF" и "Файл".

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

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

    В списке с двумя частями доступно перемещение Drag and drop из одной части списка в другую.

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

  • Описание — введите описание таблицы соответствий.

Загрузка/выгрузка таблицы соответствий из файлов конфигурации

Место настройки в интерфейсе: Меню навигации "Справочники" → "Системные справочники" → название справочника "Таблицы соответствий".

Загрузка таблицы соответствий из файлов конфигурации

В справочнике "Таблицы соответствий" предоставляется возможность загружать таблицы соответствий из файла конфигурации импорта.

Чтобы выполнить загрузку таблицы соответствий, выполните следующие действия:

  1. Перейдите на форму загрузки таблицы соответствий одним из способов:

    • на карточке справочника "Таблицы соответствий" в блоке "Элементы справочника" нажмите кнопку Загрузить.

    • на карточке таблицы соответствий в блоке "Свойства" нажмите кнопку Загрузить.

  2. Заполните поля на форме загрузки:

    • Файл — выберите файл в формате .csv или zip архив из двух файлов: файл в формате .csv с элементами таблицы и файл в формате .xml с конфигурацией импорта.

      Если форма загрузки вызвана с карточки справочника, то название файла в формате .csv должно совпадать с названием файла в формате .xml. Если форма загрузки вызвана с карточки таблицы соответствий, то проверка на совпадение названий файлов не выполняется.

    • Заменить настройки таблицы соответствий — признак, определяющий параметры загрузки:

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

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

      • флажок снят — элементы таблицы соответствий будут дополнены элементами из файла, если совпадают свойства таблицы: объекты, родитель, определяемые и определяющие атрибуты.

  3. Нажмите кнопку Сохранить.

Выгрузка таблицы соответствий в файлы конфигурации

Чтобы выгрузить таблицу соответствий в файл, выполните одно из действий:

  • на карточке справочника "Таблицы соответствий" в блоке "Элементы справочника" в строке таблицы соответствий нажмите иконку .

  • на карточке таблицы соответствий в блоке "Свойства" нажмите кнопку Выгрузить.

Файл автоматически сформируется и сохранится в директории загрузок браузера.

Выгружаемый файл представляет собой zip архив, состоящий из:

  • файла в формате .csv с элементами таблицы соответствий, название файла соответствует коду таблицы, порядок атрибутов соответствует их порядку в системе;
  • файла в формате .xml с конфигурациями импорта, название файла соответствует коду таблицы.

При выгрузке таблицы соответствий в файл выполняется проверка на совпадение текущей конфигурации импорта с выгружаемой конфигурацией:

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

Загрузка/выгрузка таблиц соответствий из метаинформации

Место настройки в интерфейсе: Меню навигации "Настройка системы" → настройка "Администрирование" → вкладка "Управление системой".

Подробное описание загрузки настроек системы (метаинформации) приведено в разделе Выгрузка и перенос настроек системы (метаинформации).

Свойства таблицы соответствий попадают в файл метаинформации при полной и частичной выгрузке метаинформации.

Описание правил загрузки таблиц соответствий

При загрузке метаинформации относительно таблиц соответствий выполняются следующие правила:

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

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

  • При создании новой таблицы соответствий заполняются только свойства таблицы соответствий: название, код, родитель, объекты, описание, определяемые и определяющие атрибуты. Правила определения атрибутов и правила импорта не добавляются.
  • Если при загрузке метаинформации таблица соответствий пропускается, то после загрузки отображается сообщение, что метаинформация загружена с замечаниями, которые были зафиксированы в логе приложения.
  • Если при создании таблицы соответствий при загрузке метаинформации на стенде не найдены объекты, то в лог приложения записывается ошибка, что атрибут с таким кодом не найден, и таблица соответствий не загружается.
  • Если с метаинформацией загружена новая таблица соответствий, то у нее правило импорта не создается.