Методы для чтения данных из Semantic MDM

Выполнение поиска позиций

Возможны различные сценарии импорта, при которых необходимо выполнить поиск позиции по заданным атрибутам в справочнике Semantic MDM. Например, найти в классификаторе группу по коду или найти материал по марке и стандарту на материал и далее прописать сопоставление с найденной позицией в импортируемый объект.

Для реализации этих сценариев, в скрипт Groovy добавлены функции выполнения поиска позиции в заданной группе или в заданном классификаторе:

SearchParamsBuilder findInNode(String nodeUid) – выполнить поиск в заданной группе (nodeUid) и вернуть первые 100 позиций;
SearchParamsBuilder findInNodes(List<String> nodeUids) – выполнить поиск в заданном списке групп (nodeUids) и вернуть первый 100 позиций;
SearchParamsBuilder findInClassifier(String nodeUid) – выполнить поиск в заданной классификационной группе (nodeUid) классификатора и вернуть первые 100 позиций. Данный метод востребован, при необходимости выполнить поиск позиции, среди позиций, классифицированных группой отдельного классификатора, например, ОКВЭД2, ОКПД2, ЕКПС и т.д..

Данные функции возвращают построитель критериев поиска (SearchParamsBuilder) в котором можно с помощью функций byValue(String value, String propertyId) и byStatus(ItemStatus status) добавить параметры поиска и далее выполнить поиск с помощью функции Invoke(), которая вернет список Uuid позиций (List<String>), найденных в Semantic MDM. Каждая из функций: byValue и byStatus возвращает построитель запросов SearchParamsBuilder, дополненный критерием по значению атрибута (byValue) или статуса (byStatus) соответственно, что позволяет путем последовательного вызова этих функций сформировать требуемый поисковый запрос и выполнить его. Примеры вызова представлены ниже.

Пример поиска страны в классификаторе ОКСМ по наименованию и статусу “Нормализована” :

List<String> itemUids = support.findInNode("55805ab0-15cd-4523-9fc2-f926fcf3b376").byValue("РОССИЯ" , @[Наименование ОКСМ].toPath()).byStatus(ItemStatus.Standardized).invoke();

Пример поиска в справочнике материалов по марке материала, стандарту на материал и статусу “Нормализована”:

List<String> itemUids = support.findInNode("2003b902-7bee-49d5-9401-02fb79e1d6e9").byValue("Ст3кп", @[Марка материала].toPath()).byValue("ГОСТ 380-94", @[Стандарт на материал][Сокращенное наименование].toPath()).byStatus(ItemStatus.Standardized).invoke();

Чтение данных о позиции

В сценариях импорта, могут встречаться задачи получения текущего статуса позиции, получения идентификатора внешней системы или идентификатора Semantic MDM из переходного ключа, а также получения информации о группе. Пример сценария импорта: получить по идентификатору внешней системы идентификатор позиции Semantic MDM, проверить статус связанной позиции в Semantic MDM и если он соответствует статусу “Заблокирована”, “Удалена”, “Дубликат”, то отменить импорт и вернуть ошибку, в противном случае, выполнить импорт по штатному алгоритму.

Для решения этих задач, в скрипте Groovy, в специальной переменной support предусмотрены следующие функции:

ItemStatus getItemStatus(String itemUid) – получить статус позиции по GUID (ItemUid) позиции. Функция вернет одно из следующих значений:
NULL - если позиция с переданным itemUid не существует
ItemStatus.Abnormal – соответствует статусу “Не нормализована”;
ItemStatus.Standardized – соответствует статусу “Нормализована”;
ItemStatus.Blocked – соответствует статусу “Заблокирована”;
ItemStatus.Removed – соответствует статусу “Удалёна”;
ItemStatus.Duplicate – соответстует статусу “Дубликат”.
String getMDMId(String sourceId, String systemId) – получить GUID позиции по идентификатору объекта (sourceId) во внешней системе и идентификатору внешней системы (systemId). Вернет NULL если переходной ключ отсутствует.
String getSourceId(String itemUid, String systemId) – получить идентификатор объекта во внешней системе по GUID позиции (itemUid) и идентификатору внешней системы (systemId). Если переходной ключ отсутствует, то вернет NULL.
String getItemNodeUid(String itemUid) – получить GUID группы, которой принадлежит позиция с указанным GUID (itemUid). Если позиция с переданным GUID не существует, то будет возвращена ошибка.

Пример получения GUID позиции для импортируемого объекта:

String itemUid = support.getMDMId(root.getSourceId(), root.getExternalSystemId())

Чтение значений атрибутов позиции

Для чтения значений атрибутов позиции, необходимо использовать следующий метод:

