bim

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

Проект и модели

• getProject - взятие проекта, на котором выполняется плагин
• getGeometryProject - взятие данных о проекте с данными по геометрии: границы и размеры границ по осям OX, OY, OZ
• getProjectHashSum - взятие хэша сборки проекта
• getProjectXmlFile - получение ТЭП XML-файла, привязанного к проекту
• getProjectModels - взятие всех активных моделей проекта
• getModels - получение моделей из структуры проекта
• getModelsGeometry - получение моделей с данными по геометрии
• getGeometryModel - взятие данных о модели по её идентификатору с данными по геометрии
• getModelRevisions - взятие всех ревизий модели
• getModelNamesTree - получение дерева моделей по элементу
• setUsedRevision - установка ревизий, из которых будут браться элементы
• getLogicGroupsFromProject - получение логических групп текущего проекта

Условия поиска

• createCondition - функция создания условия поиска элементов
• testElements - проверка, существуют ли элементы, соответствующие условию
• getCondition - добавление к строке IFCQL условия по списку моделей

Элементы

• getElements - функция получения списка элементов с полной информацией
• getElement - функция получения полной информации об элементе
• getAllElementsByListUuidAndProjectUuid - взятие данных об элементах по списку их идентификаторов
• getUuidsElementsByProjectUuid - взятие всех идентификаторов элементов проекта
• getElementsByModelUuid - получение списка элементов модели
• getElementByClassNamesAndModel - получение элементов модели по именам IFC-классов
• getElementByParentAndElementClassName - получение элементов по родителю и имени IFC-класса
• findAncestor - получение предка (родителя) элемента
• findDescendants - получение наследников элемента
• getSuspectElements - получение списка подозрительных элементов проекта

Элементы с геометрией

• getGeometryElements - функция получения списка элементов с полной информацией и параметрами геометрии
• getGeometryElement - функция получения полной информации об элементе и параметров геометрии
• getGeometryElementA - элемент стороны А для расчёта коллизий
• getGeometryElementB - элемент стороны B для расчёта коллизий
• getGeometryElementByClassNamesAndModel - элементы модели с геометрией по именам IFC-классов
• getGeometryElementByParentAndElementClassName - элементы с геометрией по родителю и имени IFC-класса
• getGeometryElementsByModelsAndClassNames - элементы с геометрией по набору моделей и именам IFC-классов
• getGeometryElementsByModelAndFloors - элементы с геометрией по модели и этажам
• getGeometryElementsByModelAndFloorsAndClassNames - элементы с геометрией по модели, этажам и именам IFC-классов
• getGeometryElementsByModelAndParentsAndClassNames - элементы с геометрией по модели, родителям и именам IFC-классов
• getGeometryElementsByRevision - элементы с геометрией по ревизии модели

Точная геометрия (сетки треугольников)

• getGeometryObject - функция получения координат элемента для формирования объёмной модели или отрисовки на экране
• getGeometryObjects - функция получения списка координат элементов для формирования объёмной модели или отрисовки на экране
• getGeometryObjectsMap - то же, что getGeometryObjects, но в виде карты «UUID элемента → геометрия»
• getOrientedBoundingBoxes - получение ориентированных ограничивающих боксов (OBB) элементов по условию
• getElementPolygonsCountByUuid - получение количества полигонов элемента

Атрибуты

• getAttributeValueByElementsAndNames - значение атрибута элемента по имени набора и имени атрибута
• getGeometryElementAttributeValue - значение атрибута элемента по имени (поиск по всему дереву атрибутов)
• getElementAttributeChildValue - значение атрибута элемента по имени (рекурсивный поиск)
• getElementPSetValue - набор атрибутов элемента по имени
• addAttribute - добавление атрибутов для списка элементов

Этажи

• getFloors - возвращает все этажи проекта
• getFloor - возвращает этаж конкретного элемента
• getBuildingStoreysFloors - возвращает этажи по идентификаторам элементов IfcBuildingStorey
• getElementFloor - определение этажа элемента из заданного списка этажей
• testSameFloor - проверка, находятся ли два элемента на одном этаже
• extractFloorNameNumber - извлечение номера этажа из его названия

Отображение на модели

• showElements - функция отображения на экране списка элементов (выбор/подсветка на модели)
• createGroupElements - создание (объединение) элементов в группы с указанием цвета в формате HEX
• showGroupElements - функция отображения/подсветки на экране ранее созданных групп элементов

3D-виды и чертежи

• getDrawingOnModels - получение списка 3D-видов
• getDrawingOnModelTags - получение списка тегов 3D-видов
• getDrawingOnModelTagsByDrawingOnModelUuid - получение тегов конкретного 3D-вида
• getDrawingNameAndPage - получение имени чертежа и номера листа

Коллизии и правила проверки

• getProjectCollisions - функция получения списка коллизий проекта
• getModelCollisions - функция получения списка коллизий модели
• getCollisionsForReport - функция получения списка коллизий для отчёта
• getCollisionInfo - получение объекта CollisionInfo для коллизии, назначенной к задаче
• filterGeometryElementsToCheck - отбор элементов для проверки с учётом родительского правила (цепочки проверок)
• filterGeometryObjectToCheck - то же для геометрических объектов
• setRuleParam - заполнение параметров встроенного правила (RuleParam)

Задачи

• getProjectTasks - получение списка всех задач проекта
• getTask - получение задачи по её идентификатору
• getTasks - получение списка задач
• getTasksTree - получение дерева задач проекта
• getWorkSpacesCurrentProject - получение идентификаторов рабочих пространств проекта
• getTasksCurrentWorkSpace - получение списка задач рабочего пространства
• getTasksTreeCurrentWorkspace - получение дерева задач рабочего пространства
• getLateTasks - получение списка всех просроченных задач, либо задач на эскалации
• getFirstEscalationTasks - получение списка просроченных задач (первая эскалация)
• getSecondEscalationTasks - получение списка задач второй эскалации
• saveTask - создание и/или сохранение задачи
• getLinkToTask - получение ссылки на проект с параметрами для открытия конкретной задачи
• getTaskComments - получение списка всех комментариев задачи
• getTaskAttachments - получение списка всех вложений задачи
• getCommentFromTaskAttachment - получение текста комментария из sourceData вложения
• getTaskForm - получение списка данных формы задачи
• getTaskWorkers - получение списка профилей исполнителей задачи
• getFilesDownloadLinks - получение списка ссылок на скачивание файлов, вложенных в задачи проекта
• editTokenExpiredDate - изменение срока действия токена для скачивания файлов

Пользовательские статусы и параметры задач

• registerProcessStatuses - регистрация списка пользовательских статусов задач
• initPluginTaskStatus - инициализация пользовательских статусов в проекте
• getProcessStatuses - получение списка пользовательских статусов для активного рабочего пространства
• setPluginStatusToTask - изменение пользовательского статуса задачи
• saveParamsToTask - сохранение пользовательских параметров задачи
• getParamsToTask - получение списка параметров задачи
• getTaskParams - получение списка параметров всех задач рабочего пространства
• editParam - редактирование параметра задачи
• deleteParam - удаление параметра задачи
• deleteParams - удаление параметров

