Holarch

Вимоги

Карта програми

Дивіться, як ваші проєкти пов’язані між собою, з кількістю зв’язків для кожної пари проєктів, і простежуйте ланцюжок зв’язків одного елемента через інші проєкти.

Як цим користуватися →

На цій сторінці
  1. Огляд
  2. Поняття
    1. Що показує карта
    2. Хто що бачить
    3. Кольори
  3. Як користуватися
    1. Як зв’язані ваші проєкти
    2. Почати з одного проєкту
    3. Простеження одного елемента через програму
    4. Приклад: демо CubeSat EO-1 і проєкт корисного навантаження
    5. Приклад: Hybrid Car і його акумуляторна батарея
    6. Поради та добрі практики
    7. Типові помилки
    8. Як це пов’язано з іншими функціями
  4. Сторінка “Карта програми”
    1. Панель
    2. Граф
    3. Таблиця
    4. Інспектор
  5. API і MCP
  6. Повідомлення
  7. Обмеження
  8. Пов’язане

Огляд

Програму, що охоплює кілька проєктів (системний проєкт, проєкти підсистем, тестовий проєкт, бібліотеки), об’єднують зв’язки з іншими проєктами. Кожен зв’язок зберігається в проєкті, що його створює, тож жоден окремий проєкт не показує повної картини. Карта програми показує: вона малює один прямокутник на кожен проєкт, який ви можете відкрити, і одну стрілку на кожну пару проєктів із підписом зв’язку та кількості зв’язків.

Сторінка має два подання:

  • Проєкти: усі проєкти, які ви можете відкрити, і зв’язки між ними — як граф або таблиця.
  • Простежування елемента: один елемент посередині та зв’язані з ним елементи в інших проєктах, кільце за кільцем, до шести кроків назовні.

Карта програми доступна кожному, хто ввійшов. Самі зв’язки створюються на тарифі Team; зв’язки, збережені в проєкті, тариф власника якого їх не включає, малюються сірим. Зв’язки між демонстраційними проєктами Hybrid Car і Hybrid Car Battery Pack працюють на кожному тарифі.

Поняття

Що показує карта

ЕлементЗначення
ПрямокутникПроєкт, який ви можете відкрити: його назва, тип проєкту й кількість елементів; його доступна назва додає зв’язки, які він містить і отримує
СтрілкаЗв’язки, збережені в проєкті біля хвоста стрілки, що вказують на елементи проєкту біля її вістря
Підпис стрілкизв’язок · зв’язки · видалено, наприклад traced from · 12 · 1 видалено
Проєкти, які ви не можете відкрити (N зв’язків)Один пунктирний прямокутник, що рахує всі зв’язки з проєктами, які ви не можете відкрити
Прямокутник випуску бібліотекиВипуск бібліотеки, який ви можете читати і з яким зв’язані ваші проєкти

Стрілки зазвичай спрямовані вгору: проєкти підсистем зберігають зв’язки traced from і satisfies із системним проєктом, а тестові проєкти — зв’язки verifies. Карта розміщує проєкти, що містять зв’язки, нижче проєктів, на які вони вказують.

Хто що бачить

Карта будується лише з проєктів, які ви можете відкрити: проєкт, учасником якого ви є з будь-якою роллю, не в кошику, і правило двоетапного входу організації якого ви виконуєте.

  • Зв’язок із проєктом, який ви не можете відкрити, рахується в Проєкти, які ви не можете відкрити (N зв’язків). Цей прямокутник ніколи не називає проєкт чи елемент і виглядає однаково, чи проєкт існує, чи він у кошику, чи його ніколи не було.
  • Зв’язки, збережені в проєкті, який ви не можете відкрити, ніде не рахуються, навіть якщо вони вказують на ваші проєкти.
  • Роль адміністратора організації нічого не додає: карта використовує участь у проєктах.
  • Експорт (CSV, SVG, PNG) містить рівно те, що показує сторінка.

Кольори

КолірЗначення
Синя стрілкаЗв’язки між проєктами, які ви можете відкрити
Бурштинова стрілкаЧастину цілей видалено (у кошику або зникли)
Сіра стрілкаЗв’язки з проєктами, які ви не можете відкрити, з випуском бібліотеки або збережені в проєкті, тариф власника якого не включає зв’язків з іншими проєктами

