SysML v2
API і MCP у проєктах SysML v2
Читайте, шукайте та перевіряйте моделі SysML v2 зі скриптів та інструментів ШІ за допомогою персонального токена доступу, пропонуйте зміни, які ви переглядаєте та застосовуєте в Holarch, і читайте та фіксуйте зміни через Systems Modeling API, де гілки є запитами на зміну.
На цій сторінці
Огляд
Проєкти SysML v2 працюють з тим самим REST API, кінцевою точкою MCP і персональними токенами доступу, що й проєкти LML. Скрипти й інструменти ШІ читають модель як елементи й текст SysML, перевіряють текст, перш ніж щось змінити, і пропонують зміни. Нічого в моделі не змінюється, доки людина не прорецензує пропозицію в Holarch і не застосує її.
Три способи доступу:
- REST API:
https://app.holarch.app/api/v1/projects/<project>/…для скриптів і панелей моніторингу. Він читає елементи, вимоги, діагностику й текст SysML і додає зміни до пропозиції. - MCP:
https://app.holarch.app/mcpдля інструментів ШІ, як-от Claude. Інструменти SysML v2 читають, шукають і перевіряють модель та пропонують зміни. - Systems Modeling API:
https://app.holarch.app/api/v1/sysml/…, у формах OMG Systems Modeling API для інших інструментів SysML v2. Гілкаmain— це жива модель, доступна лише для читання; кожна інша гілка — запит на зміну, і коміти йдуть у неї. Жива модель змінюється лише тоді, коли затверджувач застосовує запит на зміну в Holarch.
Токени, області доступу, списки проєктів, перемикач організації, обмеження частоти й під’єднання Claude такі самі, як для проєктів LML. Як створити токен і під’єднати інструмент ШІ, див. API і MCP. Виклики Карта програми (GET /api/v1/program-map, GET /api/v1/projects/<project>/items/<item>/trace та інструменти MCP program_map і trace_chain) охоплюють проєкти SysML v2 та їхні елементи.
Поняття
- Елемент: один складник моделі SysML v2, як-от визначення частини, порт або вимога. Кожен елемент має id (UUID). Скрізь, де маршрут чи інструмент просить id, працює також кваліфікована назва, як-от
Vehicles::Car::powertrain. - Стисла форма: коротка форма елемента в списках:
id,type(метаклас, як-отPartUsage),name,shortName,qualifiedNameіowner. - Пакет верхнього рівня: пакет, що не міститься в іншому елементі. Текст SysML проєкту — це по одному тексту на пакет верхнього рівня плюс один текст для елементів поза пакетами.
- Діагностика: проблема, яку знаходить ядро мови, з
code,severity(errorабоwarning),elementId,elementіargs. Синтаксична діагностика замість елемента даєlineіcol. - Пропозиція: зміни, які клієнт API чи інструмент ШІ збирає для рецензування. Для кожного токена й проєкту відкрита одна пропозиція. Клієнт надсилає її на рецензування з заголовком і підсумком.
- Посторінкові відповіді: списки надходять сторінками (
limit,offset). Довгий текст SysML надходить сторінками рядків (line,lines). Відповідь, у якій щось пропущено, міститьtruncated: true.
Як користуватися
Використовуйте API, коли скрипту чи інструменту ШІ потрібна модель: щоб звітувати про вимоги без елементів, що їх задовольняють або верифікують, щоб перевірити текст SysML команди щодо моделі або щоб дозволити інструменту ШІ підготувати чернетки змін моделі, які потім рецензує інженер.
Читання проєкту SysML v2 за допомогою curl
- Створіть токен у Налаштування облікового запису → Токени API (див. API і MCP).
- Перелічіть свої проєкти:
curl -H "Authorization: Bearer hol_…" https://app.holarch.app/api/v1/projects
Проєкти SysML v2 мають "language": "sysml2".
- Отримайте зведення моделі:
curl -H "Authorization: Bearer hol_…" https://app.holarch.app/api/v1/projects/<project>/model
Ви бачите кількість елементів за метакласами, пакети верхнього рівня й кількість помилок і попереджень.
- Знайдіть елементи, наприклад кожне визначення частини:
curl -H "Authorization: Bearer hol_…" "https://app.holarch.app/api/v1/projects/<project>/elements?type=part%20def&limit=100"
- Прочитайте текст SysML пакета:
curl -H "Authorization: Bearer hol_…" "https://app.holarch.app/api/v1/projects/<project>/sysml?root=Vehicles"
Довгий текст закінчується "truncated": true і "next": рядком, який слід запросити далі через line.
Перевірка тексту SysML перед пропозицією
- Надішліть новий текст пакета на маршрут перевірки:
curl -X POST -H "Authorization: Bearer hol_…" -H "Content-Type: application/json" \
-d '{"root": "Vehicles", "text": "package Vehicles { … }"}' \
https://app.holarch.app/api/v1/projects/<project>/sysml/check
- Прочитайте відповідь.
okдорівнюєtrue, коли текст не має синтаксичних помилок.diagnosticsперелічує синтаксичні помилки зlineіcol, а також помилки, які текст додав би до моделі.changes— кількість змін моделі, які вносить текст.
Перевірка нічого не змінює. Їй потрібен лише токен читання.
Пропозиція зміни та її застосування
Токен запису додає зміни до відкритої пропозиції токена. Потім клієнт надсилає пропозицію на рецензування.
- Додайте зміну. Надішліть або повний новий текст пакета, або зміни елементів:
curl -X POST -H "Authorization: Bearer hol_…" -H "Content-Type: application/json" \
-d '{"edits": [{"op": "create", "kind": "attribute", "owner": "Vehicles::Car", "name": "range", "typedBy": ["LengthValue"]}]}' \
https://app.holarch.app/api/v1/projects/<project>/proposal/changes
Ви отримуєте 201 з пропозицією, підсумком зміни та елементами, які вона додає, змінює й вилучає. Зміна, що додає діагностику помилок, відхиляється (див. Пропозиції в проєктах SysML v2).
- Додавайте інші зміни так само. Кожна зміна перевіряється щодо моделі із застосованими попередніми змінами пропозиції.
- Надішліть пропозицію на рецензування:
curl -X POST -H "Authorization: Bearer hol_…" -H "Content-Type: application/json" \
-d '{"title": "Add range attribute", "summary": "Adds Car::range for the range requirement."}' \
https://app.holarch.app/api/v1/projects/<project>/proposal
- У Holarch відкрийте проєкт, потім відкрийте ✦ ШІ ▾ → Переглянути “Add range attribute”… (або сповіщення під дзвіночком).
- Перевірте рядки й натисніть Застосувати вибране.
Позначені зміни застосовуються з вашим іменем в історії, і одне натискання “Відмінити” повертає все назад.
Під’єднання інструмента ШІ до проєкту SysML v2
- Під’єднайте інструмент ШІ до
https://app.holarch.app/mcpза допомогою токена або входу (див. API і MCP). - Запитайте про модель, наприклад “Підсумуй модель Hybrid Car у Holarch” або “Які вимоги в проєкті Hybrid Car не верифіковано?”.
Інструмент ШІ використовує
model_summary,list_elements,list_requirementsта інші інструменти читання. - Попросіть зміну, наприклад “Запропонуй атрибут
rangeдляCar”.Інструмент ШІ читає пакет через
get_sysml, пропонує текст або зміни елементів і виправляє діагностику, яку повертає перевірка. - Прорецензуйте пропозицію в Holarch і натисніть Застосувати вибране.
Приклад: демопроєкт Hybrid Car
Створіть демопроєкт через Керування проєктами → Файли проєктів ▾ → Новий демопроєкт → Hybrid Car (SysML v2), потім створіть для нього токен читання й запису.
GET /api/v1/projects/<project>/modelперелічує пакети верхнього рівня, серед нихVehicles,HybridCarArchitectureіVehicleBehavior.GET /api/v1/projects/<project>/elements?query=Engine&type=part%20defзнаходитьVehicles::Engine.GET /api/v1/projects/<project>/elements/Vehicles::Engineповертає визначення частини з його текстом SysML, членами (displacement,cylinders,maxPower, портиfuelIn,outputіecu) і використаннями, типізованими ним.GET /api/v1/projects/<project>/elements/Vehicles::Car/connectionsперелічує інтерфейсdriveShaftвідpowertrain.outputдоfrontAxle.input.GET /api/v1/projects/<project>/requirements?status=unverifiedперелічує вимоги, які не верифікує жоден випадок верифікації, з їхніми ідентифікаторами, як-отVR-4.1.POST /api/v1/projects/<project>/proposal/changesз{"edits": [{"op": "update", "id": "Vehicles::Engine", "doc": "Gasoline engine of the hybrid powertrain."}]}додає зміну до пропозиції.POST /api/v1/projects/<project>/proposalіз заголовком надсилає її.- У Holarch ✦ ШІ ▾ → Переглянути “…” показує Змінено: з визначенням частини й полем
doc, а також текстову різницюVehicles. Застосувати вибране застосовує її.
Поради
- Прочитайте пакет через
get_sysml(абоGET …/sysml?root=), перш ніж пропонувати для нього новий текст. Елементи, пропущені в запропонованому тексті, вилучаються. - Для невеликих змін надавайте перевагу змінам елементів. Вони змінюють лише названі елементи й залишають решту тексту пакета як є.
- Спершу перевірте текст через
check_sysml(абоPOST …/sysml/check). Він повертає ту саму діагностику, з якою було б відхилено пропозицію. - У скриптах називайте елементи кваліфікованою назвою. Ідентифікатори не змінюються, коли елемент перейменовують; кваліфіковані назви змінюються.
- Давайте інструменту ШІ токен лише для читання, коли він тільки відповідає на запитання про модель.
Маршрути REST для проєктів SysML v2
Базова адреса: https://app.holarch.app/api/v1. Відповіді — у JSON. /api/v1/openapi.json (OpenAPI 3.1) описує ці маршрути разом з іншими.
| Метод і шлях | Що він робить |
|---|---|
GET /projects/<project>/model | Кількість елементів за метакласами, пакети верхнього рівня з кількістю їхніх елементів, а також кількість помилок і попереджень |
GET /projects/<project>/elements | Пошук: query (або q; текст у назві, короткому імені, кваліфікованій назві чи doc), type, owner, limit (1–500, за замовчуванням 50), offset; сортування за кваліфікованою назвою |
GET /projects/<project>/elements/<id> | Один елемент з його полями, doc, текстом SysML, членами й використаннями, типізованими ним; members (0–200, за замовчуванням 100) |
GET /projects/<project>/elements/<id>/connections | З’єднання, інтерфейси, зв’язування, потоки (з предметом), послідовності, переходи, розподіли й залежності на елементі або його ознаках, а також ті, що належать до нього; limit (за замовчуванням 100) |
GET /projects/<project>/requirements | Вимоги з їхнім ідентифікатором, формулюванням (doc), satisfiedBy і verifiedBy; owner, status (unsatisfied або unverified), limit (за замовчуванням 100), offset |
GET /projects/<project>/diagnostics | Діагностика моделі, спершу помилки; ids (через кому: лише ці елементи та їхні члени), limit (за замовчуванням 200, не більше 500) |
GET /projects/<project>/sysml | Текст SysML пакета верхнього рівня (root), елементів поза пакетами (без root) або одного елемента (element); line (перший рядок, від 1), lines (за замовчуванням 2000, не більше 5000) |
POST /projects/<project>/sysml/check | Перевірити text як новий текст root (або елементів поза пакетами); нічого не змінює |
POST /projects/<project>/proposal/changes | Додати зміну до відкритої пропозиції: {text, root} або {edits} |
GET /projects/<project>/proposal | Відкрита пропозиція або пропозиція за ідентифікатором proposal, з її статусом і змінами |
POST /projects/<project>/proposal | Надіслати відкриту пропозицію на рецензування: title, summary |
DELETE /projects/<project>/proposal | Відкинути відкриту пропозицію до надсилання |
GET /projects і GET /projects/<project> також працюють для проєктів SysML v2. Вони дають "language": "sysml2", а відповідь про проєкт додає elements і types (кількість елементів за метакласами).
Маршрути сутностей LML (/entities, /relationships, /schema, Перевірки моделі та перевірка якості) у проєкті SysML v2 відповідають 409 wrong-project-type. Маршрути SysML v2 відповідають так само в проєкті LML.
Значення
- type: метаклас, як-от
PartUsageчиRequirementDefinition, або ключове слово, як його записано в тексті SysML:part,part def,attribute,port,requirement,action,packageта інші ключові слова елементів. - owner, id, element, root: ідентифікатор або кваліфікована назва.
rootтакож приймає назву пакета верхнього рівня.rootмає бути пакетом верхнього рівня; щоб прочитати текст одного елемента, використовуйтеelement. - Довгі значення: doc у списку обрізається до 4,000 символів, doc окремого елемента — до 20,000, а власний текст SysML елемента — до 16,000 символів.
Інструменти MCP для проєктів SysML v2
Кінцева точка MCP перелічує ці інструменти поруч з інструментами LML. Інструмент ШІ знаходить проєкти SysML v2 через list_projects (language: sysml2). Кожен інструмент приймає project.
Інструменти читання також приймають необов’язковий change_request (CR-12 або його ідентифікатор), щоб читати модель такою, якою її зробив би цей запит на зміну; propose_sysml і propose_element_changes приймають його, щоб обчислити зміну щодо моделі запиту й після рецензування застосувати її в цю чернетку. Правила див. у Запити на зміну.
| Інструмент | Доступ | Що він робить |
|---|---|---|
model_summary | Читання | Кількість елементів за метакласами, пакети верхнього рівня й кількість діагностик |
list_elements | Читання | Пошук елементів за текстом (query), type і owner; посторінково через limit і offset |
get_element | Читання | Один елемент (id) з його типами, спеціалізаціями, кратністю, значенням, кінцями, doc, текстом SysML, членами (members, не більше 200) і використаннями, типізованими ним |
get_connections | Читання | З’єднання, інтерфейси, зв’язування, потоки, послідовності, переходи, розподіли й залежності елемента (id, limit) |
list_requirements | Читання | Вимоги з їхнім ідентифікатором, формулюванням, satisfy і verify; owner, status (unsatisfied, unverified), limit, offset |
get_sysml | Читання | Текст SysML пакета верхнього рівня (root), елементів поза пакетами або одного елемента (element); line, lines (не більше 5000); відповідь дає next |
get_sysml_text | Читання | Текст SysML усієї моделі (кожен пакет верхнього рівня, потім елементи поза пакетами) або одного package, до 200,000 символів на відповідь; відповідь називає пропущені пакети |
check_sysml | Читання | Без text: діагностика моделі (ids, limit). З text (і root): синтаксичні помилки з рядком і стовпцем, а також помилки, які додав би текст. Нічого не змінює |
propose_sysml | Читання й запис | Запропонувати повний новий text пакета верхнього рівня (root) або елементів поза пакетами (без root; також туди, де з’являється новий пакет) |
propose_element_changes | Читання й запис | Запропонувати edits (не більше 100) без переписування тексту: створити, оновити, перемістити або вилучити |
list_diagrams, get_diagram і get_matrix працюють і в проєктах SysML v2: list_diagrams перелічує подання (з їхнім видом, як-от InterconnectionView) і діаграми аналізу, що зберігаються під елементом; get_diagram дає елементи, які подання показує після своїх фільтрів (за ідентифікатором елемента або кваліфікованою назвою); get_matrix дає кожну вимогу з тим, що її задовольняє й верифікує.
Інструменти пропозицій проєктів LML тут працюють так само: propose_changes надсилає пропозицію з заголовком і підсумком, discard_proposal відкидає її, а get_proposal і list_proposals показують її статус. Токен лише для читання перелічує тільки інструменти читання.
Помилки інструментів повертаються як результат інструмента з повідомленням і діагностикою, тож інструмент ШІ може виправити свій текст і спробувати знову.
Зміни елементів
Кожна зміна в edits (MCP) або {"edits": […]} (REST) — це об’єкт з op:
| op | Поля |
|---|---|
create | kind (ключове слово, як-от part, part def, attribute, port, requirement, action, package) або type (метаклас); owner (якщо пропущено: верхній рівень); name (обов’язково); необов’язкові shortName, typedBy, specializes, subsets, redefines, multiplicity, value, doc, direction (in, out, inout) |
update | id і поля для зміни, як для create; null або "" очищує поле |
move | id і новий owner |
remove | id; вилучає елемент з його членами |
typedBy,specializes,subsetsіredefines— списки до 20 імен: ідентифікаторів, кваліфікованих назв або імен, як їх записано в тексті (бібліотечні імена, як-отMassValue, працюють).- Пізніші зміни можуть називати елементи, створені раніше в тому самому виклику, як
new:1,new:2… у порядку створення, наприклад якowner. Відповідь перелічує їх уcreatedз їхніми новими ідентифікаторами. - Перейменування елемента також оновлює посилання, які називали його старим іменем.
Запропонований текст
propose_sysmlзамінює весь текст пакета. Елементи зберігають свої ідентифікатори там, де текст і далі їх оголошує. Елементи, пропущені в тексті, вилучаються.- Текст має розбиратися повністю, без незастосованих залишків. Текст, що не змінює модель, відхиляється (
no-change).
Пропозиції в проєктах SysML v2
Кожну запропоновану зміну перевіряє ядро мови, перш ніж вона потрапить до пропозиції:
- Текст розбирається без синтаксичних помилок, а зміни елементів застосовуються.
- Змінені пакети й далі друкуються як текст SysML і знову розбираються.
- Зміна не додає до моделі діагностики помилок, як-от нерозв’язаних імен чи помилок типів. Помилки, які модель уже мала, не враховуються.
Зміна, що не проходить перевірку, відхиляється з діагностикою (до 50) для виправлення. Нічого не зберігається. Попередження не спричиняють відхилення зміни.
Для пропозицій потрібні токен читання й запису та роль редактора або власника в проєкті. Одна пропозиція містить не більше 200 змін і 8 MB.
Рецензування пропозиції SysML v2
Відкрийте проєкт, потім ✦ ШІ ▾ → Переглянути “<title>”…. Кожна зміна — це рядок із прапорцем:
- Додано, Змінено і Вилучено перелічують елементи зі зміненими полями (перші 20 кожного виду; “і ще n” для решти).
- Текстова різниця з позначкою пакета показує текст SysML до й після.
- Зміна, що вилучає елементи, позначається й спочатку не позначена прапорцем.
- Відкрийте модель SysML v2, щоб застосувати цю зміну. Модель не завантажено; відкрийте сторінку SysML v2 проєкту.
- Пакета більше немає в моделі; пропущено. Пакет вилучили після того, як зміну було запропоновано.
Застосувати вибране знову синхронізує кожну текстову зміну з поточною моделлю й зберігає зміни, елементи яких ще існують. Воно перевіряє весь набір і застосовує його як один крок відміни. Зміни, які більше не підходять, пропускаються й називаються у сповіщенні. Відхилити і Пізніше працюють як для пропозицій LML, так само як ролі, термін дії (7 днів) і зберігання (див. Пропозиції від клієнтів ШІ).
Systems Modeling API
Інші інструменти SysML v2 читають і змінюють моделі Holarch через маршрути у формах OMG Systems Modeling API (REST/HTTP). Базова адреса — https://app.holarch.app/api/v1/sysml. Використовуються ті самі токени; читати може будь-яка роль у проєкті, а комітити — редактори й власники.
- Проєкти: перелічуються лише проєкти SysML v2.
@idпроєкту — це UUID, який надає цей API; ідентифікатор проєкту Holarch також працює. Відповідь міститьholarchIdіurl. - Гілки:
main— це жива модель, і її не можна змінити через API. Кожна інша гілка — це запит на зміну в роботі з назвою "CR-12 Title", що несеholarchChangeRequest(id,label,status,url). Запити на зміну, реалізовані або відкликані за останні 30 днів, ще перелічуються з установленимdeleted. - Коміти: коміт записує зміни в гілку запиту на зміну. Надаються лише вершини гілок: вершина
main— це жива модель, вершина гілки запиту на зміну — жива модель зі змінами запиту. Старіші ідентифікатори комітів відповідають404; отримайте поточну вершину з гілки. - Елементи: кожен елемент має всі властивості свого метакласу зі схеми OMG JSON, включно з похідними (
owner,ownedElement,qualifiedName,feature,typeтощо). На елементи стандартної бібліотеки посилаються за їхніми стандартними ідентифікаторами — тими, що їх інші інструменти SysML v2 використовують для того самого бібліотечного елемента. - Теги й збережені запити: немає; їхні списки порожні.
| Метод і шлях | Що він робить |
|---|---|
GET /sysml/projects | Ваші проєкти SysML v2 |
POST /sysml/projects | Створити порожній проєкт SysML v2 (name, description) |
GET /sysml/projects/<projectId> | Один проєкт з його гілкою за замовчуванням |
GET /sysml/projects/<projectId>/branches | main і гілки запитів на зміну |
POST /sysml/projects/<projectId>/branches | Створити гілку: новий запит на зміну в стані Чернетка (name — його заголовок, description — його причина) |
GET /sysml/projects/<projectId>/branches/<branchId> | Гілка (її @id або main) з head |
DELETE /sysml/projects/<projectId>/branches/<branchId> | Відкликати запит на зміну |
GET /sysml/projects/<projectId>/commits | Вершини й коміти, надіслані в гілки, спершу найновіші |
POST /sysml/projects/<projectId>/commits?branchId=<branchId> | Закомітити зміни в гілку (нижче) |
GET /sysml/projects/<projectId>/commits/<commitId> | Коміт-вершина |
GET /sysml/projects/<projectId>/commits/<commitId>/changes | Що гілка змінює порівняно з живою моделлю: по одному DataVersion на елемент |
GET /sysml/projects/<projectId>/commits/<commitId>/elements | Усі елементи коміту, посторінково |
GET /sysml/projects/<projectId>/commits/<commitId>/elements/<elementId> | Один елемент |
GET /sysml/projects/<projectId>/commits/<commitId>/roots | Елементи верхнього рівня, посторінково |
GET /sysml/projects/<projectId>/commits/<commitId>/elements/<elementId>/relationships | Зв’язки, у яких елемент є джерелом або ціллю; direction — in, out або both (за замовчуванням), посторінково |
POST /sysml/projects/<projectId>/query-results | Елементи, що відповідають запиту (тіло нижче), посторінково; commitId має бути вершиною |
GET /sysml/projects/<projectId>/tags, /queries, /commits/<commitId>/elements/<elementId>/projectUsages | Порожні списки |
Відповіді-списки — це масиви JSON. Списки розбиваються на сторінки через page[size] (за замовчуванням 100, не більше 1000) і page[after] (@id останнього елемента попередньої сторінки) або page[before] (@id першого елемента наступної сторінки). Заголовок Link дає наступну сторінку з rel="next" і попередню з rel="prev".
Запит — це об’єкт JSON з необов’язковими where (PrimitiveConstraint з property, operator (=, in, <, <=, >, >= або instanceOf), value та inverse, або CompositeConstraint з operator and чи or та constraint), scope (ідентифікатори елементів: пошук охоплює їх і те, чим вони володіють) і select (властивості, які слід повернути; @id і @type повертаються завжди):
curl -X POST -H "Authorization: Bearer hol_…" -H "Content-Type: application/json" \
"https://app.holarch.app/api/v1/sysml/projects/<projectId>/query-results" \
-d '{"@type": "Query", "where": {"@type": "PrimitiveConstraint", "property": "@type", "operator": "=", "value": "PartDefinition", "inverse": false}, "select": ["name", "qualifiedName"]}'
Читання елементів моделі:
curl -H "Authorization: Bearer hol_…" https://app.holarch.app/api/v1/sysml/projects
curl -H "Authorization: Bearer hol_…" https://app.holarch.app/api/v1/sysml/projects/<projectId>/branches/main
curl -i -H "Authorization: Bearer hol_…" "https://app.holarch.app/api/v1/sysml/projects/<projectId>/commits/<head id>/elements?page[size]=500"
Коміт змін
Для запису потрібні токен з доступом на читання й запис, роль редактора або власника, тариф Team (також для академічних і навчальних облікових записів) і ввімкнене для проєкту рецензування гілок (Запити на зміну → Налаштування). Затверджувач рецензує й застосовує запит на зміну в Holarch; токени ніколи не голосують і не застосовують.
- Створіть гілку: POST
/branchesз{"@type": "Branch", "name": "Cabin heater"}. Відповідь — гілка з їїholarchChangeRequest. - Прочитайте вершину гілки та її елементи.
- POST
/commits?branchId=<branch @id>зі спискомDataVersion:
curl -X POST -H "Authorization: Bearer hol_…" -H "Content-Type: application/json" \
"https://app.holarch.app/api/v1/sysml/projects/<projectId>/commits?branchId=<branch id>" \
-d '{"@type": "Commit", "description": "Add the heater",
"previousCommit": {"@id": "<head id>"},
"change": [{"@type": "DataVersion", "identity": {"@id": "<new uuid>"},
"payload": {"@type": "PartDefinition", "declaredName": "CabinHeater", "owner": {"@id": "<package id>"}}}]}'
- Зміна елемента: надішліть елемент таким, яким ви його прочитали, зі зміненими властивостями. Враховуються лише власні властивості (
declaredName,ownedRelationship,isAbstractтощо); похідні ігноруються, тож надсилання назад прочитаного нічого не змінює. Властивість, яку ви пропустили, зберігає своє значення; надішлітьnullабо[], щоб її очистити. - Нові елементи: дайте елементу новий UUID і або його членство-власника (надіслане в тому самому коміті), або
owner, що створює членство за вас. - Вилучення елемента:
payload: nullвилучає його разом з усім, чим він володіє. - Перевірки: кожен пакет, якого торкається коміт, має знову друкуватися й розбиратися, і коміт не має додавати діагностики помилок; інакше
422зdiagnosticsдля виправлення. - previousCommit: вершина, на якій зроблено вашу зміну. Якщо гілка відтоді змістилася, відповідь —
409stale-headз поточноюhead; прочитайте знову й закомітьте поверх неї. - Повтори: надсилайте заголовок
Idempotency-Key. Повтор з тим самим ключем і тілом протягом 24 годин знову отримує першу відповідь. - Коміти в
main: коміт безbranchIdабо зmainпотрапляє до власного чернеткового запиту на зміну вашого токена ("API changes from <token name>"), створеного під час першого такого коміту. Відповідь вказує, якого саме, уholarchChangeRequestі в заголовкуWarning. - Нові проєкти: проєкт, створений через POST
/sysml/projects, має ввімкнене рецензування гілок. Його перший коміт уmain, поки ви єдиний учасник, записується в модель напряму, один раз; пізніші коміти проходять через запити на зміну.
Надішліть запит на зміну на рецензування через POST /api/v1/projects/<project>/change-requests/<CR-12>/submit (API і MCP). Теги, об’єднання та перейменування чи видалення проєкту відповідають 405 з тим, що зробити натомість. Помилки несуть @type Error і description, як їх визначає OMG API.
Повідомлення
Діють коди з API і MCP. Маршрути й інструменти SysML v2 додають:
| Код | Статус | Значення |
|---|---|---|
wrong-project-type | 409 | Операція LML у проєкті SysML v2 або операція SysML v2 у проєкті LML |
syntax | 422 | Запропонований текст має синтаксичні помилки; діагностика вказує рядок і стовпець |
invalid-model | 422 | Зміна додає до моделі діагностику помилок; її перелічено |
not-printable | 422 | Зміну не можна записати як текст SysML |
invalid | 422 | Зміну не вдалося застосувати до моделі |
no-change | 400 | Текст не змінює модель |
too-large | 413 | Текст довший за 1,000,000 символів, або пропозиція більша за 8 MB |
too-many | 413 або 409 | Понад 100 змін в одному виклику (413), або пропозиція вже містить 200 змін (409) |
stale | 409 | Попередня текстова зміна пропозиції більше не застосовується до моделі |
not-found | 404 | Немає такого проєкту, елемента, гілки чи коміту (Systems Modeling API надає лише вершини гілок) |
not-writable | 405 | Теги, об’єднання, перейменування чи видалення проєкту через Systems Modeling API; зробіть це в Holarch |
main-protected | 405 | Видалення main; видаліть натомість гілку запиту на зміну |
stale-head | 409 | Гілка змістилася з часу previousCommit; прочитайте її head і закомітьте знову |
branch-base | 409 | Нова гілка має починатися з вершини main |
branch-review-off | 409 | Проєкт не використовує рецензування гілок; власник вмикає його в Запити на зміну → Налаштування |
cr-not-draft | 409 | Запит на зміну надіслано або закрито; записувати в нього можна лише в стані Чернетка або Відхилено |
cr-full | 409 | Запит на зміну містить 5,000 змінених елементів, або проєкт — 20 MB чернеток запитів на зміну |
plan-limit | 403 | Запис у запити на зміну потребує тарифу Team |
orphan | 422 | Новий елемент не має власника; надішліть його членство-власника або owner |
unknown-metaclass | 422 | @type корисного навантаження не є метакласом SysML v2 |
idempotency-key-reused | 422 | Idempotency-Key уже використано з іншим тілом; надішліть новий ключ |
token-projects | 403 | Токен, обмежений списком проєктів, не може створити проєкт |
bad-request | 400 | Відсутнє або неправильне значення, як-от root, що не є пакетом верхнього рівня, невідомий op або новий елемент без назви |
Обмеження
| Що | Обмеження |
|---|---|
| Елементів, вимог або з’єднань на сторінку | 500 |
| Членів, перелічених з елементом | 200 |
| Діагностик на відповідь | 500 |
| Рядків тексту SysML на відповідь | 5,000, і не більше 400,000 байтів (обрізається по рядку) |
| Текст doc | 4,000 символів у списках, 20,000 для одного елемента |
| Власний текст SysML елемента | 16,000 символів |
Текст в одному виклику propose_sysml | 1,000,000 символів |
| Змін в одному виклику | 100 |
| Елементів, перелічених як додані, змінені або вилучені в одній зміні | по 300 |
| Змін в одній пропозиції | 200 і 8 MB |
| Сторінка Systems Modeling API | 1,000 елементів (за замовчуванням 100) |
| DataVersion в одному коміті | 5,000 |
| Змінених елементів в одному запиті на зміну | 5,000 |
| Тіло коміту | 32 MB |
Обмеження частоти, розміру запиту й правила токенів — ті самі, що в API і MCP.
Пов’язані сторінки
- API і MCP
- Початок роботи з проєктами SysML v2
- Текстовий редактор і Оглядач
- Обмін моделями SysML v2
- Вимоги та верифікація в проєктах SysML v2
SysML® і OMG® — зареєстровані торговельні марки Object Management Group, Inc. у США та інших країнах.