Пользователи и группы организации

• getProfile - получение данных о пользователе по его идентификатору
• getProfiles - получение данных о пользователях по их идентификаторам
• getOrgGroups - получение списка групп организации
• getOrgGroup - получение группы организации
• setGroupResponderToTask - назначение группы организации ответственным за задачу
• setGroupWorkersToTask - назначение групп организации исполнителями задачи
• deleteDutyShift - удаление назначенной к задаче группы, название которой содержит указанную строку

Техническое обслуживание (ТО)

• getProjectMaintenanceTasks - получение списка всех задач ТО проекта
• getMaintenanceTasks - получение списка задач ТО по списку идентификаторов
• getOrCreateTaskFromMaintenance - создание или получение задачи на запланированное ТО
• calculateDuty - получение номера дежурной группы

Даты и вспомогательные методы

• getStartDate - получение даты на начало следующего дня
• getEndDate - получение даты на конец следующего дня
• getAmountDate - получение даты через указанное количество дней
• getDate - получение даты из строки
• getDateTime - получение даты и времени из строки
• getRuDate - получение даты в RU-формате
• parseOptionValueToList - преобразование значения поля мультивыбора формы в список
• convertStringUuidToUUID - конвертация строковых идентификаторов в UUID

Справочники

• Операторы сравнения
• Параметры поиска (оси)
• Статусы коллизий
• PowerType
• UnitType

Проект и модели

• bim.getProject() → Project - метод возвращает следующую структуру:

Пример использования:

def project = bim.getProject()
def editProjectDate = project.getEditDate()
console.info(editProjectDate.toString())
// -> "INFO: 2022-01-01T01:01:12.567Z"

• bim.getGeometryProject() → GeometryProject - содержит все поля getProject и дополнительно:

Пример использования:

def geometryProject = bim.getGeometryProject()
def bounds = geometryProject.getBounds()
console.info("Размер по X: " + geometryProject.getBoundSizeX())

• bim.getProjectHashSum() → String - хэш меняется при изменении состава моделей проекта; его можно сохранить и сравнивать при следующих запусках, чтобы понять, менялся ли проект

Пример использования:

def hash = bim.getProjectHashSum()
console.info("Хэш сборки проекта: " + hash)

• bim.getProjectXmlFile() → String - содержимое XML-файла в base64; разбирается вспомогательным классом XMLParser

Пример использования:

def xml = bim.getProjectXmlFile()
if (xml) {
    def errors = XMLParser.validateXML(xml)
    def xmlMap = XMLParser.parseXMLBase64ToMap(xml)
}

• bim.getProjectModels() → List<Model>

Пример использования:

def flattenModels(def model, List acc = []) {
    acc.add(model)
    model.model?.each { flattenModels(it, acc) }
    return acc
}

def start() {
    def listModels = bim.getProjectModels()
    def allModels = listModels.collectMany { flattenModels(it) }
    for (Model model : allModels) {
        console.info(model.getUuid().toString() + " " + model.getTitle())
        // -> "INFO: 4e733308-7ddd-11ec-90d6-0242ac120003 АР"
    }
}

• bim.getModels() → List<Model> - выполняет тот же запрос, что и getProjectModels, результат одинаковый (только модели верхнего уровня)

Пример использования:

def models = bim.getModels()
models.each { m -> console.info(m.title) }

• bim.getModelsGeometry() → List<GeometryModel> - модели с полями getGeometryModel (границы и размеры границ)

Пример использования:

def models = bim.getModelsGeometry()
models.each { m -> console.info(m.title + ": " + m.boundSizeX + " x " + m.boundSizeY + " x " + m.boundSizeZ) }

• bim.getGeometryModel(UUID modelUuid) → GeometryModel

Пример использования:

def geometryModel = bim.getGeometryModel(UUID.fromString("ac178efe-7e8d-11ec-90d6-0242ac120003"))
def bounds = geometryModel.getBounds()

• bim.getModelRevisions(UUID modelUuid) → List<ModelRevision>

Пример использования:

def listModelRevisions = bim.getModelRevisions(UUID.fromString("4e733308-7ddd-11ec-90d6-0242ac120003"))
for (ModelRevision modelRevision : listModelRevisions) {
    def modelRevisionUuid = modelRevision.getUuid()
    console.info(modelRevisionUuid.toString() + " v" + modelRevision.getVersion())
    // -> "INFO: 697ba2b6-7ddd-11ec-90d6-0242ac120003 v1"
}

• bim.getModelNamesTree(UUID elementUuid) → String - строка с именами моделей, к которым относится элемент
• bim.getModelNamesTree(String elementUuid) → String - то же по строковому идентификатору; строка, не являющаяся UUID, вызывает исключение

Пример использования:

def task = bim.getTask(UUID.fromString("c73df7aa-7ddd-11ec-90d6-0242ac120003"))
def modelName = task.entityId ? bim.getModelNamesTree(task.entityId) : ""

• bim.setUsedRevision(Collection<UUID> uuids) - задаёт ревизии моделей, из которых берутся элементы в getElements, getGeometryElements, showElements и createGroupElements (по условию). Если ревизии не заданы (или передан пустой список), используются последние ревизии

Пример использования:

def model = bim.getProjectModels()[0]
def firstRevision = bim.getModelRevisions(model.uuid).min { it.version }
bim.setUsedRevision([firstRevision.uuid])
def oldWalls = bim.getElements('entity = "IfcWall"')
bim.setUsedRevision([])
def newWalls = bim.getElements('entity = "IfcWall"')
console.info("Стен было: " + oldWalls.size() + ", стало: " + newWalls.size())

• bim.getLogicGroupsFromProject() → Set<LogicGroup> - логические группы (условия поиска) проекта; их можно передавать в методы выборки

Пример использования:

def groups = bim.getLogicGroupsFromProject()
for (def lg : groups) {
    console.info(ifcql.createIfcqlFromLogicGroup(lg) + " -> " + bim.getElements(lg).size())
}

Условия поиска

• bim.createCondition(String axis, String operator, String axisValue) → LogicGroup - по параметру поиска, оператору сравнения и значению для поиска
• bim.createCondition(String axis, String attrName, String operator, String attrValue) → LogicGroup - по параметру поиска по атрибуту, наименованию атрибута, оператору сравнения и значению атрибута
• bim.createCondition(String axis, String attrGrpName, String attrName, String operator, String attrValue) → LogicGroup - по параметру поиска по атрибуту, наименованию группы атрибутов (набора), наименованию атрибута, оператору сравнения и значению атрибута
• bim.createCondition(String axis, String operators) → LogicGroup - сокращённая форма: оператор записывается символом внутри строки, например "OverallHeight>=1000" или "=Этаж 1" (символьные операторы — см. Операторы сравнения)

Условия объединяются операторами & (И) и | (ИЛИ). Вместо условия во все методы выборки можно передать строку IFCQL (см. ifcql).

