Требования
Карта программы
Просмотр того, как ваши проекты связаны друг с другом, с числом связей для каждой пары проектов, и прослеживание цепочки связей одного элемента через другие проекты.
На этой странице
Обзор
Программу из нескольких проектов (системный проект, проекты подсистем, проект испытаний, библиотеки) связывают воедино связи с другими проектами. Каждая связь хранится в проекте, который её создаёт, поэтому ни один отдельный проект не показывает всю картину. Это делает Карта программы: она рисует по одному блоку на каждый проект, который вы можете открыть, и по одной стрелке на каждую пару проектов, подписанной связью и числом связей.
У страницы два вида:
- Проекты: все проекты, которые вы можете открыть, и связи между ними, в виде графа или таблицы.
- Трассировка элемента: один элемент в центре и связанные с ним элементы в других проектах, кольцо за кольцом, до шести шагов наружу.
Карта программы открыта для всех, кто вошёл в систему. Сами связи создаются на тарифе Team; связи, хранящиеся в проекте, тариф владельца которого их не включает, рисуются серым. Связи между демонстрационными проектами Hybrid Car и Hybrid Car Battery Pack работают на любом тарифе.
Понятия
Что показывает карта
| Элемент | Значение |
|---|---|
| Блок | Проект, который вы можете открыть: его имя, тип проекта и число элементов; его доступное имя добавляет связи, которые он хранит и получает |
| Стрелка | Связи, хранящиеся в проекте у начала стрелки и указывающие на элементы проекта у её острия |
| Подпись стрелки | связь · связей · удалено, например traced from · 12 · 1 deleted |
| Проекты, которые вы не можете открыть (N связей) | Один пунктирный блок, который считает все связи в проекты, которые вы не можете открыть |
| Блок выпуска библиотеки | Выпуск библиотеки, который вы можете прочитать и на который ссылаются ваши проекты |
Стрелки обычно направлены вверх: проекты подсистем хранят связи traced from и satisfies с системным проектом, а проекты испытаний — связи verifies. Карта размещает проекты, хранящие связи, ниже проектов, на которые они указывают.
Кто что видит
Карта строится только из проектов, которые вы можете открыть: проектов, в которых вы участник с любой ролью, которые не находятся в корзине и правило двухэтапного входа организации которых вы выполняете.
- Связь с проектом, который вы не можете открыть, учитывается в Проекты, которые вы не можете открыть (N связей). Этот блок никогда не называет проект или элемент и выглядит одинаково, существует ли проект, находится ли он в корзине или не существовал никогда.
- Связи, хранящиеся в проекте, который вы не можете открыть, нигде не учитываются, даже если они указывают на ваши проекты.
- Роль администратора организации ничего не добавляет: карта использует участие в проектах.
- Экспорт (CSV, SVG, PNG) содержит ровно то, что показывает страница.
Цвета
| Цвет | Значение |
|---|---|
| Синяя стрелка | Связи между проектами, которые вы можете открыть |
| Жёлтая стрелка | Часть целей удалена (в корзине или исчезла) |
| Серая стрелка | Связи с проектами, которые вы не можете открыть, с выпуском библиотеки или хранящиеся в проекте, тариф владельца которого не включает связи с другими проектами |
Как использовать
Как связаны ваши проекты
- Нажмите Управление проектами, затем Карта программы. Открывается вид Проекты со всеми проектами, которые хранят или получают связи.
- Прочитайте стрелки. Наведите указатель на блок, чтобы затемнить всё, что с ним не связано.
- Щёлкните стрелку. Инспектор перечисляет её связи по 100 за раз: элемент, хранящий каждую связь, связь и целевой элемент. Щёлкните любой из элементов, чтобы открыть его в его проекте, или Показать больше для следующих 100.
- Нажмите Экспорт CSV в инспекторе, чтобы сохранить связи этой стрелки, или Экспорт ▾ на панели, чтобы сохранить всю карту как CSV, SVG или PNG.
Начало с одного проекта
- Откройте проект, затем Верификация → Покрытие программы и нажмите Открыть карту программы.
- Карта показывает только этот проект и связанные с ним проекты, напрямую или через другие.
- Нажмите Показать все проекты, чтобы увидеть всё, что вы можете открыть.
Можно также щёлкнуть блок и выбрать Показать только связанные проекты.
Трассировка одного элемента через программу
- Выберите элемент. В разделе Трассировка инспектора откройте Другие проекты ⋯ и выберите Показать на карте программы. Из списка связей стрелки вместо этого нажмите Трассировать этот элемент.
- Вид Трассировка элемента показывает элемент в центре и связанные с ним элементы кольцами: первое кольцо — на один шаг, второе — на два шага. Связи прослеживаются в обоих направлениях.
- Выберите Шаги (от 1 до 6, по умолчанию 3), чтобы уйти дальше или остаться ближе.
- Элементы окрашены по проектам, вокруг элементов каждого проекта — пунктирная рамка. Снимите флажок Группировать по проектам, чтобы убрать рамки.
- Щёлкните элемент, чтобы получить Открыть элемент и Трассировать отсюда, что помещает его в центр.
Разобранный пример: демонстрационный проект CubeSat EO-1 и проект полезной нагрузки
- Создайте демонстрационный проект CubeSat EO-1, затем второй проект EO-1 Payload с требованием PL.1 Imager resolution.
- В EO-1 Payload выберите PL.1. В Трассировка → Другие проекты нажмите +, выберите traced from, проект CubeSat и его требование к съёмке и нажмите Добавить связь.
- Создайте третий проект EO-1 Test Campaign с тестовым случаем TC.4 Resolution test и свяжите его через verifies с PL.1 в EO-1 Payload.
- Откройте Управление проектами → Карта программы. Карта показывает EO-1 Test Campaign внизу, EO-1 Payload над ним и проект CubeSat наверху со стрелками verifies · 1 и traced from · 1.
- Щёлкните PL.1 → Трассировка ⋯ → Показать на карте программы: тестовый случай и требование CubeSat находятся на расстоянии одного шага, по обе стороны.
Разобранный пример: Hybrid Car и его аккумуляторная батарея
- На странице Управление проектами нажмите Файлы проектов ▾ → Новый демо-проект → Hybrid Car (SysML v2).
- Затем создайте Файлы проектов ▾ → Новый демо-проект → Hybrid Car Battery Pack (SysML v2). Требования поставщика батареи к блоку PackCapacity, PackMass и ChargeAcceptance связаны через traced from с требованиями автомобиля VR-3, VR-6 и VR-5 в вашем самом новом демо-проекте Hybrid Car, какой бы из двух вы ни создали первым; повторное создание демо-проекта Hybrid Car переносит связи в новый. Эти демонстрационные связи работают на любом тарифе. Без проекта Hybrid Car у демо-проекта батареи нет связей.
- Откройте Управление проектами → Карта программы. Карта показывает два проекта 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 входящая”.
Таблица
| Представление | Столбцы |
|---|---|
| Проекты | Исходный проект, Связь, Целевой проект, Связи, Удалено |
| Трассировка элемента | Проект, Номер, Имя, Класс, Шагов от элемента, Состояние |
Щёлкните заголовок столбца, чтобы отсортировать.
Инспектор
| Выбор | Содержание |
|---|---|
| Блок проекта | Имя, тип, число элементов, исходящие и входящие связи; Открыть проект, Показать только связанные проекты |
| Стрелка | Исходный и целевой проект, связи по каждой связи, список связей (по 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 | То же, что вызов трассировки; для элементов в проектах с грифами регулируемых данных возвращается withheld |
См. API и MCP.
Сообщения
| Сообщение | Значение |
|---|---|
| Между вашими проектами нет связей. Добавьте связь в разделе “Трассировка” элемента. | Ни один из ваших проектов не хранит и не получает видимых вам связей |
| У этого проекта нет связей с другими проектами. Добавьте связь в разделе “Трассировка” элемента. | Карта открыта из проекта без связей |
| У этого элемента нет связей с другими проектами. Добавьте связь в его разделе “Трассировка”. | У трассируемого элемента нет связей |
| Некоторые проекты ещё считываются. Обновите через минуту. | Недавние изменения в больших проектах ещё считываются; карта показывает то, что готово |
| Показаны первые 500 элементов. Уменьшите число шагов. | Трассировка элемента достигла своего предела |
| N связей из проектов, тариф владельца которых не включает связи с другими проектами, не прослеживаются. | Трассировка элемента пропустила связи, хранящиеся на тарифе без них |
| Не удалось прочитать карту программы. Перезагрузите страницу. | Запрос не выполнен |
Ограничения
| Ограничение | Значение |
|---|---|
| Шаги трассировки элемента | С 1 по 6 |
| Элементов в трассировке элемента | 500 |
| Связей на странице в списке стрелки | 100 |
| Связей на проект | 20 000 (см. Связи с другими проектами) |