Holarch

Требования

Карта программы

Просмотр того, как ваши проекты связаны друг с другом, с числом связей для каждой пары проектов, и прослеживание цепочки связей одного элемента через другие проекты.

Как использовать →

На этой странице
  1. Обзор
  2. Понятия
    1. Что показывает карта
    2. Кто что видит
    3. Цвета
  3. Как использовать
    1. Как связаны ваши проекты
    2. Начало с одного проекта
    3. Трассировка одного элемента через программу
    4. Разобранный пример: демонстрационный проект CubeSat EO-1 и проект полезной нагрузки
    5. Разобранный пример: Hybrid Car и его аккумуляторная батарея
    6. Советы и рекомендации
    7. Типичные ошибки
    8. Связь с другими функциями
  4. Страница “Карта программы”
    1. Панель
    2. Граф
    3. Таблица
    4. Инспектор
  5. API и MCP
  6. Сообщения
  7. Ограничения
  8. Связанные материалы

Обзор

Программу из нескольких проектов (системный проект, проекты подсистем, проект испытаний, библиотеки) связывают воедино связи с другими проектами. Каждая связь хранится в проекте, который её создаёт, поэтому ни один отдельный проект не показывает всю картину. Это делает Карта программы: она рисует по одному блоку на каждый проект, который вы можете открыть, и по одной стрелке на каждую пару проектов, подписанной связью и числом связей.

У страницы два вида:

  • Проекты: все проекты, которые вы можете открыть, и связи между ними, в виде графа или таблицы.
  • Трассировка элемента: один элемент в центре и связанные с ним элементы в других проектах, кольцо за кольцом, до шести шагов наружу.

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

Понятия

Что показывает карта

ЭлементЗначение
БлокПроект, который вы можете открыть: его имя, тип проекта и число элементов; его доступное имя добавляет связи, которые он хранит и получает
СтрелкаСвязи, хранящиеся в проекте у начала стрелки и указывающие на элементы проекта у её острия
Подпись стрелкисвязь · связей · удалено, например traced from · 12 · 1 deleted
Проекты, которые вы не можете открыть (N связей)Один пунктирный блок, который считает все связи в проекты, которые вы не можете открыть
Блок выпуска библиотекиВыпуск библиотеки, который вы можете прочитать и на который ссылаются ваши проекты

Стрелки обычно направлены вверх: проекты подсистем хранят связи traced from и satisfies с системным проектом, а проекты испытаний — связи verifies. Карта размещает проекты, хранящие связи, ниже проектов, на которые они указывают.

Кто что видит

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

  • Связь с проектом, который вы не можете открыть, учитывается в Проекты, которые вы не можете открыть (N связей). Этот блок никогда не называет проект или элемент и выглядит одинаково, существует ли проект, находится ли он в корзине или не существовал никогда.
  • Связи, хранящиеся в проекте, который вы не можете открыть, нигде не учитываются, даже если они указывают на ваши проекты.
  • Роль администратора организации ничего не добавляет: карта использует участие в проектах.
  • Экспорт (CSV, SVG, PNG) содержит ровно то, что показывает страница.

Цвета

ЦветЗначение
Синяя стрелкаСвязи между проектами, которые вы можете открыть
Жёлтая стрелкаЧасть целей удалена (в корзине или исчезла)
Серая стрелкаСвязи с проектами, которые вы не можете открыть, с выпуском библиотеки или хранящиеся в проекте, тариф владельца которого не включает связи с другими проектами

Как использовать

  1. Нажмите Управление проектами, затем Карта программы. Открывается вид Проекты со всеми проектами, которые хранят или получают связи.
  2. Прочитайте стрелки. Наведите указатель на блок, чтобы затемнить всё, что с ним не связано.
  3. Щёлкните стрелку. Инспектор перечисляет её связи по 100 за раз: элемент, хранящий каждую связь, связь и целевой элемент. Щёлкните любой из элементов, чтобы открыть его в его проекте, или Показать больше для следующих 100.
  4. Нажмите Экспорт CSV в инспекторе, чтобы сохранить связи этой стрелки, или Экспорт ▾ на панели, чтобы сохранить всю карту как CSV, SVG или PNG.

Начало с одного проекта

  1. Откройте проект, затем Верификация → Покрытие программы и нажмите Открыть карту программы.
  2. Карта показывает только этот проект и связанные с ним проекты, напрямую или через другие.
  3. Нажмите Показать все проекты, чтобы увидеть всё, что вы можете открыть.

Можно также щёлкнуть блок и выбрать Показать только связанные проекты.

Трассировка одного элемента через программу

  1. Выберите элемент. В разделе Трассировка инспектора откройте Другие проекты ⋯ и выберите Показать на карте программы. Из списка связей стрелки вместо этого нажмите Трассировать этот элемент.
  2. Вид Трассировка элемента показывает элемент в центре и связанные с ним элементы кольцами: первое кольцо — на один шаг, второе — на два шага. Связи прослеживаются в обоих направлениях.
  3. Выберите Шаги (от 1 до 6, по умолчанию 3), чтобы уйти дальше или остаться ближе.
  4. Элементы окрашены по проектам, вокруг элементов каждого проекта — пунктирная рамка. Снимите флажок Группировать по проектам, чтобы убрать рамки.
  5. Щёлкните элемент, чтобы получить Открыть элемент и Трассировать отсюда, что помещает его в центр.

Разобранный пример: демонстрационный проект CubeSat EO-1 и проект полезной нагрузки

  1. Создайте демонстрационный проект CubeSat EO-1, затем второй проект EO-1 Payload с требованием PL.1 Imager resolution.
  2. В EO-1 Payload выберите PL.1. В Трассировка → Другие проекты нажмите +, выберите traced from, проект CubeSat и его требование к съёмке и нажмите Добавить связь.
  3. Создайте третий проект EO-1 Test Campaign с тестовым случаем TC.4 Resolution test и свяжите его через verifies с PL.1 в EO-1 Payload.
  4. Откройте Управление проектами → Карта программы. Карта показывает EO-1 Test Campaign внизу, EO-1 Payload над ним и проект CubeSat наверху со стрелками verifies · 1 и traced from · 1.
  5. Щёлкните PL.1 → Трассировка ⋯ → Показать на карте программы: тестовый случай и требование CubeSat находятся на расстоянии одного шага, по обе стороны.

Разобранный пример: Hybrid Car и его аккумуляторная батарея

  1. На странице Управление проектами нажмите Файлы проектов ▾ → Новый демо-проект → Hybrid Car (SysML v2).
  2. Затем создайте Файлы проектов ▾ → Новый демо-проект → Hybrid Car Battery Pack (SysML v2). Требования поставщика батареи к блоку PackCapacity, PackMass и ChargeAcceptance связаны через traced from с требованиями автомобиля VR-3, VR-6 и VR-5 в вашем самом новом демо-проекте Hybrid Car, какой бы из двух вы ни создали первым; повторное создание демо-проекта Hybrid Car переносит связи в новый. Эти демонстрационные связи работают на любом тарифе. Без проекта Hybrid Car у демо-проекта батареи нет связей.
  3. Откройте Управление проектами → Карта программы. Карта показывает два проекта 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 (см. Связи с другими проектами)