Примеры использования:

def conditionWall = bim.createCondition("class", "eq", "IfcWall")
def conditionDoor = bim.createCondition("class", "eq", "IfcDoor")
bim.showElements(conditionWall | conditionDoor)

def elementCondition = bim.createCondition("attribute", "width", "gt", "1000")
bim.showElements(elementCondition)

def elementCondition = bim.createCondition("attribute", "BaseQuantities", "width", "gt", "1000")
bim.showElements(elementCondition)

def high = bim.createCondition("attribute", "OverallHeight>=1000")
def floor1 = bim.createCondition("floor", "=Этаж 1")
def elements = bim.getElements(high & floor1)

• bim.testElements(LogicGroup lg) → boolean - по условию поиска
• bim.testElements(String expression) → boolean - по выражению IFCQL

Пример использования:

if (!bim.testElements('entity = "IfcSpace"')) {
    console.info("В проекте нет помещений")
}

• bim.getCondition(String baseCondition, Set<String> modelNames) → String - возвращает строку baseCondition + " and " + modelNames[0] + " or " + modelNames[1] ...; элементы modelNames, кроме первого, уже содержащиеся в baseCondition, пропускаются. Если список пуст, возвращается baseCondition

Пример использования:

def condition = bim.getCondition('entity = "IfcWall"', ['model = "АР"'] as Set)
// -> 'entity = "IfcWall" and model = "АР"'
def walls = bim.getElements(condition)

Элементы

• bim.getElements(LogicGroup logicGroup) → Set<ElementExternal> - по условию поиска (в том числе сложному)
• bim.getElements(String expression) → Set<ElementExternal> - по выражению IFCQL
• bim.getElements(Collection<Object> elements) → Set<ElementExternal> - по списку идентификаторов: UUID, строк-UUID или IFC GlobalId

Значение атрибута: element.getAttribute("Набор/Свойство") (никогда не возвращает null: при отсутствии атрибута имя пустое, stringValue — "", doubleValue — 0), несколько значений сразу — element.getAttributes("Свойство1", "Набор/Свойство2") → Map.

Примеры использования:

def conditionWall = bim.createCondition("class", "eq", "IfcWall")
def listWalls = bim.getElements(conditionWall)
for (ElementExternal element : listWalls) {
    def globalId = element.getGlobalId()
    console.info(globalId)
    // -> "INFO: 0Dtdg2chjBhhgnQ7zCqZkk"
}

def doors = bim.getElements('entity = "IfcDoor" and floor like "1"')
doors.each { d -> console.info(d.name + ": " + d.getAttribute("Pset_DoorCommon/FireRating").stringValue) }

def elements = new HashSet<Object>()
elements.add(UUID.fromString("e5a114d0-7de1-11ec-90d6-0242ac120003"))
elements.add("0Dtdg2chjBhhgnQ7zCqZkk")
def listElements = bim.getElements(elements)
for (ElementExternal element : listElements) {
    console.info(element.getGlobalId())
}

• bim.getElement(UUID elementUuid) → ElementExternal
• bim.getElement(String elementStrUuid) → ElementExternal - для строки, не являющейся UUID, возвращает null

Примеры использования:

def element = bim.getElement(UUID.fromString("e5a114d0-7de1-11ec-90d6-0242ac120003"))
def globalId = element.getGlobalId()
// console.info(globalId) -> "INFO: 0Dtdg2chjBhhgnQ7zCqZkk"

def element = bim.getElement("e5a114d0-7de1-11ec-90d6-0242ac120003")
def globalId = element.getGlobalId()
// console.info(globalId) -> "INFO: 0Dtdg2chjBhhgnQ7zCqZkk"

• bim.getAllElementsByListUuidAndProjectUuid(Collection<UUID> listUuidElements) → Set<ElementExternal>

Пример использования:

def uuids = bim.getUuidsElementsByProjectUuid().take(100)
def elements = bim.getAllElementsByListUuidAndProjectUuid(uuids)

• bim.getUuidsElementsByProjectUuid() → Set<UUID>

Пример использования:

def elemUuidsByProj = bim.getUuidsElementsByProjectUuid()
console.info("Элементов в проекте: " + elemUuidsByProj.size())

• bim.getElementsByModelUuid(UUID modelUuid) → Set<ElementExternal>

Пример использования:

def model = bim.getProjectModels()[0]
def elements = bim.getElementsByModelUuid(model.uuid)
console.info(model.title + ": " + elements.size())

• bim.getElementByClassNamesAndModel(UUID model, Set<String> elementClassNames) → Set<ElementExternal>

Пример использования:

def model = bim.getProjectModels()[0]
def elements = bim.getElementByClassNamesAndModel(model.uuid, ["IfcDoor", "IfcWindow"] as Set)

• bim.getElementByParentAndElementClassName(UUID parent, String elementClassName) → Set<ElementExternal>

Пример использования:

def storey = bim.getElements('entity = "IfcBuildingStorey"').find { it.name == "Этаж 1" }
def walls = bim.getElementByParentAndElementClassName(storey.uuid, "IfcWall")

• bim.findAncestor(ElementExternal element) → ElementExternal - то же, что bim.getElement(element.parent)

Пример использования:

def door = bim.getElements('entity = "IfcDoor"')[0]
def parent = bim.findAncestor(door)
console.info(parent?.elementClassName + " " + parent?.name)

• bim.findDescendants(ElementExternal element) → Set<ElementExternal>

Пример использования:

def storey = bim.getElements('entity = "IfcBuildingStorey"')[0]
def descendants = bim.findDescendants(storey)
console.info(storey.name + ": " + descendants.size())

• bim.getSuspectElements() → Set<ElementExternal> - по всему проекту
• bim.getSuspectElements(UUID modelUuid) → Set<ElementExternal>

Пример использования:

def model = bim.getProjectModels()[0]
def suspects = bim.getSuspectElements().findAll { it.model == model.uuid }
return bim.showElements(new ArrayList(suspects))

Элементы с геометрией

• bim.getGeometryElements(LogicGroup logicGroup) → Set<GeometryElement> - по условию поиска (в том числе сложному)
• bim.getGeometryElements(String expression) → Set<GeometryElement> - по выражению IFCQL
• bim.getGeometryElements(Collection<Object> elements) → Set<GeometryElement> - по списку UUID или строк-UUID

Примеры использования:

def conditionWall = bim.createCondition("class", "eq", "IfcWall")
def listWalls = bim.getGeometryElements(conditionWall)
for (GeometryElement geometryElement : listWalls) {
    def globalId = geometryElement.getGlobalId()
    // console.info(globalId) -> "INFO: 0Dtdg2chjBhhgnQ7zCqZkk"
    def volumeElement = geometryElement.getVolume()
    // console.info(volumeElement.toString()) -> "INFO: 0.1"
}

def windows = bim.getGeometryElements('entity = "IfcWindow"').findAll { it.area > 2 }

