Требования
Связи с другими проектами
Прослеживание элемента к требованию, функции или тесту в другом проекте; каждый человек видит связанный элемент, только если может открыть его проект.
На этой странице
Обзор
Связь с другим проектом — это связь трассировки от элемента этого проекта к элементу другого проекта, например требование подсистемы traced from требование системной спецификации или процедура испытаний, которая verifies требование, ведущееся другой командой.
Связь — часть этого проекта. Она хранит только id двух элементов и связь. Номер, имя, класс и статус связанного элемента читаются из его собственного проекта при каждом просмотре, с вашими собственными правами доступа:
- Если вы можете открыть другой проект, вы видите элемент и можете перейти к нему.
- Если не можете, вы видите Элемент в проекте, который вы не можете открыть. Имя до вас не доходит — ни в приложении, ни в экспорте, ни через API, ни через инструменты ИИ.
Связи с другими проектами входят в тариф Team. Решает тариф владельца проекта. На других тарифах существующие связи остаются видимыми и их можно удалить, но новые добавить нельзя. Связи между демонстрационными проектами Hybrid Car и Hybrid Car Battery Pack работают на любом тарифе.
Понятия
Что хранит связь
| Часть | Значение |
|---|---|
| Источник | Элемент этого проекта |
| Связь | Связь схемы этого проекта, например traced from, satisfies или verified by |
| Целевой показатель | Id проекта и id элемента в нём |
Связь проверяется по классу источника. Класс цели при создании связи не проверяется, потому что связь никогда не читает содержимое другого проекта. Если класс цели не подходит к связи, раздел Трассировка показывает ⚠ с текстом “Эта связь обычно не указывает на …”.
Кто что видит
Каждый видит каждый связанный элемент с той ролью, которая у него есть в проекте этого элемента:
| Ваш доступ к другому проекту | Что вы видите |
|---|---|
| Любая роль (Владелец, Редактор, Рецензент, Читатель) | Номер, имя, проект и ссылка, открывающая элемент |
| Нет доступа, или проект больше не существует | Элемент в проекте, который вы не можете открыть |
Несуществующий проект и проект, который вы не можете открыть, выглядят одинаково, поэтому связь никогда не сообщает, что проект существует.
Состояния связей
| Показано | Значение | Что делать |
|---|---|---|
| Номер и имя | Элемент существует, и вы можете открыть его проект | Ничего |
| Удалено в <проект> | Элемент находится в корзине своего проекта | Попросите кого-то, кто может редактировать этот проект, восстановить его, или удалите связь |
| Удалено | Элемент больше не существует | Удалите связь (Удалить нарушенные связи) |
| Элемент в проекте, который вы не можете открыть | У вас нет доступа к проекту, или он больше не существует | При необходимости попросите доступ у владельца проекта |
| Загрузка… | Элемент считывается | Подождите немного |
Имена читаются, когда страница показывает связь, снова — когда вы возвращаетесь на вкладку через минуту, и каждые пять минут. Переименованный элемент показывает новое имя без каких-либо изменений в этом проекте.
Изменённые цели
Строка показывает Изменено, если связанный элемент был изменён в своём проекте после создания связи или её последней проверки. Наведите указатель, чтобы увидеть дату. Убедитесь, что связь по-прежнему верна, затем:
- Нажмите ✓ в строке, чтобы отметить эту связь как проверенную.
- Нажмите ⋯ рядом с Другие проекты, затем Отметить все как проверенные (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 · current. Коллега, который может открыть только EO-1 Payload, видит в той же строке Элемент в проекте, который вы не можете открыть.
Советы и рекомендации
- Создавайте связи от нижнего уровня к верхнему, чтобы системному проекту не приходилось меняться при добавлении подсистемы.
- Предоставьте проект верхнего уровня с ролью “Читатель” тем, кто работает над проектом нижнего уровня, чтобы они видели имена.
- Запускайте Удалить нарушенные связи после реорганизации проекта верхнего уровня.
Типичные ошибки
| Проблема | Причина | Исправление |
|---|---|---|
| “Этот элемент находится в этом проекте. Используйте “Связать существующий…”.” | Цель находится в том же проекте | Используйте Связать существующий… в группе связи |
| Нет + в разделе Другие проекты | Вы можете только просматривать проект, или элемент заблокирован | Попросите роль “Редактор” или разблокируйте элемент |
| “Связи с элементами других проектов входят в тариф Team.” | Владелец проекта не на тарифе Team | Перейдите на другой тариф в Настройки учётной записи → Тариф и оплата |
| Средство выбора сообщает “Этот проект невозможно прочитать. Выберите другой проект.” | Вы потеряли доступ к этому проекту | Попросите доступ у его владельца |
Связь с другими функциями
- Матрица прослеживаемости: связи от строк по выбранным связям перечислены под сеткой в разделе Другие проекты; Экспорт… добавляет их (см. Прослеживаемость).
- Диаграмма Spider: связанные элементы появляются в виде пунктирных рамок вокруг своего элемента; отключите их через Параметры → Другие проекты.
- Карта программы: Управление проектами → Карта программы показывает, как связаны все ваши проекты, а Другие проекты ⋯ → Показать на карте программы трассирует этот элемент через другие проекты (см. Карта программы).
- Покрытие программы: проект, на который указывают связи, перечисляет их на странице Верификация → Покрытие программы по элементам и проектам (см. Покрытие программы).
- История и активность: добавление и удаление связи записывается в элементе.
- Корзина: при удалении элемента его связи перемещаются в корзину вместе с ним; восстановление элемента восстанавливает их.
- Запросы на изменение: Добавить изменение ▾ → Добавить связь с другим проектом… и Убрать ссылку на другой проект… подготавливают связи; они добавляются или удаляются при применении запроса.
- Библиотеки: создавайте связь с элементом выпуска библиотеки через выбор Версия (см. Библиотеки).
Экспорт и отчёты
Экспорт называет связанные элементы с правами доступа того, кто экспортирует. Всё, что этот человек не может прочитать, записывается как “Элемент в другом проекте”.
| Экспорт | Что происходит со связями с другими проектами |
|---|---|
| JSON проекта (экспорт базы данных) | Сохраняются как есть: только id. При импорте файла они сохраняются |
| ReqIF (база данных и документы) | Атрибут External links у каждого связанного элемента: связь, id проекта и id элемента, а также номер и имя, если вы можете их прочитать |
| XMI | Не включаются; отчёт об экспорте считает их как “Связь с другим проектом” |
| Матрица прослеживаемости (Excel) | Отдельный лист Other projects |
| Матрица прослеживаемости (CSV) | Столбец Other projects |
| Отчёт RTM (матрица прослеживаемости требований) | Столбец Other Projects |
API и MCP
API и MCP возвращают связи в виде id. Чтобы прочитать имена, вызовите операцию resolve; она использует собственные права доступа и список проектов токена. Карта программы и трассировка элемента доступны как GET /api/v1/program-map, GET /api/v1/projects/<project>/items/<item>/trace и инструменты MCP program_map и trace_chain. См. API и MCP.
Функции ИИ в приложении получают связи только в виде id.
Сообщения
| Сообщение | Значение |
|---|---|
| Связь добавлена. | Связь сохранена |
| Этот элемент находится в этом проекте. Используйте “Связать существующий…”. | Выбранный элемент находится в том же проекте |
| Выберите элемент, затем добавьте связь. | Добавить связь нажата без выбора элемента |
| Нет других проектов для связи. Сначала создайте или откройте другой проект. | У вас есть только этот проект |
| Связи с элементами других проектов входят в тариф Team. | Владелец проекта не на тарифе Team |
| Проект содержит не более 20 000 связей с другими проектами. Сначала удалите часть из них. | Проект достиг предела |
Ограничения
| Ограничение | Значение |
|---|---|
| Связей на проект | 20,000 |
| Элементов, читаемых за запрос | 500 |
| Элементов в списке средства выбора | 100 на поиск (сузьте поиск, чтобы увидеть остальные) |
Связь указывает на текущую версию другого проекта или на копию элемента в выпуске библиотеки (см. Библиотеки).