Вкладка Обменные классы содержит список справочных групп, позиции которых будут передаваться во внешние или из внешних ИС. Один и тот же обменный класс может участвовать в процессе репликации с несколькими ИС. В таблице обменных классов разрешена сортировка по столбцам, а также фасетный поиск везде, кроме колонок Наименование и Идентификатор. Для фильтрации по статусу может быть использована строка с интерактивными статусами.
Для добавления нового обменного класса необходимо:
перейти на вкладку Обменные классы представления Импорт и репликация;
нажать кнопку Добавить, расположенную справа или вызвать аналогичную команду из контекстного меню;
Вид вкладки обменных классов
перейти в карточку обменного класса и заполнить Общие параметры:
Наименование – название обменного класса;
Идентификатор – условное или сокращённое обозначение обменного класса. Длина строки 255 символов. Запись регистрозависима. Может содержат любые буквы, цифры и символы Unicode;
Статус – принимает три возможных значения, выбирающихся из выпадающего списка. Остановлен – изменения, выполняемые в Semantic MDM, игнорируются. Приостановлен – изменения, выполняемые в Semantic MDM, накапливаются и будут обработаны, как только будет включён статус Выполняется. Выполняется – обработка изменений выполняется в онлайн режиме. Статус может быть определён для каждого класса и / или для внешней ИС, связанной с ним;
Формула на экспорт – содержит формулу, представляющую собой скрипт Groovy, написанный в специальном редакторе. Формула определяет алгоритм экспорта данного класса во внешнюю ИС;
Формула на экспорт позиции в виде скрипта Groovy
В настройках условий экспорта есть возможность проверки наличия переходного ключа с для атрибутов с обратной композицией. Например, можно настроить экспорт композируемых логистических ЕИ, если родительская позиция номенклатуры имеет переходной ключ с этой же ИС
Формула на импорт – содержит формулу, представляющую собой скрипт Groovy, написанный в специальном редакторе (см. п. «Описание редактора формул»). Формула определяет порядок импорта данного класса в SemanticMDM;
При выполнении импорта через формулу можно реализовать изменение переходного ключа, например, "перенос" переходного ключа одной позиции к другой. При этом у "старой" позиции автоматически будет включен режим удаления переходного ключа.
Создавать новую позицию в группе – из выпадающего списка или в дереве справочников выбирается справочник или ветка справочника, куда будут записываться новые позиции при импорте;
Автоматическая установка статуса "Нормализована" – установка данного маркера позволяет присваивать всем импортируемым позициям данного класса статус Нормализована в справочнике Semantic MDM. Если маркер не установлен все записи получают статус Не нормализована;
Режим удаления переходного ключа – определяет порядок удаления позиции:
Удалить позицию, если переходные ключи отсутствуют – позицию разрешено удалить, если у неё нет ни одного переходного ключа с внешними ИС;
Удалять позицию, если у позиции установлен статус «Не нормализована» и отсутствуют переходные ключи;
Удалять позицию, если отсутствуют переходные ключи, в противном случае установить статус «Заблокировано»;
Ничего не делать с позицией при удалении переходного ключа;
Включить экспорт исторических данных – опция, позволяющая передавать (экспортировать) даты начала и окончания действия позиции, а также исторические значения атрибутов;
Группы – список справочных групп, входящих в данный обменный класс, которые выбираются в окне Группы, вызываемом кнопкой Выбрать, расположенной в правой части ячейки;
Выбор справочных групп для обменного класса
Режим экспорта/импорта – настройка передаваемых атрибутов. Существует три режима:
Полный – будут реплицированы все атрибуты, описывающие позиции группы, кроме атрибутов, указанных в списке Неэкспортируемые атрибуты;
Выборочный – будут реплицированы только те атрибуты, которые указаны в списке Сопоставление атрибутов.
Сопоставление атрибутов – сопоставление атрибутов обменного класса и Semantic MDM и установление порядка их выгрузки. Используется только для установленного режима экспорта / импорта - Выборочный. Выполняется настройка соответствия (маппинг) атрибутов Semantic MDM и атрибутов внешней ИС, с которой выполняется обмен данными. В левом столбце указываются наименования атрибутов во внешней ИС, а в правом - их наименования в Semantic MDM. Для любого атрибута дополнительно могут быть заданы формулы условий выполнения экспорта / импорта значений, а также:
для сопоставленных атрибутов может быть установлена опция Отслеживать изменения. Включение данной опции означает, что подсистема импорта и репликации должна отслеживать изменение значения данного атрибута и, если оно изменилось, то сообщение будет переформировано и отправлено во внешнюю ИС;
Настройка отслеживания изменений и определение режима импорта
для простого атрибута обменного класса из выпадающего списка выбирается значение параметра Режим импорта:
Использовать только для поиска – значение атрибута должно использоваться только для сопоставления позиций через поиск дубликатов и не должно изменять значение атрибута в позиции;
Записать только при создании позиции – значение атрибута должно использоваться для сопоставления позиций через поиск дубликатов и должно быть записано в позицию, если позиция в системе была создана через импорт;
Записать если значение отсутствует – значение атрибута должно использоваться для сопоставления позиций через поиск дубликатов и должно быть записано в позицию, если атрибут позиции в системе имеет пустое значение;
Записать безусловно – значение по умолчанию для всех атрибутов обменного класса. Реализует поведение системы, при котором значение атрибута в сообщении импорта используется для поиска и записи в атрибут позиции в системе;
для множественных атрибутов связи значения параметра Режим импорта следующие:
Синхронизация значений по переходным ключам – синхронизация агрегаций / композиций выполняется по переходным ключам. В сообщении импорта для атрибута связи типа агрегация/композиция содержится информация о новом актуальном списке переходных ключей с текущей ИС, который синхронизируется со списком переходных ключей этой ИС в изменяемой через импорт позиции. Из сообщения импорта будут добавлены агрегации / композиции с новыми переходными ключами, а агрегации / композиции c совпадающими переходными ключами останутся неизменными. Агрегации/композиции записи с отсутствующими переходными ключами в сообщении импорта будут удалены. Для правильной обработки прямой множественной агрегации/композиции требуются переходные ключи, полученные от внешней ИС или вписанные в скрипт обработки, в противном случае список агрегаций-композиций в позиции будет лишь сопоставляться/пополняться во время обработки нового входящего сообщения, но удаление выполнено не будет;
Полная синхронизация значений – выполняется полная синхронизация агрегаций / композиций. Все агрегации / композиции несопоставленные через переходной ключ (или GUID) или поиск дубликатов будут добавлены в Систему, агрегации/композиции сопоставленные через переходной ключ (или GUID) или поиск дубликатов сохраняются, а отсутствующие в сообщении импорта агрегации/композиции удаляются из изменяемую через импорт позицию;
для атрибута обменного класса, связанного с атрибутом-связи позиции присутствует параметр настройки Отслеживать изменения во вложенных позициях, который позволяет определить изменение какой информации требуется отслеживать подсистеме импорта и репликации. Применяются следующие режимы отслеживания изменений по вложенным (агрегируемым / композируемым) позициям:
Настройка отслеживания изменений по агрегируемым / композируемым позициям
Не отслеживать изменения – не требуется отслеживать изменения значений атрибутов и переходных ключей у агрегируемых / композируемых позиций;
Отслеживать изменение атрибутов – требуется отслеживать изменение значений атрибутов агрегируемых / композируемых позиций через данный атрибут связи;
Отслеживать изменение переходных ключей с текущей системой – требуется отслеживать только изменение переходных ключей агрегируемых / композируемых позиций с текущей системой через данный атрибут связи;
Отслеживать изменение переходных ключей c любой системой – требуется отслеживать только изменение переходных ключей агрегируемых / композируемых позиций с любой системой через данный атрибут-связи;
Отслеживать изменение атрибутов и переходных ключей – требуется отслеживать все изменения по агрегируемым / композируемым позициям через данный атрибут-связи.
Настройки параметров атрибутов обменного класса в сопоставлении атрибутов можно изменить в скрипте экспорта обменного класса и скрипте экспорта атрибута обменного класса.
Совместимости - перечень типов совместимостей объектов НСИ, которые следует передавать во / из внешних ИС. Возможна выгрузка настроенных на справочных группах совместимостей по умолчанию (маркер - настроенные в группах обменного класса);
Выбор типов совместимостей, которые будут выгружаться в обменный класс
Управление заявками:
Создать заявку на "Нормализацию"– опция, которая позволяет автоматически создавать заявки на нормализацию при получении (импорте) записей из внешней ИС;
Создать заявку на "Изменение" – опция, которая позволяет автоматически создавать заявки на изменение позиции при получении (импорте) записей из внешней ИС.
Создать заявку на "Консолидацию" – опция, которая позволяет автоматически создавать заявки на консолидацию позиций справочника с позициями, полученными (импортированными) из внешней ИС
Доступ к настройке заявок на "Нормализацию", "Изменение" и "Консолидацию"
В скрипте обменного класса на импорт можно включать/отключать требование создание заявки на нормализацию, изменение, консолидацию.
Также через скрипт можно задать логин заявителя, от имени которого будет создана заявка при обработке сообщения импорта, по которому такую заявку требуется создать.
Далее следует установить связь созданного обменного класса с требуемыми внешними ИС. Эта процедура может быть проведена как со стороны обменного класса, так и со стороны ИС на вкладке Внешние системы.
