Вимоги
Карта програми
Дивіться, як ваші проєкти пов’язані між собою, з кількістю зв’язків для кожної пари проєктів, і простежуйте ланцюжок зв’язків одного елемента через інші проєкти.
На цій сторінці
Огляд
Програму, що охоплює кілька проєктів (системний проєкт, проєкти підсистем, тестовий проєкт, бібліотеки), об’єднують зв’язки з іншими проєктами. Кожен зв’язок зберігається в проєкті, що його створює, тож жоден окремий проєкт не показує повної картини. Карта програми показує: вона малює один прямокутник на кожен проєкт, який ви можете відкрити, і одну стрілку на кожну пару проєктів із підписом зв’язку та кількості зв’язків.
Сторінка має два подання:
- Проєкти: усі проєкти, які ви можете відкрити, і зв’язки між ними — як граф або таблиця.
- Простежування елемента: один елемент посередині та зв’язані з ним елементи в інших проєктах, кільце за кільцем, до шести кроків назовні.
Карта програми доступна кожному, хто ввійшов. Самі зв’язки створюються на тарифі Team; зв’язки, збережені в проєкті, тариф власника якого їх не включає, малюються сірим. Зв’язки між демонстраційними проєктами Hybrid Car і Hybrid Car Battery Pack працюють на кожному тарифі.
Поняття
Що показує карта
| Елемент | Значення |
|---|---|
| Прямокутник | Проєкт, який ви можете відкрити: його назва, тип проєкту й кількість елементів; його доступна назва додає зв’язки, які він містить і отримує |
| Стрілка | Зв’язки, збережені в проєкті біля хвоста стрілки, що вказують на елементи проєкту біля її вістря |
| Підпис стрілки | зв’язок · зв’язки · видалено, наприклад traced from · 12 · 1 видалено |
| Проєкти, які ви не можете відкрити (N зв’язків) | Один пунктирний прямокутник, що рахує всі зв’язки з проєктами, які ви не можете відкрити |
| Прямокутник випуску бібліотеки | Випуск бібліотеки, який ви можете читати і з яким зв’язані ваші проєкти |
Стрілки зазвичай спрямовані вгору: проєкти підсистем зберігають зв’язки traced from і satisfies із системним проєктом, а тестові проєкти — зв’язки verifies. Карта розміщує проєкти, що містять зв’язки, нижче проєктів, на які вони вказують.
Хто що бачить
Карта будується лише з проєктів, які ви можете відкрити: проєкт, учасником якого ви є з будь-якою роллю, не в кошику, і правило двоетапного входу організації якого ви виконуєте.
- Зв’язок із проєктом, який ви не можете відкрити, рахується в Проєкти, які ви не можете відкрити (N зв’язків). Цей прямокутник ніколи не називає проєкт чи елемент і виглядає однаково, чи проєкт існує, чи він у кошику, чи його ніколи не було.
- Зв’язки, збережені в проєкті, який ви не можете відкрити, ніде не рахуються, навіть якщо вони вказують на ваші проєкти.
- Роль адміністратора організації нічого не додає: карта використовує участь у проєктах.
- Експорт (CSV, SVG, PNG) містить рівно те, що показує сторінка.
Кольори
| Колір | Значення |
|---|---|
| Синя стрілка | Зв’язки між проєктами, які ви можете відкрити |
| Бурштинова стрілка | Частину цілей видалено (у кошику або зникли) |
| Сіра стрілка | Зв’язки з проєктами, які ви не можете відкрити, з випуском бібліотеки або збережені в проєкті, тариф власника якого не включає зв’язків з іншими проєктами |
Як користуватися
Як зв’язані ваші проєкти
- Натисніть Керування проєктами, потім Карта програми. Відкривається подання Проєкти з усіма проєктами, що містять або отримують зв’язки.
- Прочитайте стрілки. Наведіть вказівник на прямокутник, щоб затемнити все, що з ним не з’єднано.
- Клацніть стрілку. Інспектор перелічує її зв’язки по 100: елемент, що містить кожен зв’язок, зв’язок і цільовий елемент. Клацніть будь-який елемент, щоб відкрити його в його проєкті, або Показати більше, щоб побачити наступні 100.
- Натисніть Експортувати CSV в інспекторі, щоб зберегти зв’язки цієї стрілки, або Експорт ▾ на панелі, щоб зберегти всю карту як CSV, SVG або PNG.
Почати з одного проєкту
- Відкрийте проєкт, потім Верифікація → Покриття програми і натисніть Відкрити карту програми.
- Карта показує лише цей проєкт і пов’язані з ним проєкти — безпосередньо або через інші.
- Натисніть Показати всі проєкти, щоб побачити все, що ви можете відкрити.
Можна також клацнути прямокутник і вибрати Показати лише пов’язані проєкти.
Простеження одного елемента через програму
- Виберіть елемент. У розділі Трасування інспектора відкрийте Інші проєкти ⋯ і виберіть Показати на Карті програми. Зі списку зв’язків стрілки натомість натисніть Простежити цей елемент.
- Подання Простежування елемента показує елемент посередині та зв’язані з ним елементи кільцями: перше кільце — на один крок назовні, друге — на два. Зв’язки відстежуються в обох напрямках.
- Виберіть Кроки (від 1 до 6, типово 3), щоб піти далі або залишитися ближче.
- Елементи розфарбовано за проєктами, з пунктирним прямокутником навколо елементів кожного проєкту. Зніміть позначку Групувати за проєктом, щоб прибрати прямокутники.
- Клацніть елемент, щоб побачити Відкрити елемент і Простежити звідси, що ставить його посередині.
Приклад: демо CubeSat EO-1 і проєкт корисного навантаження
- Створіть демо CubeSat EO-1, потім другий проєкт EO-1 Payload з вимогою PL.1 Imager resolution.
- В EO-1 Payload виберіть PL.1. У Трасування → Інші проєкти натисніть +, виберіть traced from, проєкт CubeSat і його вимогу до зйомки й натисніть Додати зв’язок.
- Створіть третій проєкт EO-1 Test Campaign з тестовим випадком TC.4 Resolution test і зв’яжіть його через verifies з PL.1 в EO-1 Payload.
- Відкрийте Керування проєктами → Карта програми. Карта показує EO-1 Test Campaign унизу, EO-1 Payload над ним і проєкт CubeSat угорі зі стрілками verifies · 1 і traced from · 1.
- Натисніть PL.1 → Трасування ⋯ → Показати на Карті програми: тестовий випадок і вимога CubeSat розташовані на один крок назовні, з обох боків.
Приклад: Hybrid Car і його акумуляторна батарея
- У Керування проєктами натисніть Файли проєктів ▾ → Новий демопроєкт → Hybrid Car (SysML v2).
- Потім створіть Файли проєктів ▾ → Новий демопроєкт → Hybrid Car Battery Pack (SysML v2). Вимоги постачальника батареї до блока PackCapacity, PackMass і ChargeAcceptance зв’язано через traced from з вимогами автомобіля VR-3, VR-6 і VR-5 у вашому найновішому демо Hybrid Car, незалежно від того, яке з двох ви створите першим; повторне створення демо Hybrid Car переносить зв’язки на нове. Ці демонстраційні зв’язки працюють на кожному тарифі. Без проєкту Hybrid Car демо батареї не має зв’язків.
- Відкрийте Керування проєктами → Карта програми. Карта показує два проєкти SysML v2 зі стрілкою traced from · 3.
Поради та добрі практики
- Домовтеся про зв’язки, які використовують підпроєкти (traced from або satisfies для вимог, verifies для тестів), щоб стрілки скрізь читалися однаково.
- Вимкніть Групувати зв’язки, щоб бачити одну стрілку на зв’язок, наприклад щоб відрізнити зв’язки вимог від зв’язків тестів між тими самими двома проєктами.
- Перетягуйте прямокутники, щоб упорядкувати карту. Позиції зберігаються в цьому браузері для кожної області.
- Використовуйте подання Таблиця, щоб сортувати пари проєктів за кількістю зв’язків або видалених цілей.
- Бурштинова стрілка означає зв’язки, що потребують виправлення: відкрийте її список зв’язків, потім виправте або вилучіть зв’язки в Трасування → Інші проєкти елемента.
Типові помилки
| Проблема | Причина | Виправлення |
|---|---|---|
| Проєкт відсутній | Ви не учасник проєкту, він у кошику або не має зв’язків | Попросіть доступ у власника; позначте Показати непов’язані проєкти, щоб перелічити проєкти без зв’язків |
| Усе потрапляє в Проєкти, які ви не можете відкрити | Зв’язки вказують на проєкти, учасником яких ви не є | Попросіть доступ у власника проєкту |
| Сірі стрілки посередині карти | Проєкт, що містить зв’язки, має власника без тарифу Team | Власник переходить на вищий тариф у Налаштування облікового запису → Тариф і оплата |
| Новий зв’язок ще не показується | Карта ще зчитує нещодавні зміни | Через хвилину натисніть Оновити |
Як це пов’язано з іншими функціями
- Зв’язки з іншими проєктами: карта їх зчитує; вона нічого не додає й не змінює. Створюйте зв’язки в Трасування → Інші проєкти елемента (див. Зв’язки з іншими проєктами).
- Покриття програми: подання за елементами для зв’язків, що ведуть в один проєкт, з прогалинами (див. Покриття програми). Відкрити карту програми там запускає карту з цього проєкту.
- Бібліотеки: зв’язки з елементом випуску бібліотеки з’являються як стрілки до прямокутника випуску (див. Бібліотеки).
- Діаграма Spider: простеження всередині проєкту з пунктирними прямокутниками для зв’язаних елементів деінде. Простежування елемента використовує те саме кільцеве компонування.
- API і MCP: та сама карта й простеження для інструментів (див. API і MCP).
Сторінка “Карта програми”
Панель
| Елемент керування | Що він робить |
|---|---|
| Проєкти / Простежування елемента | Перемикає подання |
| Область | Усі мої проєкти, одна організація (якщо ви належите до неї) або одна папка з її підпапками (якщо у вас є папки; див. Папки проєктів) |
| Показати всі проєкти | Показується після відкриття карти з проєкту; виходить із набору пов’язаних проєктів цього проєкту |
| Показати непов’язані проєкти | Показує також проєкти без зв’язків |
| Групувати зв’язки | Одна стрілка на пару проєктів (підписи перелічують кожен зв’язок) або одна стрілка на зв’язок |
| Кроки | Простежування елемента: від 1 до 6 кроків назовні |
| Групувати за проєктом | Простежування елемента: пунктирні прямокутники навколо елементів кожного проєкту |
| Граф / Таблиця | Діаграма або таблиця з сортуванням; на вузькому екрані спочатку відкривається таблиця |
| Оновити | Знову зчитує зв’язки |
| Експорт ▾ | Експортувати CSV, Експортувати SVG, Експортувати PNG |
Граф
- Клацніть прямокутник, щоб показати його проєкт в інспекторі: Відкрити проєкт і Показати лише пов’язані проєкти. Двічі клацніть прямокутник або натисніть на ньому Shift+Enter, щоб відкрити проєкт.
- Клацніть стрілку, щоб перелічити її зв’язки в інспекторі.
- Перетягуйте прямокутники, щоб переміщувати їх; прокручуйте або зводьте пальці, щоб масштабувати; перетягуйте тло, щоб панорамувати.
- Натисніть Tab, щоб перейти до карти, потім клавіші зі стрілками, щоб переміщатися між прямокутниками й стрілками; Enter переходить до інспектора. Кожен прямокутник і стрілка має назву, яку читає програма зчитування з екрана, наприклад “EO-1 Payload, проєкт LML, 1 зв’язок назовні, 1 всередину”.
Таблиця
| Подання | Стовпці |
|---|---|
| Проєкти | Вихідний проєкт, Зв’язок, Цільовий проєкт, Зв’язки, Видалено |
| Простежування елемента | Проєкт, Number, Name, Клас, Кроки від елемента, Стан |
Клацніть заголовок стовпця, щоб сортувати.
Інспектор
| Виділення | Зміст |
|---|---|
| Поле проєкту | Назва, тип, кількість елементів, зв’язки назовні й усередину; Відкрити проєкт, Показати лише пов’язані проєкти |
| Стрілка | Вихідний і цільовий проєкт, зв’язки за типом зв’язку, список зв’язків (по 100, Показати більше), Експортувати CSV, Простежити цей елемент у кожному рядку |
| Елемент (простежування елемента) | Номер і назва, клас, проєкт, кроки від простежуваного елемента, стан; Відкрити елемент, Простежити звідси |
| Проєкти, які ви не можете відкрити | “Зв’язки з проєктами, які ви не можете відкрити. Попросіть доступ у власника проєкту.” |
API і MCP
REST API і MCP дають ті самі відповіді з власними правами доступу та списком проєктів токена. Проєкти організації, що вимкнула доступ до API, не включаються, як і проєкти, які ви не можете відкрити.
| Виклик | Повертає |
|---|---|
GET /api/v1/program-map | Проєкти, випуски, стрілки (from, to, relation, links, deleted, plan) і кількість прихованих; from, unlinked, org — як на сторінці |
GET /api/v1/projects/<project>/items/<item>/trace | Простежування елемента: вузли з проєктом, номером, назвою, класом і кроками, зв’язки між ними та кількість прихованих; steps 1–6 (типово 3) |
MCP program_map | Те саме, що GET /program-map |
MCP trace_chain | Те саме, що виклик trace; елементи в проєктах із грифами регульованих даних відповідають withheld |
Див. API і MCP.
Повідомлення
| Повідомлення | Значення |
|---|---|
| Між вашими проєктами немає зв’язків. Додайте зв’язок у розділі “Трасування” елемента. | Жоден із ваших проєктів не містить і не отримує зв’язків, які ви можете бачити |
| Цей проєкт не має зв’язків з іншими проєктами. Додайте зв’язок у розділі “Трасування” елемента. | Карту відкрито з проєкту без зв’язків |
| Цей елемент не має зв’язків з іншими проєктами. Додайте зв’язок у його розділі “Трасування”. | Простежуваний елемент не має зв’язків |
| Деякі проєкти ще зчитуються. Оновіть за хвилину. | Нещодавні зміни у великих проєктах ще зчитуються; карта показує те, що готово |
| Показано перші 500 елементів. Зменште кількість кроків. | Простежування елемента досягло обмеження |
| N зв’язків із проєктів, тариф власника яких не включає зв’язків з іншими проєктами, не відстежуються. | Простежування елемента пропустило зв’язки, збережені на тарифі без них |
| Не вдалося прочитати карту програми. Перезавантажте сторінку. | Запит не вдався |
Обмеження
| Обмеження | Значення |
|---|---|
| Кроки простежування елемента | Від 1 до 6 |
| Елементів у простежуванні елемента | 500 |
| Зв’язків на сторінку в списку стрілки | 100 |
| Зв’язків на проєкт | 20 000 (див. Зв’язки з іншими проєктами) |