def doors = bim.getElements('entity = "IfcDoor"')
def listElements = bim.getGeometryElements(new ArrayList(doors*.uuid))
for (GeometryElement geometryElement : listElements) {
    console.info(geometryElement.getName() + ": " + geometryElement.getVolume())
}

• bim.getGeometryElement(UUID elementUuid) → GeometryElement
• bim.getGeometryElement(String elementStrUuid) → GeometryElement - для строки, не являющейся UUID, возвращает null

GeometryElement содержит все поля getElements и дополнительно:

Структура границ Bounds:

Пример использования:

def geometryElement = bim.getGeometryElement(UUID.fromString("e5a114d0-7de1-11ec-90d6-0242ac120003"))
def globalId = geometryElement.getGlobalId()
// console.info(globalId) -> "INFO: 0Dtdg2chjBhhgnQ7zCqZkk"
def volumeElement = geometryElement.getVolume()
// console.info(volumeElement.toString()) -> "INFO: 0.1"

• bim.getGeometryElementA() → GeometryElement - элемент, идентификатор которого передан в параметре elementa; если параметра нет, возвращает null

Пример использования:

def geometryElement = bim.getGeometryElementA()
if (geometryElement != null) {
    def globalId = geometryElement.getGlobalId()
    // console.info(globalId) -> "INFO: 16BLvbdfv9tvbtZs9KMly$"
    def volumeElement = geometryElement.getVolume()
    // console.info(volumeElement.toString()) -> "INFO: 1.34"
}

• bim.getGeometryElementB() → GeometryElement - элемент, идентификатор которого передан в параметре elementb; если параметра нет, возвращает null

Пример использования:

def geometryElement = bim.getGeometryElementB()
if (geometryElement != null) {
    def globalId = geometryElement.getGlobalId()
    // console.info(globalId) -> "INFO: 16BLvbdfv9tvbtZs9KMly$"
    def volumeElement = geometryElement.getVolume()
    // console.info(volumeElement.toString()) -> "INFO: 1.01"
}

• bim.getGeometryElementByClassNamesAndModel(UUID model, Set<String> elementClassNames) → Set<GeometryElement>

Пример использования:

def model = bim.getProjectModels()[0]
def slabs = bim.getGeometryElementByClassNamesAndModel(model.uuid, ["IfcSlab"] as Set)

• bim.getGeometryElementByParentAndElementClassName(UUID parent, String elementClassName) → Set<GeometryElement>

Пример использования:

def storey = bim.getElements('entity = "IfcBuildingStorey"').find { it.name == "Этаж 1" }
def spaces = bim.getGeometryElementByParentAndElementClassName(storey.uuid, "IfcSpace")

• bim.getGeometryElementsByModelsAndClassNames(Set<UUID> models, Set<String> ifcNames) → Set<GeometryElement>

Пример использования:

def modelUuids = bim.getProjectModels().findAll { it.title in ["АР", "КР"] }*.uuid as Set
def walls = bim.getGeometryElementsByModelsAndClassNames(modelUuids, ["IfcWall", "IfcWallStandardCase"] as Set)

• bim.getGeometryElementsByModelAndFloors(UUID model, Set<UUID> parentUuids) → Set<GeometryElement> - parentUuids — идентификаторы элементов этажей (IfcBuildingStorey), как в поле buildingStorey элемента

Пример использования:

def spaces = bim.getGeometryElements('entity = "IfcSpace"')
def space = spaces[0]
def sameFloor = bim.getGeometryElementsByModelAndFloors(space.model, [space.buildingStorey] as Set)

• bim.getGeometryElementsByModelAndFloorsAndClassNames(UUID model, Set<UUID> buildStoreys, Set<String> elementClassNames) → Set<GeometryElement> - buildStoreys — идентификаторы элементов этажей (IfcBuildingStorey)

Пример использования:

def storeys = bim.getElements('entity = "IfcBuildingStorey"')
def model = bim.getProjectModels()[0]
def storeyUuids = storeys.findAll { it.model == model.uuid }*.uuid as Set
def doors = bim.getGeometryElementsByModelAndFloorsAndClassNames(model.uuid, storeyUuids, ["IfcDoor"] as Set)

• bim.getGeometryElementsByModelAndParentsAndClassNames(UUID model, Set<UUID> parentUuids, Set<String> elementClassNames) → Set<GeometryElement>

Пример использования:

def wall = bim.getGeometryElements('entity = "IfcWall"')[0]
def openings = bim.getGeometryElementsByModelAndParentsAndClassNames(wall.model, [wall.uuid] as Set, ["IfcOpeningElement"] as Set)

• bim.getGeometryElementsByRevision(UUID revisionUuid) → Set<GeometryElement>

Пример использования:

def model = bim.getProjectModels()[0]
def lastRevision = bim.getModelRevisions(model.uuid).max { it.version }
def elements = bim.getGeometryElementsByRevision(lastRevision.uuid)

Точная геометрия (сетки треугольников)

• bim.getGeometryObject(UUID elementUuid) → GeometryObject - результат кэшируется на время запуска плагина

Пример использования:

def geometryObject = bim.getGeometryObject(UUID.fromString("e5a114d0-7de1-11ec-90d6-0242ac120003"))
console.info("Треугольников: " + geometryObject.getTrianglesCount())

• bim.getGeometryObjects(LogicGroup logicGroup) → Set<GeometryObject> - по условию поиска (в том числе сложному)
• bim.getGeometryObjects(String expression) → Set<GeometryObject> - по выражению IFCQL
• bim.getGeometryObjects(Collection<Object> elements) → Set<GeometryObject> - по списку UUID или строк-UUID
• bim.getGeometryObjects(LogicGroup logicGroup, boolean needCache) → Set<GeometryObject>
• bim.getGeometryObjects(String expression, boolean needCache) → Set<GeometryObject>
• bim.getGeometryObjects(Collection<Object> elements, boolean needCache) → Set<GeometryObject>

При needCache = true полученная геометрия сохраняется в кэш, и последующие вызовы getGeometryObject для этих элементов не обращаются к серверу.

Пример использования:

def condition = bim.createCondition("class", "eq", "IfcWall")
def geometryObjects = bim.getGeometryObjects(condition)

def pipes = bim.getGeometryElements('entity like "IfcPipe"')
def meshes = bim.getGeometryObjects(new ArrayList(pipes*.uuid), true)

• bim.getGeometryObjectsMap(Collection<Object> elements) → Map<UUID, GeometryObject> - по списку UUID или строк-UUID; один запрос вместо вызова getGeometryObject для каждого элемента

Пример использования:

def pipes = bim.getGeometryElements('entity like "IfcPipe"')
def objMap = bim.getGeometryObjectsMap(new ArrayList(pipes*.uuid))
pipes.each { p ->
    def mesh = objMap[p.uuid]
    if (mesh == null) return      // у элемента нет геометрии
    console.info(p.name + ": " + mesh.getTrianglesCount())
}

• bim.getOrientedBoundingBoxes(String expression) → Set<GeometryObject> - по выражению IFCQL; каждый OBB возвращается как GeometryObject (мм)

Пример использования:

