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 требование, ведущееся другой командой.

Связь — часть этого проекта. Она хранит только id двух элементов и связь. Номер, имя, класс и статус связанного элемента читаются из его собственного проекта при каждом просмотре, с вашими собственными правами доступа:

  • Если вы можете открыть другой проект, вы видите элемент и можете перейти к нему.
  • Если не можете, вы видите Элемент в проекте, который вы не можете открыть. Имя до вас не доходит — ни в приложении, ни в экспорте, ни через API, ни через инструменты ИИ.

Связи с другими проектами входят в тариф Team. Решает тариф владельца проекта. На других тарифах существующие связи остаются видимыми и их можно удалить, но новые добавить нельзя. Связи между демонстрационными проектами Hybrid Car и Hybrid Car Battery Pack работают на любом тарифе.

Понятия

ЧастьЗначение
ИсточникЭлемент этого проекта
СвязьСвязь схемы этого проекта, например traced from, satisfies или verified by
Целевой показательId проекта и id элемента в нём

Связь проверяется по классу источника. Класс цели при создании связи не проверяется, потому что связь никогда не читает содержимое другого проекта. Если класс цели не подходит к связи, раздел Трассировка показывает ⚠ с текстом “Эта связь обычно не указывает на …”.

Кто что видит

Каждый видит каждый связанный элемент с той ролью, которая у него есть в проекте этого элемента:

Ваш доступ к другому проектуЧто вы видите
Любая роль (Владелец, Редактор, Рецензент, Читатель)Номер, имя, проект и ссылка, открывающая элемент
Нет доступа, или проект больше не существуетЭлемент в проекте, который вы не можете открыть

Несуществующий проект и проект, который вы не можете открыть, выглядят одинаково, поэтому связь никогда не сообщает, что проект существует.

ПоказаноЗначениеЧто делать
Номер и имяЭлемент существует, и вы можете открыть его проектНичего
Удалено в <проект>Элемент находится в корзине своего проектаПопросите кого-то, кто может редактировать этот проект, восстановить его, или удалите связь
УдаленоЭлемент больше не существуетУдалите связь (Удалить нарушенные связи)
Элемент в проекте, который вы не можете открытьУ вас нет доступа к проекту, или он больше не существуетПри необходимости попросите доступ у владельца проекта
Загрузка…Элемент считываетсяПодождите немного

Имена читаются, когда страница показывает связь, снова — когда вы возвращаетесь на вкладку через минуту, и каждые пять минут. Переименованный элемент показывает новое имя без каких-либо изменений в этом проекте.

Изменённые цели

Строка показывает Изменено, если связанный элемент был изменён в своём проекте после создания связи или её последней проверки. Наведите указатель, чтобы увидеть дату. Убедитесь, что связь по-прежнему верна, затем:

  • Нажмите ✓ в строке, чтобы отметить эту связь как проверенную.
  • Нажмите ⋯ рядом с Другие проекты, затем Отметить все как проверенные (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 · 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 на поиск (сузьте поиск, чтобы увидеть остальные)

Связь указывает на текущую версию другого проекта или на копию элемента в выпуске библиотеки (см. Библиотеки).