Добавление своего функционала в UMI.CMS при помощи обработчиков событий

	<xsl:template match="Классификатор">
		...
		<!-- описание типа для справочника вариантов характеристик футболок -->
		<type id="charaсteristics-kinds" title='Справочник для поля "Характеристики"' parent-id="root-guides-type" guide="guide">
			<base/>
			<fieldgroups>
				<group name="charaсteristics_kinds">
					<field name="1c_id" title="Идентификатор в 1С" visible="visible">
						<type name="Строка" data-type="string"/>
					</field>
					<field name="color" title="Цвет" field-type-id="3" visible="visible" required="required" >
						<type id="3" name="Строка" data-type="string"/>
					</field>
					<field name="size" title="Размер" field-type-id="3" visible="visible" required="required" >
						<type id="3" name="Строка" data-type="string"/>
					</field>
				</group>
			</fieldgroups>
		</type>
		<!-- тип для товара -->
		<type id="shirts" title='1C: Футболки' parent-id="root-catalog-object-type">
			<base module="catalog" method="object">Объект каталога</base>
			<fieldgroups>
				...
				<!-- Опционные свойства -->
				<group name="optioned_properties" title="Опционные свойства">
					<field name="charaсteristics" title="Характеристики" visible="visible" guide-id="charakteristics-kinds">
						<type name="Составное" data-type="optioned"  multiple="multiple" />
					</field>
				</group>
			</fieldgroups>
		</type>
		...
	</xsl:template>

	<!-- шаблон для описания товара - указываем, что страницы товара будут создаваться с нашим типом -->
	<xsl:template match="Товары/Товар">
		...
		<page id="{Ид}" parentId="{$group_id}" type-id="shirts">
			...
		</page>
		...
	</xsl:template>

	<!-- Предложения -->
	<xsl:template match="ПакетПредложений">
		<meta>
			<source-name>commerceML2</source-name>
		</meta>
		<objects>
			<xsl:apply-templates select="Предложения/Предложение"  mode="objects"/>
		</objects>
		<pages>
			<xsl:apply-templates select="Предложения/Предложение"  mode="items"/>
		</pages>
	</xsl:template>

	<!-- описание объектов справочников -->
	<xsl:template match="Предложения/Предложение"  mode="objects">
		<object id="{substring-after(Ид,'#')}" name="{Наименование}" type-id="charakteristics-kinds">
			<properties>
                <group name="charaсteristics_kinds">
					<property name="1c_id" type="string"  is-public="1" visible="visible">
						<title>Идентификатор в 1С</title>
						<value><xsl:value-of select="Ид" /></value>
					</property>
                	<xsl:apply-templates select="ХарактеристикиТовара/ХарактеристикаТовара[Наименование = 'Цвет']" mode="color" />
                	<xsl:apply-templates select="ХарактеристикиТовара/ХарактеристикаТовара[Наименование = 'Размер']" mode="size" />
				</group>
			</properties>
		</object>
	</xsl:template>

	<xsl:template match="ХарактеристикиТовара/ХарактеристикаТовара" mode="color" >
		<property name="color" type="string"  is-public="1" visible="visible">
			<title><xsl:value-of select="Наименование" /></title>
			<value><xsl:value-of select="Значение" /></value>
		</property>
	</xsl:template>

	<xsl:template match="ХарактеристикиТовара/ХарактеристикаТовара" mode="size" >
		<property name="size" type="string"  is-public="1" visible="visible">
			<title><xsl:value-of select="Наименование" /></title>
			<value><xsl:value-of select="Значение" /></value>
		</property>
	</xsl:template>

	<!-- описание страниц, ссылающихся на эти объекты -->
	<xsl:template match="Предложения/Предложение" mode="items">
		<page id="{substring-before(Ид,'#')}" update-only="1">
			<properties>
				<group name="optioned_properties" title="Опционные свойства">
					<property name="charaсteristics" type="optioned" is-public="1" visible="visible">
						<title>Характеристики</title>
							<value>
								<option int="{Количество}" float="{Цены/Цена/ЦенаЗаЕдиницу}">
									<object id="{substring-after(Ид,'#')}" name="{Наименование}" type-id="charakteristics-kinds" />
								</option>
							</value>
					</property>
				</group>
			</properties>
		</page>
	</xsl:template>

	/**
	 * Обработчик события импорта страницы товара из 1С
	 * @param e - ссылка на экземпляр события
	 */
	public function onImportElement($e) {
		if($e->getMode() == "after") {
			//добавляем опционные свойства
			$this->addOptionedProperties($e);
		}
	}

	/**
	 * Добавляет в случае необходимости опционные свойства. Этот функционал отсутствует в оригинальном
	 * импортере UMI
	 * @param e - ссылка на экземпляр события
	 */
	function addOptionedProperties($e) {
		$hierarchy = umiHierarchy::getInstance();
		$element = $e->getRef('element');
		if (!$element instanceof umiHierarchyElement
				|| $element->getMethod() != 'object') {
			//это не страница товара
			return false;
		}
		$object_id = $element->objectId;
		//XML DOM node с данными данного товара
		$element_info = $e->getParam('element_info');
		$properties = $element_info->getElementsByTagName('property');
		$propertiesSize = $properties->length;
		$types = umiObjectTypesCollection::getInstance();
		//обрабатываем все свойства товара из XML
		foreach($properties as $key => $info) {
			$old_name = $info->getAttribute('name');
			//получаем внутреннее имя свойства
			$name = self::translateName($old_name);
			$nl =  $info->getElementsByTagName("value");
			if (!$nl->length) {
				//не найдено значение свойства в XML
				continue;
			}
			$value_node = $nl->item(0);
			//получаем ссылку на соответствующий тип данных и соответствующее поле товара
			$type_id = ($element instanceof umiHierarchyElement) ? $element->getObjectTypeId() : $element->getTypeId();
			$type = umiObjectTypesCollection::getInstance()->getType($type_id);
			$field_id = $type->getFieldId($name, false);
			$field = umiFieldsCollection::getInstance()->getField($field_id);
			if (!$field instanceof umiField) {
				continue;
			}
			switch($field->getDataType()) {
				//нам надо обработать только опционные свойства, так как остальные уже обработаны движком UMI
				case "optioned":
					//storing old settings
					$oldForce = umiObjectProperty::$USE_FORCE_OBJECTS_CREATION;
					umiObjectProperty::$USE_FORCE_OBJECTS_CREATION = false;
					//находим справочник, на который ссылается поле
					$objectsCollection = umiObjectsCollection::getInstance();
					$guideItems = $objectsCollection->getGuidedItems($field->getGuideId());
					$options = $value_node->getElementsByTagName("option");
					$items = Array();
					foreach($options as $option) {
						//в поле int у нас хранится число товаров на складе соответствующего цвета и размера
						$int = $option->hasAttribute("int") ? $option->getAttribute("int") : null;
						//в поле float у нас хранится цена товара
						$float = $option->hasAttribute("float") ? $option->getAttribute("float") : null;
						$objects = $option->getElementsByTagName("object");
						foreach($objects as $object) {
							$objectId = $object->hasAttribute("id") ? $object->getAttribute("id") : null;
							$objectName = $object->hasAttribute("name") ? $object->getAttribute("name") : null;
							$objectTypeId = $object->hasAttribute("type-id") ? $object->getAttribute("type-id") : null;
							//создаем опционное свойства
							$item = Array();
							$item["int"] = (int)$int;
							$item["float"] = (float)$float;
							$item["varchar"] = $objectName;
							//находим объект, на который ссылается property
							foreach($guideItems as $key => $value) {
								if($value == $objectName) {
									//ссылка на id объекта справочника должна быть именно типа int, иначе не работает
									$item["rel"] = (int)$key;
									break;
								}
							}
							$items[] = $item;
						}
					}
					//обновим поле объекта
					$entityId = $element->getId();
					if($element instanceof umiHierarchyElement) {
						$entityId = $element->getObject()->getId();
					}
					$pageObject = $objectsCollection->getObject($entityId);
					//мы должны добавить объекты к уже существующим, если они есть
					$existingItems = $pageObject->getValue($name);
					$newItems = Array();
					if($existingItems) {
						//добавляем те объекты из имеющихся, которых нет в новых
						foreach($existingItems as $existingItem) {
							$found = false;
							foreach($items as $item) {
								if($item["rel"] == $existingItem["rel"]) {
									$found = true;
									break;
								}
							}
							if(!$found) {
								$newItems[] = $existingItem;
							}
						}
					}
					//теперь добавим все новые
					foreach($items as $item) {
						$newItems[] = $item;
					}
					$pageObject->setValue($name, $newItems);
					$pageObject->commit();
					//restoring settings
					umiObjectProperty::$USE_FORCE_OBJECTS_CREATION = $oldForce;
					break;
			}
		}
	}

	/**
	 * Оригинальный UMI-шный метод из кода модуля импорта данных
	 */
	protected static function translateName($name) {
		$name = umiHierarchy::convertAltName($name, "_");
		$name = umiObjectProperty::filterInputString($name);
		if(!strlen($name)) $name = '_';
		$name = substr($name, 0, 64);
		return $name;
	}