Вимоги
Зв’язки з іншими проєктами
Простежуйте елемент до вимоги, функції чи тесту в іншому проєкті; кожна людина бачить пов’язаний елемент, лише якщо може відкрити його проєкт.
Огляд
Зв’язок з іншим проєктом — це зв’язок простеження від елемента цього проєкту до елемента іншого проєкту, як-от вимога підсистеми, traced from вимоги в специфікації системи, або процедура тестування, що verifies вимогу, яку веде інша команда.
Зв’язок є частиною цього проєкту. Він зберігає лише ідентифікатори двох елементів і зв’язок. Номер, назва, клас і статус зв’язаного елемента зчитуються з його власного проєкту щоразу, коли ви дивитеся, з вашими власними правами доступу:
- Якщо ви можете відкрити інший проєкт, ви бачите елемент і можете перейти до нього.
- Якщо не можете, ви бачите Елемент у проєкті, який ви не можете відкрити. Назва ніколи до вас не потрапляє — ні в застосунку, ні в експорті, ні через API, ні через інструменти ШІ.
Зв’язки з іншими проєктами входять до тарифу Team. Вирішує тариф власника проєкту. На інших тарифах наявні зв’язки залишаються видимими й їх можна вилучити, але нові додати не можна. Зв’язки між демонстраційними проєктами Hybrid Car і Hybrid Car Battery Pack працюють на кожному тарифі.
Поняття
Що містить зв’язок
| Частина | Значення |
|---|---|
| Джерело | Елемент цього проєкту |
| Зв’язок | Зв’язок зі схеми цього проєкту, як-от traced from, satisfies або verified by |
| Ціль | Ідентифікатор проєкту та ідентифікатор елемента в ньому |
Зв’язок перевіряється щодо класу джерела. Клас цілі під час створення зв’язку не перевіряється, бо зв’язок ніколи не читає вміст іншого проєкту. Коли клас цілі не відповідає зв’язку, розділ Трасування показує ⚠ з “Цей зв’язок зазвичай не вказує на …”.
Хто що бачить
Кожна людина бачить кожен зв’язаний елемент із тією роллю, яку вона має в його проєкті:
| Ваш доступ до іншого проєкту | Що ви бачите |
|---|---|
| Будь-яка роль (власник, редактор, рецензент, читач) | Номер, назва, проєкт і посилання, що відкриває елемент |
| Немає, або проєкт більше не існує | Елемент у проєкті, який ви не можете відкрити |
Проєкт, якого не існує, і проєкт, який ви не можете відкрити, виглядають однаково, тож зв’язок ніколи не повідомляє вам, що проєкт існує.
Стани зв’язків
| Показано | Значення | Що робити |
|---|---|---|
| Номер і назва | Елемент існує, і ви можете відкрити його проєкт | Нічого |
| Видалено в <project> | Елемент у кошику свого проєкту | Попросіть когось, хто може редагувати той проєкт, відновити його, або вилучіть зв’язок |
| Видалено | Елемент більше не існує | Вилучіть зв’язок (Вилучити розірвані зв’язки) |
| Елемент у проєкті, який ви не можете відкрити | Ви не маєте доступу до проєкту, або він більше не існує | Якщо потрібно, попросіть доступ у власника проєкту |
| Завантаження… | Елемент зчитується | Зачекайте трохи |
Назви зчитуються, коли сторінка показує зв’язок, знову — коли ви повертаєтеся на вкладку через хвилину, і кожні п’ять хвилин. Перейменований елемент показує нову назву без жодних змін у цьому проєкті.
Змінені цілі
Рядок показує Змінено, коли зв’язаний елемент редагували в його проєкті після створення зв’язку чи останнього перегляду. Наведіть вказівник, щоб побачити дату. Перевірте, що зв’язок усе ще дійсний, потім:
- Натисніть ✓ у рядку, щоб позначити цей зв’язок перевіреним.
- Натисніть ⋯ поруч з Інші проєкти, потім Позначити всі перевіреними (n) для всіх позначених зв’язків елемента.
- Або відкрийте Потреби та вимоги → Зв’язки для перевірки: картка Змінено в інших проєктах перелічує всі позначені зв’язки проєкту з ✓ у кожному рядку та Позначити всі перевіреними.
Позначення перевіреним показується в історії елемента та в “Діяльності”, і одне натискання “Відмінити” повертає його назад. Рецензенти й читачі бачать позначки, але не можуть їх зняти. Зв’язки з випусками бібліотек не позначаються (випуск не змінюється).
Як користуватися
Коли й навіщо
Використовуйте зв’язки з іншими проєктами, коли одна модель була б завеликою або належить різним командам: специфікація системи та специфікації її підсистем, спільні вимоги лінійки продуктів і кожен продукт або вимоги замовника та ваш проєкт. Зберігайте зв’язки в проєкті нижчого рівня, спрямовуючи їх угору: кожна підсистема простежує свої вимоги від системних вимог.
Усередині одного проєкту використовуйте звичайні зв’язки. Зв’язати наявний… у розділі Трасування пов’язує елементи того самого проєкту; зв’язок з іншим проєктом — для елементів, що містяться деінде.
Додавання зв’язку
- Виберіть елемент, наприклад вимогу підсистеми.
- В інспекторі відкрийте розділ Трасування. У розділі Інші проєкти натисніть + (Додати зв’язок з іншим проєктом…).
- Виберіть Зв’язок, наприклад traced from.
- Виберіть Проєкт. Його елементи перелічено за номерами.
- Для бібліотеки виберіть Версія: Поточна (робоча копія) або випуск, наприклад Release 1.1. Зв’язок із випуском показує його позначку замість поточна, а його назва не відкриває сторінку.
- Введіть текст у Пошук, щоб знайти елемент за номером або назвою. Виберіть Клас, щоб перелічити лише цей клас.
- Клацніть елемент, потім натисніть Додати зв’язок. Сповіщення показує “Зв’язок додано.”, а елемент з’являється в розділі Інші проєкти.
Одне натискання “Відмінити” вилучає зв’язок. Повторне додавання того самого зв’язку зберігає наявний.
Відкриття зв’язаного елемента
Клацніть назву зв’язаного елемента. Його проєкт відкривається на цьому елементі.
Вилучення зв’язків
- Натисніть × у рядку зв’язку, щоб вилучити один зв’язок.
- Коли зв’язки вказують на видалені елементи, натисніть ⋯ поруч з Інші проєкти, потім Вилучити розірвані зв’язки (n).
Вилучення зв’язку змінює лише цей проєкт. Інший проєкт зв’язок ніколи не змінює.
Приклад: підсистема корисного навантаження та демо CubeSat EO-1
- Створіть проєкт з назвою EO-1 Payload з вимогою PL.1 Detector pixel pitch shall be at most 5.5 µm.
- Виберіть PL.1, відкрийте Трасування → Інші проєкти → +.
- Виберіть traced from, проєкт CubeSat EO-1, знайдіть ground sample і клацніть 1.2 Ground Sample Distance. Натисніть Додати зв’язок.
- Рядок показує traced from 1.2 Ground Sample Distance CubeSat EO-1 · поточна. Колега, який може відкрити лише EO-1 Payload, бачить у тому самому рядку Елемент у проєкті, який ви не можете відкрити.
Поради та добрі практики
- Зв’язуйте від нижчого рівня до вищого, щоб системний проєкт не доводилося змінювати, коли додається підсистема.
- Надайте проєкт вищого рівня з роллю читача тим, хто працює над проєктом нижчого рівня, щоб вони бачили назви.
- Запускайте Вилучити розірвані зв’язки після реорганізації проєкту вищого рівня.
Типові помилки
| Проблема | Причина | Виправлення |
|---|---|---|
| “Цей елемент є в цьому проєкті. Скористайтеся натомість “Зв’язати наявний…”.” | Ціль у тому самому проєкті | Скористайтеся Зв’язати наявний… у групі зв’язку |
| Немає + у розділі Інші проєкти | Ви можете лише переглядати проєкт, або елемент заблоковано | Попросіть роль редактора або розблокуйте елемент |
| “Зв’язки з елементами інших проєктів входять до тарифу Team.” | Власник проєкту не на тарифі Team | Перейдіть на вищий тариф у Налаштування облікового запису → Тариф і оплата |
| Засіб вибору показує “Цей проєкт не вдається прочитати. Виберіть інший проєкт.” | Ви втратили доступ до того проєкту | Попросіть доступ у його власника |
Як це пов’язано з іншими функціями
- Матриця простежуваності: зв’язки від рядків за вибраними зв’язками перелічено під сіткою в розділі Інші проєкти; Експортувати… додає їх (див. Простежуваність).
- Діаграма Spider: зв’язані елементи з’являються як пунктирні прямокутники навколо свого елемента; вимкніть їх через Параметри → Інші проєкти.
- Карта програми: Керування проєктами → Карта програми показує, як пов’язані всі ваші проєкти, а Інші проєкти ⋯ → Показати на Карті програми простежує цей елемент через інші проєкти (див. Карта програми).
- Покриття програми: проєкт, з яким ви зв’язуєтеся, перелічує ці зв’язки на Верифікація → Покриття програми за елементами й проєктами (див. Покриття програми).
- Історія та діяльність: додавання й вилучення зв’язку записується на елементі.
- Кошик: видалення елемента переміщує його зв’язки в кошик разом із ним; відновлення елемента відновлює їх.
- Запити на зміну: Додати зміну ▾ → Додати зв’язок з іншим проєктом… і Вилучити зв’язок з іншим проєктом… готують зв’язки; їх додають або вилучають, коли запит застосовано.
- Бібліотеки: зв’язуйтеся з елементом випуску бібліотеки через вибір Версія (див. Бібліотеки).
Експорт і звіти
Експорт називає зв’язані елементи з правами доступу того, хто експортує. Усе, що ця людина не може прочитати, записується як “Елемент в іншому проєкті”.
| Експорт | Що відбувається зі зв’язками з іншими проєктами |
|---|---|
| JSON проєкту (експорт бази даних) | Зберігаються як є: лише ідентифікатори. Імпорт файлу їх зберігає |
| ReqIF (база даних і документи) | Атрибут External links на кожному зв’язаному елементі: зв’язок, ідентифікатор проєкту й ідентифікатор елемента, а також номер і назва, якщо ви можете їх прочитати |
| XMI | Не включаються; звіт про експорт рахує їх як “Зв’язок з іншим проєктом” |
| Матриця простежуваності (Excel) | Окремий аркуш Other projects |
| Матриця простежуваності (CSV) | Стовпець Other projects |
| Звіт RTM (матриця простежуваності вимог) | Стовпець Other Projects |
API і MCP
API і MCP повертають зв’язки як ідентифікатори. Щоб прочитати назви, викличте операцію resolve; вона використовує власні права доступу та список проєктів токена. Карта програми та простежування елемента доступні як GET /api/v1/program-map, GET /api/v1/projects/<project>/items/<item>/trace та інструменти MCP program_map і trace_chain. Див. API і MCP.
Функції ШІ в застосунку отримують зв’язки лише як ідентифікатори.
Повідомлення
| Повідомлення | Значення |
|---|---|
| Зв’язок додано. | Зв’язок збережено |
| Цей елемент є в цьому проєкті. Скористайтеся натомість “Зв’язати наявний…”. | Вибраний елемент є в тому самому проєкті |
| Виберіть елемент, потім додайте зв’язок. | Натиснуто Додати зв’язок без вибору елемента |
| Немає інших проєктів для зв’язку. Спершу створіть або відкрийте інший проєкт. | У вас є лише цей проєкт |
| Зв’язки з елементами інших проєктів входять до тарифу Team. | Власник проєкту не на тарифі Team |
| Проєкт містить щонайбільше 20 000 зв’язків з іншими проєктами. Спершу вилучіть деякі. | Проєкт досяг обмеження |
Обмеження
| Обмеження | Значення |
|---|---|
| Зв’язків на проєкт | 20,000 |
| Елементів, що зчитуються за запит | 500 |
| Елементів у засобі вибору | 100 на пошук (звузьте пошук, щоб побачити інші) |
Зв’язок вказує на поточну версію іншого проєкту або на копію елемента у випуску бібліотеки (див. Бібліотеки).