В прошлой статье про маппинг я показывал, как через Python-маппинг передать из верхнеуровневых сущностей параметры в элементы которые располагаются ниже и являются их детьми. Например, получить тип прокладки, отметку или тип системы и записать их в нужные параметры IFC.

Теперь давайте поднимемся ещё на один уровень и заберём информацию с самой модели из Атрибутов

В Robur у моделей есть окно «Атрибуты» с вкладками «Штамп» и «Пользовательские».

В нём можно заполнить общие данные: код объекта, раздел, ответственного или любой свой параметр. Задача - передать эти значения во вложенные элементы при экспорте, чтобы не заполнять одну и ту же информацию.

Сначала определимся с задачей

Давайте представим обычную ситуацию. У нас есть модель наружных инженерных сетей, и во все её элементы надо передать код объекта и фамилию ответственного. Данные общие для всей модели, но в IFC они должны находиться внутри каждого нужного элемента.


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


Для этого не нужно создавать копии библиотечных элементов под каждый объект или заполнять общие свойства по одному. Мы добавим в стандартный Python-маппинг две небольшие функции, а правила передачи напишем через уже знакомые `filter` и `flush`

Заполняем атрибуты именно модели

В структуре проекта выберите нужную модель (или свойства папки- Атрибуты, свойства из папки перейдут во вложенные модели), откройте «Атрибуты» → «Пользовательские» и добавьте, например, такие параметры:

Здесь важно разделять две колонки.

«Имя» - это имя, по которому мы будем получать свойство в маппинге.

«Название» - его отображаемая подпись.


Если в колонке «Имя» указано newTag1, в коде тоже пишем newTag1, сохраняя регистр.

В этих атрибутах мы работаем с обычными строковыми значениями. Функция просто получит строку и передаст её дальше.

Аналогично можно использовать атрибуты штампа: нужно знать их действительное имя. Для начала удобнее проверить подход на одном собственном параметре, имя которого вы задали сами.

Открываем Python-файл маппинга

Для Robur Pipes 16.0 стандартные маппинги находятся в каталоге:

C:\ProgramData\Topomatic\Robur Pipes\16.0\Support\ifc

В другом модуле или версии Robur путь будет соответствовать установленному продукту.


Будем работать с копией маппинга в своей папке. Если используется пара `.py` и `.xml`, скопируйте оба файла. При переименовании у них должна оставаться одинаковая основа имени, например `MyMapping.py` и `MyMapping.xml`.


Примеры ниже рассчитаны на стандартный шаблон маппинга с функциями `get_property`, `filter`, `flush` и `process_custom`, который мы создавали с вами в прошлый раз.

Добавляем две функции для чтения модели

Найдите в `.py` функцию `def process_custom(group):`. Перед ней, вне других функций, вставьте следующий блок

def find_model(group):
	current = group
	while current is not None:
		object_type = current.GetObjectType()
		if object_type is not None and object_type.IsAssignableTo("SmdxModel"):
			return current
		current = current.Parent
	return None

def get_from_model(group, tag):
	model = find_model(group)
	if model is None:
		return None
	prop = get_property(model, tag)
	return prop.Value if prop is not None else None

Рассказываю, что здесь происходит.

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


Почему это важно? Одноимённое свойство может быть и у элемента, и у сегмента. Нам нужно значение именно модели, поэтому сначала находим модель, а уже потом читаем её атрибут.


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


Например, вызов:

get_from_model(group, "newTag1")

вернёт Моё значение, если такое значение записано в атрибуте newTag1 модели текущего элемента.


В сводной SDMX-модели это тоже имеет значение: элементы каждой исходной модели будут получать данные из своего ближайшего узла модели

Описываем, какие параметры передавать

Сразу после этих двух функций, но всё ещё перед process_custom, добавим правила:

def process_model_attributes(group):
	model = find_model(group)
	if model is None or model == group:
		return


	if filter(group, "$name*"):
		flush(group, [
			# IFC-атрибут                 # функция-источника     # имя атрибута модели
			["Экспертиза|Код объекта",  get_from_model(group, "newTag1")],
			["Экспертиза|Раздел",  get_from_model(group, "SectionCode")],
			["Экспертиза|Ответственный",  get_from_model(group, "Responsible")],
		])