def boxes = bim.getOrientedBoundingBoxes('entity = "IfcBeam"')
boxes.each { b -> console.info(b.uuid.toString() + ": " + b.getVertices().length / 3 + " вершин") }

• bim.getElementPolygonsCountByUuid(UUID elementUuid) → Long

Пример использования:

def count = bim.getElementPolygonsCountByUuid(UUID.fromString("e5a114d0-7de1-11ec-90d6-0242ac120003"))
console.info("Полигонов: " + count)

Атрибуты

• bim.getAttributeValueByElementsAndNames(ElementExternal elementExternal, String pSetName, String attrName) → String - строковое значение атрибута pSetName/attrName; null, если набора или атрибута нет

Пример использования:

def walls = bim.getElements('entity = "IfcWall"')
walls.each { w ->
    def fireRating = bim.getAttributeValueByElementsAndNames(w, "Pset_WallCommon", "FireRating")
    console.info(w.name + ": " + (fireRating ?: "не задано"))
}

• bim.getGeometryElementAttributeValue(GeometryElement geometryElement, String propName) → String - ищет атрибут по имени по всему дереву атрибутов (в ширину); пустые значения, а также NOTDEFINED, Unknown, отсутствует считаются отсутствующими — тогда возвращается null

Пример использования:

def doors = bim.getGeometryElements('entity = "IfcDoor"')
doors.each { d -> console.info(d.name + ": " + bim.getGeometryElementAttributeValue(d, "OverallHeight")) }

• bim.getElementAttributeChildValue(ElementExternal elementExternal, String propName) → String - рекурсивный поиск атрибута по имени; пустые значения, NOTDEFINED, Unknown, отсутствует считаются отсутствующими — тогда возвращается null

Пример использования:

def element = bim.getElement(UUID.fromString("e5a114d0-7de1-11ec-90d6-0242ac120003"))
def tag = bim.getElementAttributeChildValue(element, "Tag") ?: ""

• bim.getElementPSetValue(ElementExternal elementExternal, String psetName) → ElementAttribute - набор атрибутов верхнего уровня с указанным именем или null

Пример использования:

def element = bim.getElements('entity = "IfcWall"')[0]
def pset = bim.getElementPSetValue(element, "Pset_WallCommon")
pset?.children?.each { a -> console.info(a.name + " = " + a.stringValue) }

• bim.addAttribute(Collection<Object> elements, String groupName, String attributeName, Object value, String unit, String power) → boolean - elements — элементы, UUID, строки-UUID или IFC GlobalId; groupName — имя набора атрибутов; unit — имя из справочника UnitType, power — имя из справочника PowerType

Пример использования:

def walls = bim.getElements('entity = "IfcWall"')
bim.addAttribute(new ArrayList(walls), "Проверки", "Проверено", "да", "USERDEFINED", "NULL")

Этажи

• bim.getFloors() → List<Floor>

Пример использования:

def floors = bim.getFloors()
for (def floor : floors) {
    console.info(floor.getName())
    console.info(floor.getElevation())
    console.info(floor.getAbsElevation())
}

def storeyToFloor = [:]
bim.getFloors().each { f -> f.elements?.each { storeyToFloor[it] = f } }
def doors = bim.getElements('entity = "IfcDoor"')
doors.each { d -> console.info(d.name + ": " + storeyToFloor[d.buildingStorey]?.name) }

• bim.getFloor(UUID elementUuid) → Floor - по идентификатору элемента
• bim.getFloor(ElementExternal element) → Floor - по самому элементу

Пример использования:

def conditionModel = bim.createCondition("model", "eq", "АР")
def elements = bim.getGeometryElements(conditionModel)
for (def element : elements) {
    def floor = bim.getFloor(element)
    double offset = floor.getElevation() + 18.5
}

• bim.getBuildingStoreysFloors(Set<UUID> buildingStoreyUuids) → Set<Floor>

Пример использования:

def spaces = bim.getElements('entity = "IfcSpace"')
def floors = bim.getBuildingStoreysFloors(spaces*.buildingStorey.findAll { it != null } as Set)
floors.each { f -> console.info(f.name) }

• bim.getElementFloor(GeometryElement geometryElement, List<Floor> floors) → Floor - этаж, в elements которого входит buildingStorey элемента, или null; выполняется без запроса к серверу

Пример использования:

def floors = bim.getFloors()
def spaces = bim.getGeometryElements('entity = "IfcSpace"')
spaces.each { s -> console.info(s.name + ": " + bim.getElementFloor(s, floors)?.name) }

• bim.testSameFloor(Floor floor, GeometryElement geometryElement1, GeometryElement geometryElement2) → boolean - true, если buildingStorey обоих элементов входит в указанный этаж

Пример использования:

def floors = bim.getFloors()
def door = bim.getGeometryElements('entity = "IfcDoor"')[0]
def space = bim.getGeometryElements('entity = "IfcSpace"')[0]
def floor = bim.getElementFloor(door, floors)
if (floor != null && bim.testSameFloor(floor, door, space)) {
    console.info("Дверь и помещение на одном этаже: " + floor.name)
}

• bim.extractFloorNameNumber(String storeyName) → Integer - первое целое число в названии после удаления отметок с дробной частью (+3.300, -0,150); 0, если числа нет; -Integer.MAX_VALUE для пустого названия

Пример использования:

bim.extractFloorNameNumber("Этаж 3 (+6.600)")   // 3
bim.extractFloorNameNumber("-1 этаж")           // -1
def sorted = bim.getFloors().sort { bim.extractFloorNameNumber(it.name) }

Отображение на модели

• bim.showElements(LogicGroup logicGroup) → Set<String> - по условию поиска (в том числе сложному)
• bim.showElements(String expression) → Set<String> - по выражению IFCQL
• bim.showElements(Collection<Object> elements) → Set<String> - по списку элементов (ElementExternal/GeometryElement), UUID, строк-UUID или IFC GlobalId; допускается Set
• bim.showElements(ElementExternal... elements) → Set<String> - по одному или нескольким элементам, перечисленным через запятую
• bim.showElement(ElementExternal element) → Set<String> - показ одного элемента

Примеры использования:

def conditionWall = bim.createCondition("class", "eq", "IfcWall")
def conditionDoor = bim.createCondition("class", "eq", "IfcDoor")
return bim.showElements(conditionWall | conditionDoor)

return bim.showElements('entity = "IfcDoor" and floor like "1"')

return bim.showElements(["dhb487dbcsndb", "salndhkjfnjkenkjsd", "sdfsdfadsdfsad"])

return bim.showElements([UUID.fromString("ac178efe-7e8d-11ec-90d6-0242ac120003"), UUID.fromString("e5a114d0-7de1-11ec-90d6-0242ac120003")])

def elementCondition = bim.createCondition("attribute", "width", "gt", "1000")
def elements = bim.getElements(elementCondition)
return bim.showElements(elements)

• bim.createGroupElements(String color, LogicGroup logicGroup) - цвет, условие поиска
• bim.createGroupElements(String color, List<ElementExternal> elements) - цвет, список элементов
• bim.createGroupElements(String color, Set<String> elements) - цвет, набор идентификаторов элементов (строки)

