Changes for page Интерфейс bim
Last modified by Bimit Administrator on 02.10.2024, 09:47
From version 61.1
edited by Bimit Administrator
on 01.03.2022, 14:17
on 01.03.2022, 14:17
Change comment:
There is no comment for this version
To version 73.4
edited by Bimit Administrator
on 21.06.2024, 12:52
on 21.06.2024, 12:52
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,28 +1,76 @@ 1 1 Основной интерфейс для получения и работы с данными. В данном интерфейсе доступны следующие методы: 2 2 3 -* [[getProject>>path:#_Toc1]] - взятие проекта на котором выполняется плагин 4 -* [[getProfile>>path:#_Toc2]] - получение данных о пользователе по его идентификатору Uuid 5 -* [[getProjectModels>>path:#_Toc3]] - взятие всех активных моделей проекта на котором выполняется плагин 6 -* [[getModelRevisions>>path:#_Toc4]] - взятие всех ревизий модели 7 -* [[getProjectTasks>>path:#_Toc5]] - получение списка всех задач проекта 8 -* [[getTaskComments>>path:#_Toc6]] - получение списка всех комментариев у задачи по идентификатору задача 9 -* [[getTaskAttachments>>path:#_Toc7]] - получение списка всех вложений к задаче по идентификатору задача 10 -* [[getElements>>path:#_Toc8]] - функция получения списка элементов с полной информацией 3 +* [[calculateDuty>>path:#_Toc66]] - получение номера дежурной группы 4 +* [[createCondition>>path:#_Toc19]] - функция создания условия поиска элементов 5 +* [[createCondition>>path:#_Toc40]] - функция создания условия поиска элементов по параметру поиска, оператору сравнения 6 +* [[createGroupElements>>path:#_Toc17]] - создание (объединение) элементов в группы с указанием цвета в формате HEX 7 +* [[getAmountDate>>path:#_Toc62]] - получение даты через указанное количество дней 8 +* [[getAttachmentDrawing>>path:#_Toc32]] - получение байтового массива с чертежом вложенного к задаче по названию чертежа 9 +* [[getAttachmentImage>>path:#_Toc31]] - получение изображения вложенного к задаче по названию изображения 10 +* [[getAvatar>>path:#_Toc33]] - получение байтового массива аватара по его имени 11 +* [[getCollisionsForReport>>path:#_Toc26]] - функция получения списка коллизий для отчета 12 +* [[getDate>>path:#_Toc63]] - получение даты из строки 13 +* [[getDateTime>>path:#_Toc64]] - получение даты и времени из строки 11 11 * [[getElement>>path:#_Toc9]] - функция получения полной информации о элементе 15 +* [[getElements>>path:#_Toc8]] - функция получения списка элементов с полной информацией 16 +* [[getEndDate>>path:#_Toc61]] - получение даты на конец следующего дня 17 +* [[getFilesDownloadLinks>>path:#_Toc27]] - получение списка ссылок на скачивание файлов, которые вложены в задачи проекта 18 +* [[getFirstEscalationTasks>>path:#_Toc58]] - получение списка просроченных задач 12 12 * [[getGeometryElement>>path:#_Toc10]] - функция получения полной информации о элементе и дополнительно параметры геометрии 13 -* [[getGeometryElements>>path:#_Toc11]] - функция получения списка элементов с полной информацией и дополнительно параметры геометрии, на вход ей можно подать: условие поиска, сложное условие поиска 14 -* [[getGeometryProject>>path:#_Toc12]] - взятие данных о проекта с добавленными данными по геометрии модели: границы и размеры границ по осям OX,OY,OZ 15 -* [[getGeometryModel>>path:#_Toc13]] - взятие данных о модели по ее идентификатору с добавленными данными по геометрии модели: границы и размеры границ по осям OX,OY,OZ 16 16 * [[getGeometryElementA>>path:#_Toc14]] - специфичная функция получения полной информации о элементе и дополнительно параметры геометрии для расчета коллизий (сторона А, если существует) 17 17 * [[getGeometryElementB>>path:#_Toc15]] - специфичная функция получения полной информации о элементе и дополнительно параметры геометрии для расчета коллизий (сторона B, если существует) 22 +* [[getGeometryElements>>path:#_Toc11]] - функция получения списка элементов с полной информацией и дополнительно параметры геометрии, на вход ей можно подать: условие поиска, сложное условие поиска 23 +* [[getGeometryModel>>path:#_Toc13]] - взятие данных о модели по ее идентификатору с добавленными данными по геометрии модели: границы и размеры границ по осям OX,OY,OZ 18 18 * [[getGeometryObject>>path:#_Toc22]] - функция получения координат элемента для формирования объемной модели или отрисовки на экране 25 +* [[getGeometryObjects>>path:#_Toc38]] - функция получения списка координат элементов для формирования объемной модели или отрисовки на экране, на вход ей можно подать: условие поиска, сложное условие поиска 26 +* [[getGeometryObjects>>path:#_Toc39]] - функция получения списка координат элементов для формирования объемной модели или отрисовки на экране 27 +* [[getGeometryProject>>path:#_Toc12]] - взятие данных о проекта с добавленными данными по геометрии модели: границы и размеры границ по осям OX,OY,OZ 28 +* [[getHtmlAvatar>>path:#_Toc34]] - получение аватара преобразованного к виду htlm строки (кода) по имени аватара 29 +* [[getHtmlDrawing>>path:#_Toc36]] - получение чертежа преобразованного к виду html строки (кода) по имени чертежа 30 +* [[getHtmlImage>>path:#_Toc35]] - получение изображения преобразованную к виду html строки (кода) по имени изображения 31 +* [[getMaintenanceTasks>>path:#_Toc55]] - получение списка задач ТО по списку идентификаторов 32 +* [[getModelCollisions>>path:#_Toc21]] - функция получения списка коллизий модели 33 +* [[getModelRevisions>>path:#_Toc4]] - взятие всех ревизий модели 34 +* [[getOrCreateTaskFromMaintenance>>path:#_Toc54]] - создание или получение задачи на запланированное ТО по идентификатору задачи 35 +* [[getOrgGroup>>path:#_Toc53]] - получение группы организации 36 +* [[getOrgGroups>>path:#_Toc52]] - получение списка групп организации 37 +* [[getParamsToTask>>path:#_Toc45]] - получение списка параметров для задачи по идентификатору задачи 38 +* [[getProcessStatuses>>path:#_Toc42]] - получение списка пользовательских статусов для активного рабочего пространства 39 +* [[getProfile>>path:#_Toc2]] - получение данных о пользователе по его идентификатору Uuid 40 +* [[getProject>>path:#_Toc1]] - взятие проекта на котором выполняется плагин 41 +* [[getProjectCollisions>>path:#_Toc20]] - функция получения списка коллизий проекта 42 +* [[getProjectModels>>path:#_Toc3]] - взятие всех активных моделей проекта на котором выполняется плагин 43 +* [[getProjectTasks>>path:#_Toc5]] - получение списка всех задач проекта 44 +* [[getSecondEscalationTasks>>path:#_Toc59]] - получить список задач второй эскалации 45 +* [[getStartDate>>path:#_Toc60]] - получение даты на начало следующего дня 46 +* [[getTaskAttachments>>path:#_Toc7]] - получение списка всех вложений к задаче по идентификатору задач 47 +* [[getTaskComments>>path:#_Toc6]] - получение списка всех комментариев у задачи по идентификатору задач 48 +* [[getTaskForm>>path:#_Toc29]] - получение списка данных формы задачи по идентификатору задачи 49 +* [[getTaskParams>>path:#_Toc46]] - получение списка параметров для всех задач рабочего пространства 50 +* [[getTaskWorkers>>path:#_Toc30]] - получение списка профилей у задачи по её идентификатору 51 +* [[initPluginTaskStatus>>path:#_Toc67]] - инициализация пользовательских статусов в проекте 52 +* [[registerProcessStatuses>>path:#_Toc41]] - регистрация списка пользовательских статусов для задач по списку статусов задач плагина 53 +* [[saveParamsToTask>>path:#_Toc43]] - сохранение списка пользовательских параметров к задаче, на вход ей можно подать: идентификатор задачи, параметры, показ задачи 54 +* [[saveParamsToTask>>path:#_Toc44]] - сохранение пользовательского параметра к задаче, на вход ей можно подать: идентификатор задачи, имя задачи, какое-то значение, показ задачи 55 +* [[saveTask>>path:#_Toc65]] - создание и/или сохранение задачи 56 +* [[setGroupResponderToTask>>path:#_Toc57]] - назначение группы организации как ответственного на задачу по идентификатору задачи, имени группы 57 +* [[setGroupWorkersToTask>>path:#_Toc56]] - назначение группы организации как работника на задачу по идентификатору задачи, списку титулов 58 +* [[setPluginStatusToTask>>path:#_Toc50]] - изменение пользовательского статуса задачи по идентификатору задачи, статусу 19 19 * [[showElements>>path:#_Toc16]] - функция отображения на экране списка элементов (выбор/подсветка на модели) 20 -* [[createGroupElements>>path:#_Toc17]] - создание (объединение) элементов в группы с указанием цвета в формате HEX 21 21 * [[showGroupElements>>path:#_Toc18]] - функция отображения/подсветки на экране ранее созданных групп элементов 22 -* [[createCondition>>path:#_Toc19]] - функция создания условия поиска элементов 23 -* [[getProjectCollisions>>path:#_Toc20]] - функция получения списка коллизий проекта 24 -* [[getModelCollisions>>path:#_Toc21]] - функция получения списка коллизий модели 61 +* [[deleteDutyShift>>path:#_Toc51]] - удаление назначенной группы к задаче, название которой содержит указанную строку 62 +* [[deleteParam>>path:#_Toc48]] - удаление параметра задачи по параметру идентификатора 63 +* [[deleteParams>>path:#_Toc49]] - удаление параметров 64 +* [[editParam>>path:#_Toc47]] - редактирование параметра задачи по идентификатору параметра, имени параметра, параметру 65 +* [[editTokenExpiredDate>>path:#_Toc28]] - позволяет изменить количество дней, через сколько токен для скачивания файлов станет недействительным 25 25 67 + 68 +Справочники 69 + 70 +* [[Операторы сравнения>>path:#_Toc23]] 71 +* [[Параметры поиска>>path:#_Toc24]] 72 +* [[Статусы коллизий>>path:#_Toc25]] 73 + 26 26 ====== ====== 27 27 28 28 ====== ====== ... ... @@ -1880,7 +1880,6 @@ 1880 1880 1881 1881 * **bim.getGeometryObject(Идентификатор элемента)** 1882 1882 1883 - 1884 1884 (% class="box infomessage" %) 1885 1885 ((( 1886 1886 **{{id name="_Toc16"/}}showElements** - функция отображения на экране списка элементов (выбор/подсветка на модели) ... ... @@ -1967,9 +1967,9 @@ 1967 1967 **{{id name="_Toc19"/}}createCondition** - функция создания условия поиска элементов 1968 1968 ))) 1969 1969 1970 -* **bim.createCondition(параметр поиска, оператор сравнения,значение для поиска)** 1971 -* **bim.createCondition(параметр поиска по атрибуту, наименование атрибута, оператор сравнения,значение поиска атрибута)** 1972 -* **bim.createCondition(параметр поиска по атрибуту, наименование группы атрибутов,наименование атрибута, оператор сравнения,значение поиска атрибута)** 2017 +* **bim.createCondition([[параметр поиска>>path:#_Toc24]], [[операторы сравнения>>path:#_Toc23]] ,значение для поиска)** 2018 +* **bim.createCondition([[параметр поиска>>path:#_Toc24]] по атрибуту, наименование атрибута, [[операторы сравнения>>path:#_Toc23]],значение поиска атрибута)** 2019 +* **bim.createCondition([[параметр поиска>>path:#_Toc24]] по атрибуту, наименование группы атрибутов,наименование атрибута, [[операторы сравнения>>path:#_Toc23]],значение поиска атрибута)** 1973 1973 1974 1974 **Примеры использования:** 1975 1975 ... ... @@ -2309,4 +2309,116 @@ 2309 2309 } 2310 2310 {{/code}} 2311 2311 2312 - 2359 + 2360 +(% class="box infomessage" %) 2361 +((( 2362 +**{{id name="_Toc26"/}}getCollisionsForReport()** - функция получения списка коллизий для отчета. 2363 +))) 2364 + 2365 +* **bim.getCollisionsForReport()** 2366 +[[list>>https://wiki.bimit.ru/bin/view/API/%D0%9F%D0%BB%D0%B0%D0%B3%D0%B8%D0%BD%20API/%D0%98%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81%20file/#_Toc20]] - список коллизий. Обязательное поле. Получить данный лист необходимо 2367 + 2368 +**Пример использования:** 2369 + 2370 +{{code language="java"}} 2371 +def collisionList = bim.getCollisionsForReport() 2372 + def param = [:] 2373 + param.add("pageSize", 3) 2374 + param.add("fontSize", 12) 2375 + file.collisionsToPdf(template, collisionList, param) 2376 + 2377 +{{/code}} 2378 + 2379 + 2380 +(% class="box infomessage" %) 2381 +((( 2382 +**{{id name="_Toc27"/}}getFilesDownloadLinks** - получение списка ссылок на скачивание файлов, которые вложены в задачи проекта 2383 +))) 2384 + 2385 +* **bim.getFilesDownloadLinks() - **Данный метод предназначен для получения списка ссылок на скачивания файлов из задач по проекту. 2386 +Ссылка действительна в течении одного дня. Изменить данное время можно командой editTokenExpiredDate (см. ниже). Данный метод рекомендуется использовать при формировании отчетов. 2387 +**Пример использования:** 2388 + 2389 +{{code language="java"}} 2390 +def tasks = bim.getProjectTasks() 2391 + def taskAttachments = [] 2392 + for(def task : tasks) { 2393 + taskAttachments.push(bim.getTaskAttachments(task.uuid)) 2394 + } 2395 + 2396 + def uuids = [] 2397 + for (def attachments : taskAttachments) { 2398 + for (def attachment : attachments) { 2399 + if (attachment != null) 2400 + uuids.push(attachment.uuid) 2401 + } 2402 + } 2403 + def downloadLinks = bim.getFilesDownloadLinks(uuids) 2404 + console.info(downloadLinks) -> INFO [ 2405 +6201ced9-b873-4a7d-8266-537f1566c543.docx, 2406 +687ac450-75e2-42f6-9fbe-7c608912c079.png 2407 +] 2408 +{{/code}} 2409 + 2410 +(% class="box infomessage" %) 2411 +((( 2412 +**{{id name="_Toc28"/}}editTokenExpiredDate** - позволяет изменить количество дней, через сколько токен для скачивания файлов станет недействительным 2413 +))) 2414 + 2415 +* **bim.editTokenExpiredDate()** 2416 +**Пример использования:** 2417 + 2418 +{{code language="java"}} 2419 +UUID uuid = UUID.fromString("94e8e236-510b-4325-8b3a-15e317924bb2") 2420 + bim.editTokenExpiredDate (uuid, 2) 2421 + 2422 +{{/code}} 2423 + 2424 +(% class="box infomessage" %) 2425 +((( 2426 +**{{id name="_Toc29"/}}getTaskForm** - получение списка данных формы задачи по идентификатору задачи 2427 +))) 2428 + 2429 +* **bim.getTaskForm(UUID taskUuid) ** 2430 + 2431 +**Пример использования:** 2432 + 2433 +{{code language="java"}}{{/code}} 2434 + 2435 + 2436 + 2437 +СПРАВОЧНИКИ 2438 + 2439 + 2440 +**{{id name="_Toc23"/}}Операторы сравнения** 2441 + 2442 +(% cellspacing="0" style="border-collapse:collapse; border:none; width:850px" %) 2443 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**eq**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)Равно 2444 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**noteq**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)Не равно 2445 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**cont**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)Содержит 2446 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**notcont**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)Не содержит 2447 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**gt**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)Больше 2448 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**gteq**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)Больше или равно 2449 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**lt**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)Меньше 2450 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**lteq**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)Меньше или равно 2451 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**ex**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)Имеет значение ex 2452 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**notex**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)Не имеет значение notex 2453 + 2454 +**{{id name="_Toc24"/}}Параметры поиска** 2455 + 2456 +(% cellspacing="0" style="border-collapse:collapse; border:none; width:850px" %) 2457 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**model**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)поиск по названию модели в структуре проекта 2458 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**floor**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)поиск по названию этажа 2459 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**class**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)поиск по названию ifc класса (ifc тип) 2460 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**zone**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)поиск по названию зоны, объединяющей элементы 2461 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**layer**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)поиск по названию слоя объединяющего элементы 2462 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**attribute**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)поиск по значению атрибута 2463 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**geometry**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)параметры поиска по значению рассчитанной геометрии, на текущий момент доступно только площадь(ключ атрибута =”area”) и объем(ключ атрибута =”volume”) 2464 + 2465 +**{{id name="_Toc25"/}}Статусы коллизий** 2466 + 2467 +(% cellspacing="0" style="border-collapse:collapse; border:none; width:850px" %) 2468 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**NEW**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)запрос коллизий в статусе новые 2469 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**WORK**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)коллизии в работе 2470 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**SOLVED**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)решенные коллизии 2471 +|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:363px" %)**ALLOWED**|(% style="border-color:#000000; border-style:solid; border-width:1px; padding:7px; vertical-align:top; width:485px" %)допустимые коллизии