Описание:
Создает новый объект типа umiObject с названием $name типа данных $typeId (umiObjectType) и возвращает id созданного объекта. В случае неудачи вернет false.
Владельцем вновь созданного объекта назначается текущий пользователь.
Данный метод используется для добавления объекта в коллекцию объектов системы для дальнейшего его наполнения данными. Тип данных, передаваемый вторым параметром, должен быть валидным идентификатором типа данных umiObjectType (получается через методы класса-коллекции umiObjectTypesCollection).
Пример кода:
<?php
/*
Гипотетический пример: добавляем в словарь "Сапоги" (базовый тип shoes_boot) модуля "Обувь" (module_shoes) новый объект с именем "Сапоги размера 43" и устанавливаем ему значение свойства размер (size) = 43
//
Подобные конструкции можно использовать в инсталляторах модулей, если их работоспособность предполагает определенное наполнение некоторых справочников
!!! в реальной функции необходима проверка на существование объекта - элемента справочника с таким же параметрами, как у добавляемого (чтобы не добавлять ненужный дубль)
*/
$iDictionaryObjectType = umiObjectTypesCollection::getInstance()->getBaseType('module_shoes', 'shoes_boot'); // Тип объекта - элемента справочника (используется метод getBaseType - предполагаем, что модуль и базовый тип уже зарегистрированы в системе)
// добавляем новый объект
$iNewObjectId = umiObjectsCollection::getInstance()->addObject("Сапоги размера 43", $iDictionaryObjectType);
if ($iNewObjectId !== false) { // не забываем проверять на всякий случай
// взяли экземпляр объекта для заполнения свойства
$object = umiObjectsCollection::getInstance()->getObject($iNewObjectId);
if ($object instanceof umiObject) { // не забываем проверять на всякий случай
$object->setValue('size', 43); // выставляем значение свойства
$object->commit(); // сохраняем изменения
}
}
?>