Цвет задаётся в формате #RRGGBB. Созданные группы отображаются методом showGroupElements.

Примеры использования:

def conditionDoor = bim.createCondition("class", "eq", "IfcDoor")
bim.createGroupElements("#FF9933", conditionDoor)
return bim.showGroupElements()

def conditionDoor = bim.createCondition("class", "eq", "IfcDoor")
def elements = bim.getElements(conditionDoor)
bim.createGroupElements("#FF9933", new ArrayList(elements))
return bim.showGroupElements()

bim.createGroupElements("#FF9933", ["dhb487dbcsndb", "salndhkjfnjkenkjsd", "sdfsdfadsdfsad"] as Set)
return bim.showGroupElements()

• bim.showGroupElements() → List<GroupElements> - группы, созданные методом createGroupElements

Пример использования:

def start() {
    bim.createGroupElements("#FF0000", bim.createCondition("class", "eq", "IfcDoor"))
    def big = bim.getGeometryElements('entity = "IfcWindow"').findAll { it.area > 2 }
    bim.createGroupElements("#00AA00", new ArrayList(big))
    return bim.showGroupElements()
}

3D-виды и чертежи

• bim.getDrawingOnModels() → List<DrawingOnModel> - основные поля: uuid, title, modelUuid, drawingPageUuid, parentUuid, isFolder, baseElevation

Пример использования:

def views = bim.getDrawingOnModels()
views.findAll { !it.isFolder() }.each { v -> console.info(v.title) }

• bim.getDrawingOnModelTags() → List<DrawingOnModelTag> - поля: drawingOnModelUuid, name, value, projectUuid

Пример использования:

def showOnlyLayers = bim.getDrawingOnModelTags().findAll { it.name == "Этаж" }.size() > 0

• bim.getDrawingOnModelTagsByDrawingOnModelUuid(UUID drawingOnModelUuid) → List<DrawingOnModelTag>

Пример использования:

def view = bim.getDrawingOnModels()[0]
def tags = bim.getDrawingOnModelTagsByDrawingOnModelUuid(view.uuid)
tags.each { t -> console.info(t.name + " = " + t.value) }

• bim.getDrawingNameAndPage(UUID drawingPage) → String

Пример использования:

def view = bim.getDrawingOnModels().find { it.drawingPageUuid != null }
if (view) {
    console.info(bim.getDrawingNameAndPage(view.drawingPageUuid))
}

Коллизии и правила проверки

• bim.getProjectCollisions() → List<Collision>
• bim.getProjectCollisions(String key) → List<Collision> - с указанием нужного статуса коллизий

Примеры использования:

def listCollisions = bim.getProjectCollisions()
for (def c : listCollisions) {
    def globalIdA = c.getGlobalIdA()
    // console.info(globalIdA) -> "INFO: 0Dtdg2chjBhhgnQ7zCqZkk"
    def globalIdB = c.getGlobalIdB()
    // console.info(globalIdB) -> "INFO: js89njhsihd9ffsd3kmll9hln0"
}

def listCollisions = bim.getProjectCollisions("NEW")
for (def c : listCollisions) {
    console.info(c.getGlobalIdA() + " / " + c.getGlobalIdB())
}

• bim.getModelCollisions(UUID modelUuid) → List<Collision> - по идентификатору модели
• bim.getModelCollisions(UUID modelUuid, String key) → List<Collision> - по идентификатору модели и статусу коллизий

Примеры использования:

def listCollisions = bim.getModelCollisions(UUID.fromString("ac178efe-7e8d-11ec-90d6-0242ac120003"))
for (def c : listCollisions) {
    console.info(c.getGlobalIdA() + " / " + c.getGlobalIdB())
}

def listCollisions = bim.getModelCollisions(UUID.fromString("ac178efe-7e8d-11ec-90d6-0242ac120003"), "NEW")
for (def c : listCollisions) {
    console.info(c.getGlobalIdA() + " / " + c.getGlobalIdB())
}

• bim.getCollisionsForReport() → CollisionsReport - коллизии для отчёта текущего пользователя: collisions — список коллизий, tableSettings — настройки колонок таблицы. Результат передаётся в file.collisionsToPdf

Пример использования:

def collisionList = bim.getCollisionsForReport()
def param = [:]
param.put("pageSize", "3")
param.put("fontSize", "12")
file.collisionsToPdf(template, collisionList, param)

• bim.getCollisionInfo(UUID collisionUuid) → CollisionInfo - поля: uuid, collisionUuid, description

Пример использования:

def attachments = bim.getTaskAttachments(task.uuid)
for (def attachment : attachments) {
    if (attachment.collision != null) {
        def collisionInfo = bim.getCollisionInfo(attachment.collision)
        console.info(collisionInfo.description)
    }
}

• bim.filterGeometryElementsToCheck(int parentOption, Set<Object> parentElemUUids, Set<GeometryElement> ruleElements) → Set<GeometryElement>

Используется в правилах проверки с цепочкой проверок: parentOption и список parentElements приходят в params. Если parentElemUUids пуст или null, возвращаются ruleElements. При parentOption = 1, 2 или 3 возвращаются элементы родительского правила, входящие в ruleElements; при 0 — ruleElements.

Пример использования:

int parentOption = Integer.parseInt((params.get("parentOption") ?: "-1").toString())
def parentRaw = params.get("parentElements")
Set parentElemUuids = (parentRaw instanceof Collection) ? (parentRaw as Set) : null
def ruleElements = bim.getGeometryElements(params.get("spaceCondition"))
def elements = bim.filterGeometryElementsToCheck(parentOption, parentElemUuids, ruleElements)

• bim.filterGeometryObjectToCheck(int parentOption, Set<Object> parentElemUUids, Set<GeometryObject> ruleElements) → Set<GeometryObject> - аналог filterGeometryElementsToCheck для GeometryObject

Пример использования:

int parentOption = Integer.parseInt((params.get("parentOption") ?: "-1").toString())
def parentRaw = params.get("parentElements")
Set parentElemUuids = (parentRaw instanceof Collection) ? (parentRaw as Set) : null
def meshes = bim.getGeometryObjects('entity = "IfcSpace"')
def toCheck = bim.filterGeometryObjectToCheck(parentOption, parentElemUuids, meshes)

• bim.setRuleParam(String condition, Map<String, Object> paramsMap) → RuleParam - condition записывается в mainCondition (если не null), paramsMap — в params (если не пуст)

Используется при подготовке параметров встроенного правила Element Wall Validation Rule: метод вызывается для каждой строки настроек, ключи в paramsMap — с индексом строки (startOption0, operator0 …), а результаты собираются в карту paramsMap правила.

Пример использования:

def ruleParams = [:]                      // параметры встроенного правила
def paramsMap = [:] as LinkedHashMap
for (int i = 0; i < 12; i++) {
    if (!params.get("startOption" + i)) continue
    def map = [:] as LinkedHashMap
    map.put("startOption" + i, params.get("startOption" + i))
    map.put("endOption" + i, params.get("endOption" + i))
    map.put("directionOption" + i, params.get("directionOption" + i))
    map.put("operator" + i, params.get("operator" + i))
    map.put("distanceValue" + i, Double.parseDouble((params.get("distanceValue" + i) ?: "0").toString()))
    paramsMap.put("ruleParams" + i, bim.setRuleParam("Default_Condition", map))
}
ruleParams.put("paramsMap", paramsMap)

Задачи

• bim.getProjectTasks() → List<Task> - каждая задача представляет из себя следующую структуру:

Пример использования:

def listTasks = bim.getProjectTasks()
for (Task task : listTasks) {
    def taskUuid = task.getUuid()
    // console.info(taskUuid.toString()) -> "INFO: c73df7aa-7ddd-11ec-90d6-0242ac120003"
}

• bim.getTask(UUID taskUuid) → Task

Пример использования:

def task = bim.getTask(mainTask.taskUuid)

• bim.getTasks(List<UUID> taskUuids) → List<Task> - по списку идентификаторов
• bim.getTasks(String startDate, String endDate) → List<Task> - все задачи за заданный период; даты принимаются в форматах dd.MM.yyyy, yyyy-MM-dd или ISO-8601 (2026-09-01T00:00:00Z)

Пример использования:

def tasks = bim.getTasks(taskUuidsList)

def tasks = bim.getTasks("01.09.2026", "30.09.2026")

• bim.getTasksTree() → List<Task>

Пример использования:

def tasksTree = bim.getTasksTree()
tasksTree.each { t -> console.info(t.title + ": подзадач " + (t.children?.size() ?: 0)) }

• bim.getWorkSpacesCurrentProject() → List<UUID>

Пример использования:

def workSpaceUuids = bim.getWorkSpacesCurrentProject()

• bim.getTasksCurrentWorkSpace(UUID workSpaceUuid) → List<Task>

Пример использования:

def workSpaceUuid = bim.getWorkSpacesCurrentProject()[0]
def tasks = bim.getTasksCurrentWorkSpace(workSpaceUuid)

• bim.getTasksTreeCurrentWorkspace(UUID workSpaceUuid) → List<Task>

Пример использования:

def workSpaceUuid = bim.getWorkSpacesCurrentProject()[0]
def currentTasksTree = bim.getTasksTreeCurrentWorkspace(workSpaceUuid)

• bim.getLateTasks() → List<Task>

Пример использования:

def taskList = bim.getLateTasks()

• bim.getFirstEscalationTasks() → List<Task>

Пример использования:

def firstEscalationTasks = bim.getFirstEscalationTasks()

• bim.getSecondEscalationTasks() → List<Task>

Пример использования:

def secondEscalationTasks = bim.getSecondEscalationTasks()

• bim.saveTask(Task task) → Task - создаёт новую задачу или изменяет существующую; дальше работайте с возвращённым объектом

Пример использования:

def task = new Task()
task.title = "Проверить узел"
task.startDate = bim.getStartDate()
task.stopDate = bim.getEndDate()
task = bim.saveTask(task)

• bim.getLinkToTask(UUID taskUuid) → String

Пример использования:

def url = bim.getLinkToTask(task.uuid)

• bim.getTaskComments(UUID taskUuid) → List<Comment>

Пример использования:

def listComments = bim.getTaskComments(UUID.fromString("c73df7aa-7ddd-11ec-90d6-0242ac120003"))
for (Comment comment : listComments) {
    def authorUuid = comment.getAuthorUuid()
    console.info(authorUuid.toString() + ": " + comment.getText())
}

• bim.getTaskAttachments(UUID taskUuid) → List<Attachment>

Пример использования:

def listAttachments = bim.getTaskAttachments(UUID.fromString("c73df7aa-7ddd-11ec-90d6-0242ac120003"))
for (Attachment attachment : listAttachments) {
    def createDate = attachment.getCreateDate()
    console.info(createDate.toString())
    // -> "INFO: 2022-01-21T10:01:12.567Z"
}

• bim.getCommentFromTaskAttachment(String sourceData) → String - значение поля comment из JSON sourceData; пустая строка, если его нет или JSON некорректен

Пример использования:

def info = bim.getCommentFromTaskAttachment(attachment.sourceData)

• bim.getTaskForm(UUID taskUuid) → List<FormData> - основные поля: uuid, form, fields (значения полей формы), createdDate, modifiedDate

Пример использования:

def taskForm = bim.getTaskForm(UUID.fromString("94e8e236-510b-4325-8b3a-15e317924bb2"))

• bim.getTaskWorkers(UUID taskUuid) → List<Profile>

Пример использования:

def taskWorkers = bim.getTaskWorkers(UUID.fromString("94e8e236-510b-4325-8b3a-15e317924bb2"))
taskWorkers.each { p -> console.info(p.name + " " + p.email) }

• bim.getFilesDownloadLinks(List<UUID> attachmentsUuid) → List<String> - ссылки на скачивание файлов по идентификаторам вложений задач. Ссылка действительна в течение одного дня; изменить срок можно методом editTokenExpiredDate. Метод рекомендуется использовать при формировании отчетов

Пример использования:

def tasks = bim.getProjectTasks()
def uuids = []
for (def task : tasks) {
    for (def attachment : bim.getTaskAttachments(task.uuid)) {
        if (attachment != null)
            uuids.add(attachment.uuid)
    }
}
def downloadLinks = bim.getFilesDownloadLinks(uuids)
def urls = downloadLinks.collect { it.replace('<p><a href="', '') }
console.info(urls.toString())

• bim.editTokenExpiredDate(UUID tokenUuid, int day) → UUID

Пример использования:

UUID uuid = UUID.fromString("94e8e236-510b-4325-8b3a-15e317924bb2")
bim.editTokenExpiredDate(uuid, 2)

Пользовательские статусы и параметры задач

• bim.registerProcessStatuses(List<PluginTaskStatus> statusList) → List<Object> - список статусов передаётся списком карт [name: …, title: …]: name — системное имя статуса, title — отображаемое название

Пример использования:

def start() {
    bim.registerProcessStatuses([
            [name: "new", title: "Открыта"],
            [name: "check", title: "На проверке"],
            [name: "complete", title: "Выполнена"]
    ])
    bim.initPluginTaskStatus()
}

• bim.initPluginTaskStatus()

Пример использования:

bim.initPluginTaskStatus()

• bim.getProcessStatuses() → List<Object>

Пример использования:

def listProcessStatuses = bim.getProcessStatuses()

• bim.setPluginStatusToTask(UUID taskUuid, String status) → Task - status — name зарегистрированного статуса

Пример использования:

task = bim.setPluginStatusToTask(task.uuid, "check")

• bim.saveParamsToTask(UUID taskUuid, Map<String, Object> params, boolean showInTask) → List<PluginTaskParam> - сохранение списка пользовательских параметров к задаче: идентификатор задачи, параметры, показ в карточке задачи
• bim.saveParamsToTask(UUID taskUuid, String name, Object value, boolean showInTask) → List<PluginTaskParam> - сохранение одного пользовательского параметра: идентификатор задачи, имя параметра, значение, показ в карточке задачи