List<PropertyValueDto> getItemPropertyValues(String itemUid) – получить список значений атрибутов позиции с GUID itemUid. Если атрибут содержит множественные значения, то для каждого значения будет возвращен свой PropertyValueDto, с одинаковым PropertyValueDto.propertyId.

Свойства PropertyValueDto:
String itemUid – идентификатор позиции;
long propertyId – числовой идентификатор атрибута;
String stringValue – содержит строковое значение атрибута, если тип данных: String или Text. Содержит GUID позиции, если тип данных Aggregation или Composition;
ExchangeComplexDouble doubleValue – содержит число с плавающей запятой, если тип данных: Double;
long integerValue – содержит целое число, если тип данных Int;
ExchangeFile fileValue – содержит наименование файла и хэш содержимого. Если тип данных Image, то наименование файла будет пустым.

Свойства ExchangeFile:
name – наименование файла, для изображения не указывается;
bodyHash – хэш тела файла;
Boolean booleanValue – содержит булево значение, если тип данных Bool;
Date dateValue – содержит дату, если тип данных DateTime;
String nameValue – содержит наименование контекста для контекстных значений атрибута;
List<PropertyValueDto> getItemsPropertyValueList(List<String> itemUids, List<long> PropertyIds) – получить список значений для атрибутов указанных в PropertyIds и позиций указанных в itemUids. Если PropertyIds содержит пустой список, то будут возвращены значения всех атрибутов. Для каждого PropertyValueDto в свойстве itemUid будет указан guid позиции, к которому относится возвращенное значение атрибута. Если атрибут содержит множественные значения, то для каждого значения будет возвращен свой PropertyValueDto, с одинаковым PropertyValueDto.propertyId и одинаковым PropertyValueDto.itemUid.

Метод getItemPropertyValues возвращает список всех значений атрибутов для заданной позиции (itemUid). Для чтения значений конкретного атрибута из полученного списка, необходимо знать идентификатор и тип данных атрибута, а также множественное у него значение или нет. Для получения этой информации в скрипте, необходимо использовать метод getPropertyDeclarationsByNodeUid (подпункт “Чтение данных по атрибутам из Semantic MDM”).

Ниже представлены примеры чтения значений атрибутов.

Пример чтения значений атрибутов: “Наименование изделия”, “Диаметр”, “Материал->Марка материала”:

List<PropertyValueDto> itemValues = support.getItemPropertyValues("a1ddfe35-6fca-4f25-b874-604d082d9d3c");

//Получим значение атрибута "Наименование изделия"

PropertyValueDto attrValue = itemValues.find {element -> element. propertyId==@[Наименование изделия].toId()};

if (attrValue!=null)

{String prodName = attrValue.stringValue}

//Получим значение атрибута "Диаметр" в миллиметрах

attrValue = itemValues.find {element -> element. propertyId==@[Диаметр].toId()};

If (attrValue!=null)

//Получим диаметр в миллиметрах

{Double prodDiam = doubleValue.getValue().value/1000}

//Получим значение атрибута "Материал->Марка материала" в миллиметрах

attrValue = itemValues.find {element -> element. propertyId==@[Материал].toId()};

if (attrValue!=null)

{

prodMatUid = attrValue.stringValue;

List<PropertyValueDto> MaterialValues = support.getItemPropertyValues(prodMatUid);

attrValue = itemValues.find {element -> element. propertyId==@[Марка материала].toId()};

if (attrValue!=null)

{String prodMatMark = attrValue.stringValue}

}

Пример получения списка гуидов позиций из множественного атрибута “Логистические ЕИ”:

List<PropertyValueDto> itemValues = support.getItemPropertyValues("a1ddfe35-6fca-4f25-b874-604d082d9d3c");

List<PropertyValueDto> attrValues = itemValues.findAll {element -> element. propertyId==@[Логистические ЕИ].toId()};

List<String> itemGuids = attrValues.collect {element -> return element.stringValue };

Чтение данных по атрибутам из Semantic MDM

PropertyInfoDto getPropertyInfoByUid(String propertyUid) – получить информацию об атрибуте по GUID атрибута Semantic MDM. Если атрибут с заданным PropertyUid не существует, то функция вернет NULL.