Як користуватися

  1. Натисніть Керування проєктами, потім Карта програми. Відкривається подання Проєкти з усіма проєктами, що містять або отримують зв’язки.
  2. Прочитайте стрілки. Наведіть вказівник на прямокутник, щоб затемнити все, що з ним не з’єднано.
  3. Клацніть стрілку. Інспектор перелічує її зв’язки по 100: елемент, що містить кожен зв’язок, зв’язок і цільовий елемент. Клацніть будь-який елемент, щоб відкрити його в його проєкті, або Показати більше, щоб побачити наступні 100.
  4. Натисніть Експортувати CSV в інспекторі, щоб зберегти зв’язки цієї стрілки, або Експорт ▾ на панелі, щоб зберегти всю карту як CSV, SVG або PNG.

Почати з одного проєкту

  1. Відкрийте проєкт, потім Верифікація → Покриття програми і натисніть Відкрити карту програми.
  2. Карта показує лише цей проєкт і пов’язані з ним проєкти — безпосередньо або через інші.
  3. Натисніть Показати всі проєкти, щоб побачити все, що ви можете відкрити.

Можна також клацнути прямокутник і вибрати Показати лише пов’язані проєкти.

Простеження одного елемента через програму

  1. Виберіть елемент. У розділі Трасування інспектора відкрийте Інші проєкти ⋯ і виберіть Показати на Карті програми. Зі списку зв’язків стрілки натомість натисніть Простежити цей елемент.
  2. Подання Простежування елемента показує елемент посередині та зв’язані з ним елементи кільцями: перше кільце — на один крок назовні, друге — на два. Зв’язки відстежуються в обох напрямках.
  3. Виберіть Кроки (від 1 до 6, типово 3), щоб піти далі або залишитися ближче.
  4. Елементи розфарбовано за проєктами, з пунктирним прямокутником навколо елементів кожного проєкту. Зніміть позначку Групувати за проєктом, щоб прибрати прямокутники.
  5. Клацніть елемент, щоб побачити Відкрити елемент і Простежити звідси, що ставить його посередині.

Приклад: демо CubeSat EO-1 і проєкт корисного навантаження

  1. Створіть демо CubeSat EO-1, потім другий проєкт EO-1 Payload з вимогою PL.1 Imager resolution.
  2. В EO-1 Payload виберіть PL.1. У Трасування → Інші проєкти натисніть +, виберіть traced from, проєкт CubeSat і його вимогу до зйомки й натисніть Додати зв’язок.
  3. Створіть третій проєкт EO-1 Test Campaign з тестовим випадком TC.4 Resolution test і зв’яжіть його через verifies з PL.1 в EO-1 Payload.
  4. Відкрийте Керування проєктами → Карта програми. Карта показує EO-1 Test Campaign унизу, EO-1 Payload над ним і проєкт CubeSat угорі зі стрілками verifies · 1 і traced from · 1.
  5. Натисніть PL.1 → Трасування ⋯ → Показати на Карті програми: тестовий випадок і вимога CubeSat розташовані на один крок назовні, з обох боків.

Приклад: Hybrid Car і його акумуляторна батарея

  1. У Керування проєктами натисніть Файли проєктів ▾ → Новий демопроєкт → Hybrid Car (SysML v2).
  2. Потім створіть Файли проєктів ▾ → Новий демопроєкт → Hybrid Car Battery Pack (SysML v2). Вимоги постачальника батареї до блока PackCapacity, PackMass і ChargeAcceptance зв’язано через traced from з вимогами автомобіля VR-3, VR-6 і VR-5 у вашому найновішому демо Hybrid Car, незалежно від того, яке з двох ви створите першим; повторне створення демо Hybrid Car переносить зв’язки на нове. Ці демонстраційні зв’язки працюють на кожному тарифі. Без проєкту Hybrid Car демо батареї не має зв’язків.
  3. Відкрийте Керування проєктами → Карта програми. Карта показує два проєкти 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 (див. Зв’язки з іншими проєктами)