Разбираем строку:

["Экспертиза|Код объекта",  get_from_model(group, "newTag1")],

Экспертиза|Код объекта - имя будущего свойства в IFC. До вертикальной черты указан набор свойств, после неё — название параметра внутри этого набора.


get_from_model(group, "newTag1") - источник значения. Берём строку из атрибута newTag1 своей модели.


В результате внутри подходящего элемента появится набор Экспертиза, а в нём параметр Код объекта со значением Моё значение.


Фильтр $name* проверяет наличие имени. Это широкий фильтр: под него могут попасть не только отдельные физические элементы, но и именованные группы. Начальная проверка в функции пропускает сам узел модели и объекты вне модели. Если нужны только определённые виды элементов, дальше покажу, как сузить правило.

Подключаем правила к обработке

Теперь находим существующую функцию process_custom и добавляем в её начало один вызов:

def process_custom(group):
	process_model_attributes(group)
	return False

Так будет выглядеть функция, если до этого она была пустой.


Если в ней уже есть ваши условия для труб, кабелей, отметок или других параметров, сохраняйте их. Добавьте только строку process_model_attributes(group) в начало, перед этими условиями.


Не создавайте вторую функцию с тем же именем. Новое определение process_custom заменит прежнее, и старые правила перестанут вызываться.


return False оставляем: в этом стандартном шаблоне после пользовательской обработки выполнятся также правила из соседнего XML-файла.

А если разным элементам нужны разные значения?

Здесь мы используем вашу обычную систему фильтрации. Например, в одной модели есть трубы и кабели. Для них нужно заполнить одинаковый IFC-параметр «Код», но взять разные строки из атрибутов модели.

  • Имя PipeCode и CableCode
  • Значения соответсвующие К1 и ЭС


Заменяем предыдущую функцию process_model_attributes на этот вариант:


def process_model_attributes(group):
	model = find_model(group)
	if model is None or model == group:
		return


	if filter(group, "$type_4 = SmdxNetworksPipe"):
		flush(group, [
			# IFC-атрибут                 # функция-источника     # имя атрибута модели
			["Экспертиза|Код",  get_from_model(group, "PipeCode")],
		])


	if filter(group, "$type_4 = SmdxNetworksWire"):
		flush(group, [
			# IFC-атрибут                 # функция-источника     # имя атрибута модели
			["Экспертиза|Код",  get_from_model(group, "CableCode")],
		])

Что получаем: у труб «Экспертиза - Код» будет равен К1, у кабелей - ЭС. Оба значения хранятся на модели, но каждому виду элементов передаётся своя строка.


Это примеры фильтров для инженерных сетей. Для своих элементов используйте их реальные Smdx-типы и привычные запросы из вашего маппинга. Число в $type_4 относится к уровню типа, поэтому для другого типа нельзя механически менять только его название.


В каждом flush можно передавать несколько параметров. Можно также сочетать общий блок для всех элементов и отдельные блоки для определённых видов.


Следите только за повторной записью одного свойства. Если элемент подходит под несколько условий и они записывают одно и то же `Набор|Свойство`, более поздняя запись может заменить предыдущую. Это относится и к последующим правилам XML.

Что будет, если такой же параметр задан на папке?

Атрибуты могут быть заполнены и на папках проекта. При создании SDMX Robur разрешает наследование: если на модели задано собственное значение того же имени, оно имеет приоритет.

Наш код читает итоговый параметр из узла модели. Он не ищет запасное значение в папке, сегменте или самом элементе.

Но здесь есть один нюанс: если значение папки уже унаследовано и записано в узел модели, обычный маппинг не узнает, где его ввели первоначально. Поэтому, когда нужен определённый код для конкретной модели, задавайте его непосредственно на ней.

Итоги

Так у нас появляется ещё один способ организовать передачу информации из Robur: общие данные заполняем на модели, а через маппинг распределяем их по нужным элементам. Дальше можно использовать ту же логику для кодов объектов, разделов, ответственных и других строковых параметров, которые должны сопровождать элементы в IFC.