Свойства PropertyInfoDto:
long id – числовой идентификатор атрибута;
String uuid – GUID атрибута;
String eOTDid – идентификатор OTD;
dataType – тип данных атрибута:
PropertyDataType.String – строка;
PropertyDataType.Double – число с плав. запятой;
PropertyDataType.Int – целое число;
PropertyDataType.Bool – булев;
PropertyDataType.Image – картинка;
PropertyDataType.Text – текст;
PropertyDataType.DateTime – дата;
PropertyDataType.Colour – цвет;
PropertyDataType.File – файл;
PropertyDataType.Formula – формула;
PropertyDataType.Aggregation – агрегация;
PropertyDataType.Composition – композиция;
Map<String, String> names – возвращается карта “Идентификатор языка” – “Наименование атрибута”. Наименование на русском языке всегда должно быть первым. Идентификаторы языка: ru_RU – русский, en_US – английский;
Map<String, String> aggregateNames – для атрибута связи возвращается карта “Идентификатор языка” – “Обратное наименование атрибута”. Наименование на русском языке всегда должно быть первым. Идентификаторы языка: ru_RU – русский, en_US – английский;
String comment – описание атрибута;
String sourceDocument – значение свойства “Источник (документ)”;
boolean isMultiple – флаг Массив;
boolean isHierarchical – флаг Иерархический;
boolean isContextual – флаг контекстного атрибута;
List<PropertyInfoDto> getPropertyInfoByUidList(List<String> propertyUids) – получить информацию по заданному списку атрибутов. Если один из атрибутов с заданным PropertyUid не существует, то функция не вернет информации по данному атрибуту.
PropertyInfoDto getPropertyInfoByOtdId(String propertyOtdId) – получить информацию об атрибуте по идентификатору OTD атрибута Semantic MDM. Если атрибут с заданным propertyOtdId не существует, то функция вернет NULL.
List<PropertyInfoDto> getPropertyInfoByOtdIdList (List<String> propertyOtdIds) – получить информацию по заданному списку атрибутов. Если один из атрибутов с заданным PropertyOtdId не существует, то функция не вернет информации по данному атрибуту.
PropertyInfoDto getPropertyInfoById(Long propertyId) – получить информацию об атрибуте по числовому идентификатору атрибута Semantic MDM. Если атрибут с заданным PropertyId не существует, то функция вернет ошибку.
List<PropertyInfoDto> getPropertyInfoByIdList (List< Long> propertyIds) – получить информацию по заданному списку атрибутов. Если один из атрибутов с заданным PropertyId не существует, то функция вернет ошибку.
List<PropertyDeclarationInfoDto> getPropertyDeclarationsByNodeUid(String nodeUid, boolean resolveMultilinguals) – получить список деклараций для группы с указанным GUID (nodeUid). Флаг resolveMultilinguals определяет необходимость получения данных о мультиязычных наименованиях в PropertyInfoDto.Names, PropertyInfoDto.aggregateNames, PropertyDeclarationInfoDto.categories.

Свойства PropertyDeclarationInfoDto:
List<String> scopeNodes – список GUID групп, на позиции которых может ссылаться агрегация/композиция (PropertyDeclarationInfoDto.dataType равен Aggregation или Composition)
Map<String, String> categories – возвращается карта “Идентификатор языка” – “Наименование категории”. Наименование на русском языке всегда должно быть первым. Идентификаторы языка: ru_RU – русский, en_US – английский;
long id – числовой идентификатор атрибута;
String uuid – GUID атрибута;
String eOTDid – идентификатор OTD;
PropertyDataType dataType – тип данных атрибута:
PropertyDataType.String – строка;
PropertyDataType.Double – число с плав. запятой;
PropertyDataType.Int – целое число;
PropertyDataType.Bool – булев;
PropertyDataType.Image – картинка;
PropertyDataType.Text – текст;
PropertyDataType.DateTime – дата;
PropertyDataType.Colour – цвет;
PropertyDataType.File – файл;
PropertyDataType.Formula – формула;
PropertyDataType.Aggregation – агрегация;
PropertyDataType.Composition – композиция;
Map<String, String> Names – возвращается карта “Идентификатор языка” – “Наименование атрибута”. Наименование на русском языке всегда должно быть первым. Идентификаторы языка: ru_RU – русский, en_US – английский;
Map<String, String> aggregateNames – для атрибута связи возвращается карта “Идентификатор языка” – “Обратное наименование атрибута”. Наименование на русском языке всегда должно быть первым. Идентификаторы языка: ru_RU – русский, en_US – английский;
String comment– описание атрибута;
String sourceDocument – массив значений “Источник (документ)”;
boolean isMultiple – флаг Массив;
boolean isHierarchical – флаг Иерархический.

Чтение данных по группам из Semantic MDM

ClassifiableElementInfoDto getNodeInfo(String NodeUid, Boolean fetchParents) – получить информацию о группе по ее GUID (NodeUid) Semantic MDM. Флаг fetchParents позволяет вернуть информацию по всем родительским группам. Если группа с заданным NodeUid не существует, то функция вернет NULL

Свойства ClassifiableElementInfoDto:
Long id – числовой идентификатор группы;
String uid – GUID группы;
String displayName – наименование группы;
List<ClassifiableElementDto> parents – список родительских групп, первой идет корневая группа, последней идет родительская группа для указанной группы (NodeUid).