Пример использования:

bim.saveParamsToTask(task.uuid, "isLate", true, true)

bim.saveParamsToTask(task.uuid, [checked: true, checkDate: bim.getRuDate(Instant.now())], false)

• bim.getParamsToTask(UUID taskUuid) → List<PluginTaskParam> - поля параметра: uuid, taskUuid, name, value, showInTask

Пример использования:

def taskParams = bim.getParamsToTask(task.uuid)
def isLate = taskParams.find { it.name == "isLate" }?.value

• bim.getTaskParams() → List<PluginTaskParam>

Пример использования:

def taskParams = bim.getTaskParams()

• bim.editParam(UUID paramUuid, String name, Object param) → PluginTaskParam

Пример использования:

def param = bim.getParamsToTask(task.uuid).find { it.name == "isLate" }
bim.editParam(param.uuid, "isLate", false)

• bim.deleteParam(UUID paramUuid)

Пример использования:

bim.deleteParam(paramUuid)

• bim.deleteParams(UUID taskUuid) - удаление всех параметров задачи по идентификатору задачи
• bim.deleteParams(List<PluginTaskParam> params) - удаление списка параметров

Пример использования:

bim.deleteParams(task.uuid)

def params = bim.getParamsToTask(task.uuid).findAll { it.name.startsWith("tmp") }
bim.deleteParams(params)

Пользователи и группы организации

• bim.getProfile(UUID profileUuid) → Profile - основные поля: uuid, name, email, phone, archive

Пример использования:

def profile = bim.getProfile(UUID.fromString("ef952aa8-7ddc-11ec-90d6-0242ac120003"))
def profileUuid = profile.getUuid()
// console.info(profileUuid.toString()) -> "INFO: ef952aa8-7ddc-11ec-90d6-0242ac120003"

• bim.getProfiles(List<UUID> profilesUuid) → List<Profile>

Пример использования:

def listProfilesData = bim.getProfiles(profilesUuid)

• bim.getOrgGroups() → List<OrgGroupFullDTO> - все группы организации
• bim.getOrgGroups(List<UUID> orgGroups) → List<OrgGroupFullDTO> - группы по идентификаторам
• bim.getOrgGroups(String groupName) → List<OrgGroupFullDTO> - группы с одинаковым или схожим названием

Поля группы: uuid, title, organization, profiles (идентификаторы пользователей группы).

Пример использования:

def groups = bim.getOrgGroups("Дежурная смена")

• bim.getOrgGroup(UUID orgGroup) → OrgGroupFullDTO - получение группы организации по её идентификатору
• bim.getOrgGroup(String groupName) → OrgGroupFullDTO - получение группы организации по её названию

Если группа не найдена, возвращается null.

Пример использования:

def headEngineer = bim.getOrgGroup("Главный инженер")
if (headEngineer != null) {
    console.info("Пользователей в группе: " + headEngineer.profiles.size())
}

• bim.setGroupResponderToTask(UUID taskUuid, String groupName) → Task

Пример использования:

task = bim.setGroupResponderToTask(task.uuid, "Главный инженер")

• bim.setGroupWorkersToTask(UUID taskUuid, List<String> titles) → Task

Пример использования:

task = bim.setGroupWorkersToTask(task.uuid, [bim.calculateDuty()])

• bim.deleteDutyShift(Task task, String groupName) → Task

Пример использования:

def task = bim.getTask(mainTask.taskUuid)
task = bim.deleteDutyShift(task, "Дежурная смена")

Техническое обслуживание (ТО)

• bim.getProjectMaintenanceTasks() → List<MaintenanceTask> - поля: uuid, title, maintenanceDate, maintenanceDoneDate, equipment, status, taskUuid, dutyNum

Пример использования:

def mTasks = bim.getProjectMaintenanceTasks()

• bim.getMaintenanceTasks(List<UUID> taskUuids) → List<MaintenanceTask>

Пример использования:

def taskList = bim.getMaintenanceTasks(taskUuids)

• bim.getOrCreateTaskFromMaintenance(UUID maintenanceTask) → Task

Пример использования:

def onStartMaintenanceTask(def mTasks) {
    mTasks.each { mTask ->
        def task = bim.getOrCreateTaskFromMaintenance(mTask.uuid)
    }
}

• bim.calculateDuty() → String - номер дежурной группы на следующий день («Дежурная смена N»)
• bim.calculateDuty(String groupName) → String - номер группы на следующий день по имени группы («groupName N»)
• bim.calculateDuty(MaintenanceTask mTask) → String - номер дежурной группы на дату проведения ТО по задаче обслуживания
• bim.calculateDuty(String groupName, MaintenanceTask mTask) → String - номер группы на дату проведения ТО по имени группы и задаче обслуживания

Пример использования:

def numberGroup = bim.calculateDuty("Дежурная смена", mTask)
// -> "Дежурная смена 2"

Даты и вспомогательные методы

• bim.getStartDate() → Instant

Пример использования:

task.startDate = bim.getStartDate()

• bim.getEndDate() → Instant

Пример использования:

task.stopDate = bim.getEndDate()

• bim.getAmountDate(int day) → Instant

Пример использования:

task.escalationDate = bim.getAmountDate(2)

• bim.getDate(String dateStr) → Instant - получение даты из строки формата dd.MM.yyyy
• bim.getDate(String dateStr, String formatStr) → Instant - получение даты из строки по заданному формату

Если строку не удалось разобрать, возвращается null.

Пример использования:

def date = bim.getDate("31.12.2026")
def isoDate = bim.getDate("2026-12-31", "yyyy-MM-dd")

• bim.getDateTime(String dateStr) → Instant - строка формата dd.MM.yyyy HH:mm; null, если строку не удалось разобрать

Пример использования:

def date = bim.getDateTime("31.12.2026 18:00")

• bim.getRuDate(Instant date) → String - дата в формате dd.MM.yyyy HH:mm по московскому времени; для null — текущие дата и время

Пример использования:

console.info("Задача создана " + bim.getRuDate(task.createDate))

• bim.parseOptionValueToList(String optionValue) → List<String> - извлекает все значения в двойных кавычках; для null или пустой строки возвращает пустой список

Пример использования:

List modelNames = bim.parseOptionValueToList((params.get("models") ?: "").toString())
// "[\"АР\",\"КР\"]" -> ["АР", "КР"]

• bim.convertStringUuidToUUID(Collection<String> stringUuidElements) → Set<UUID> - строка, не являющаяся UUID, вызывает исключение

Пример использования:

def uuids = bim.convertStringUuidToUUID(["e5a114d0-7de1-11ec-90d6-0242ac120003", "ac178efe-7e8d-11ec-90d6-0242ac120003"])
def elements = bim.getAllElementsByListUuidAndProjectUuid(uuids)

Справочники

Операторы сравнения