Holarch

Вимоги

Зв’язки з іншими проєктами

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

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

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

Огляд

Зв’язок з іншим проєктом — це зв’язок простеження від елемента цього проєкту до елемента іншого проєкту, як-от вимога підсистеми, traced from вимоги в специфікації системи, або процедура тестування, що verifies вимогу, яку веде інша команда.

Зв’язок є частиною цього проєкту. Він зберігає лише ідентифікатори двох елементів і зв’язок. Номер, назва, клас і статус зв’язаного елемента зчитуються з його власного проєкту щоразу, коли ви дивитеся, з вашими власними правами доступу:

  • Якщо ви можете відкрити інший проєкт, ви бачите елемент і можете перейти до нього.
  • Якщо не можете, ви бачите Елемент у проєкті, який ви не можете відкрити. Назва ніколи до вас не потрапляє — ні в застосунку, ні в експорті, ні через API, ні через інструменти ШІ.

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

Поняття

ЧастинаЗначення
ДжерелоЕлемент цього проєкту
Зв’язокЗв’язок зі схеми цього проєкту, як-от traced from, satisfies або verified by
ЦільІдентифікатор проєкту та ідентифікатор елемента в ньому

Зв’язок перевіряється щодо класу джерела. Клас цілі під час створення зв’язку не перевіряється, бо зв’язок ніколи не читає вміст іншого проєкту. Коли клас цілі не відповідає зв’язку, розділ Трасування показує ⚠ з “Цей зв’язок зазвичай не вказує на …”.

Хто що бачить

Кожна людина бачить кожен зв’язаний елемент із тією роллю, яку вона має в його проєкті:

Ваш доступ до іншого проєктуЩо ви бачите
Будь-яка роль (власник, редактор, рецензент, читач)Номер, назва, проєкт і посилання, що відкриває елемент
Немає, або проєкт більше не існуєЕлемент у проєкті, який ви не можете відкрити

Проєкт, якого не існує, і проєкт, який ви не можете відкрити, виглядають однаково, тож зв’язок ніколи не повідомляє вам, що проєкт існує.

ПоказаноЗначенняЩо робити
Номер і назваЕлемент існує, і ви можете відкрити його проєктНічого
Видалено в <project>Елемент у кошику свого проєктуПопросіть когось, хто може редагувати той проєкт, відновити його, або вилучіть зв’язок
ВидаленоЕлемент більше не існуєВилучіть зв’язок (Вилучити розірвані зв’язки)
Елемент у проєкті, який ви не можете відкритиВи не маєте доступу до проєкту, або він більше не існуєЯкщо потрібно, попросіть доступ у власника проєкту
Завантаження…Елемент зчитуєтьсяЗачекайте трохи

Назви зчитуються, коли сторінка показує зв’язок, знову — коли ви повертаєтеся на вкладку через хвилину, і кожні п’ять хвилин. Перейменований елемент показує нову назву без жодних змін у цьому проєкті.

Змінені цілі

Рядок показує Змінено, коли зв’язаний елемент редагували в його проєкті після створення зв’язку чи останнього перегляду. Наведіть вказівник, щоб побачити дату. Перевірте, що зв’язок усе ще дійсний, потім:

  • Натисніть ✓ у рядку, щоб позначити цей зв’язок перевіреним.
  • Натисніть ⋯ поруч з Інші проєкти, потім Позначити всі перевіреними (n) для всіх позначених зв’язків елемента.
  • Або відкрийте Потреби та вимоги → Зв’язки для перевірки: картка Змінено в інших проєктах перелічує всі позначені зв’язки проєкту з ✓ у кожному рядку та Позначити всі перевіреними.

Позначення перевіреним показується в історії елемента та в “Діяльності”, і одне натискання “Відмінити” повертає його назад. Рецензенти й читачі бачать позначки, але не можуть їх зняти. Зв’язки з випусками бібліотек не позначаються (випуск не змінюється).

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

Коли й навіщо

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

Усередині одного проєкту використовуйте звичайні зв’язки. Зв’язати наявний… у розділі Трасування пов’язує елементи того самого проєкту; зв’язок з іншим проєктом — для елементів, що містяться деінде.

  1. Виберіть елемент, наприклад вимогу підсистеми.
  2. В інспекторі відкрийте розділ Трасування. У розділі Інші проєкти натисніть + (Додати зв’язок з іншим проєктом…).
  3. Виберіть Зв’язок, наприклад traced from.
  4. Виберіть Проєкт. Його елементи перелічено за номерами.
  5. Для бібліотеки виберіть Версія: Поточна (робоча копія) або випуск, наприклад Release 1.1. Зв’язок із випуском показує його позначку замість поточна, а його назва не відкриває сторінку.
  6. Введіть текст у Пошук, щоб знайти елемент за номером або назвою. Виберіть Клас, щоб перелічити лише цей клас.
  7. Клацніть елемент, потім натисніть Додати зв’язок. Сповіщення показує “Зв’язок додано.”, а елемент з’являється в розділі Інші проєкти.

Одне натискання “Відмінити” вилучає зв’язок. Повторне додавання того самого зв’язку зберігає наявний.

Відкриття зв’язаного елемента

Клацніть назву зв’язаного елемента. Його проєкт відкривається на цьому елементі.

  • Натисніть × у рядку зв’язку, щоб вилучити один зв’язок.
  • Коли зв’язки вказують на видалені елементи, натисніть ⋯ поруч з Інші проєкти, потім Вилучити розірвані зв’язки (n).

Вилучення зв’язку змінює лише цей проєкт. Інший проєкт зв’язок ніколи не змінює.

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

  1. Створіть проєкт з назвою EO-1 Payload з вимогою PL.1 Detector pixel pitch shall be at most 5.5 µm.
  2. Виберіть PL.1, відкрийте Трасування → Інші проєкти → +.
  3. Виберіть traced from, проєкт CubeSat EO-1, знайдіть ground sample і клацніть 1.2 Ground Sample Distance. Натисніть Додати зв’язок.
  4. Рядок показує 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 на пошук (звузьте пошук, щоб побачити інші)

Зв’язок вказує на поточну версію іншого проєкту або на копію елемента у випуску бібліотеки (див. Бібліотеки).